---
name: "HTMLDocument.addLocalForm"
section: "3kaya"
platform: "linux"
package: "kaya"
version: "0.4.4-6.2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/HTMLDocument.addLocalForm"
---

# HTMLDocument.addLocalForm(3kaya)

Add a form for the current application

## 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)**