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)

Kaya                                                July 2013                   HTMLDocument.addLocalForm(3kaya)