SYNOPSIS

ElementTree addLabelledInput( ElementTree parent, String labeltext, TextInputType itype, String iname, String ivalue=createString(0), Int isize=0 )

ARGUMENTS

parent The parent element

labeltext The text of the label

itype The type of text input to add

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.

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.

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.

DESCRIPTION

Adds a labelled text input to a form. Since the labelled input is enclosed within a division, the parent element may be the form itself. The parameters for this function are identical in use to the parameters of HTMLDocument.addTextInput (3kaya) with the same name.

AUTHORS

Kaya standard library by Edwin Brady, Chris Morris and others ([email protected]). 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.TextInputType (3kaya)

HTMLDocument.addFieldset (3kaya)

HTMLDocument.addLabelledSelect (3kaya)

HTMLDocument.addLabelledTextarea (3kaya)

HTMLDocument.addOption (3kaya)

HTMLDocument.addTextInput (3kaya)