.\" This man page is automatically generated using
.\" kayadoc2man from the Kaya development tools and the -xmldocs compile 
.\" option. Editing it directly is not encouraged.
.\" It is under the same license as the source .k file that it was
.\" generated from.
.TH "HTMLDocument.addTextInput" "3kaya" "August 2014" "Kaya" "Kaya module reference"
.SH "NAME"
HTMLDocument::addTextInput \- Adds a text input
.SH "SYNOPSIS"
.B ElementTree addTextInput(
\fIElementTree parent, TextInputType itype, String iname, String ivalue=createString(0), Int isize=0\fP
.B ")"
.SH "ARGUMENTS"
.PP
.B "parent"
The parent element
.PP
.B "itype"
The type of text input to add
.PP
.B "iname"
The name of the input. Remember that names starting with "kaya_" may be used by the Kaya standard library and should not be used directly by applications.
.PP
.B "ivalue"
The initial value of the input. For text and password fields, this may be changed by the user in their web browser (someone attacking your application may of course change any value, regardless of the input type). This value is generally ignored by web browsers for file upload inputs. This value is optional, and defaults to the empty String.
.PP
.B "isize"
Optionally, the display size of the input element. Browser rules for determining this size vary - it is an approximate number of characters, but only approximate. Obviously browsers ignore this field for hidden fields and checkbox and radio inputs, and usually for file upload inputs too.
.SH "DESCRIPTION"
.PP
Adds a text input to a form. In HTML, controls may not be added directly to a form, so you must add them to a block-level element such as
\fBfieldset \fP
within the form.
.SH "AUTHORS"
Kaya standard library by Edwin Brady, Chris Morris and others (kaya@kayalang.org). For further information see http://kayalang.org/
.SH 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.
.SH "RELATED"
.PD 0
.PP
.B "HTMLDocument.TextInputType"(3kaya)
.PP
.B "HTMLDocument.addFieldset"(3kaya)
.PP
.B "HTMLDocument.addLabelledInput"(3kaya)
.PP
.B "HTMLDocument.addOption"(3kaya)
.PP
.B "HTMLDocument.addSelectElement"(3kaya)
.PP
.B "HTMLDocument.addTextarea"(3kaya)
.PD 0.4v