.\" 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.addTextarea" "3kaya" "August 2014" "Kaya" "Kaya module reference"
.SH "NAME"
HTMLDocument::addTextarea \- Adds a textarea
.SH "SYNOPSIS"
.B ElementTree addTextarea(
\fIElementTree parent, String name, String initialtext=createString(0), Int rows=5, Int cols=40\fP
.B ")"
.SH "ARGUMENTS"
.PP
.B "parent"
The parent element
.PP
.B "name"
The name of the textarea. Remember that names starting with "kaya_" may be used by the Kaya standard library and should not be used directly by applications.
.PP
.B "initialtext"
The initial contents of the textarea, if any. Thisparameter is optional, with the empty string as a default.
.PP
.B "rows"
The number of rows the fieldset has. This parameter may be omitted for a default of 5.
.PP
.B "cols"
The number of columns the fieldset has. This parameter may be omitted for a default of 40. Note that there is no browser-independent relationship between the number of columns in a text area, and the size of a normal text input, so getting them to be consistently the same width is not possible.
.SH "DESCRIPTION"
.PP
Adds a textarea to a form. Remember that textareas may not be added directly to the form - you need to add a block-level element such as
\fBfieldset \fP
to the form, and then add the textareas to that. Text areas are useful for entering large amounts of user input, or where the user input needs to contain new lines.
.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.addFieldset"(3kaya)
.PP
.B "HTMLDocument.addLabelledTextarea"(3kaya)
.PP
.B "HTMLDocument.addSelectElement"(3kaya)
.PP
.B "HTMLDocument.addTextInput"(3kaya)
.PD 0.4v