NAME

       HTMLDocument::addLocalForm - Add a form for the current application

SYNOPSIS

       ElementTree addLocalForm( ElementTree parent, Bool fileupload=false )

ARGUMENTS

       parent The parent element

       fileupload Does this particular form allow file uploads. This argument can be omitted, for
       a default of disallowing them. Note that WebCommon.allowFileUploads (3kaya) must  also  be
       called for this to be successfully enabled.

DESCRIPTION

       This  adds a form that points to the current web application to call a named function. You
       then need to use HTMLDocument.addLocalControlInput (3kaya) to choose the function to call.

       If you are using mod_rewrite in  Apache,  or  other  methods  of  rewriting  URLs  at  the
       webserver level, then you may need to call setAttribute(form,"action",rewritten) , as Kaya
       cannot know about this URL rewriting layer.

       Note that in HTML form input controls may not be placed directly inside a form - you  must
       add  block-level  elements  to  the  form and add controls to those elements. The fieldset
       element is especially suited to this and  the  HTMLDocument.addFieldset  (3kaya)  function
       handles this.

AUTHORS

       Kaya  standard  library  by  Edwin Brady, Chris Morris and others (kaya@kayalang.org). For
       further information see http://kayalang.org/

LICENSE

       The Kaya standard library is free software; you can redistribute it and/or modify it under
       the  terms  of the GNU Lesser General Public License (version 2.1 or any later version) as
       published by the Free Software Foundation.

RELATED

       HTMLDocument.addFieldset (3kaya)
       HTMLDocument.addLocalControlInput (3kaya)
       HTMLDocument.addRemoteForm (3kaya)