<TEXTAREA...>
ACCESSKEY
="Shortcut Key"
ALIGN
="left|right|top|texttop|middle|absmiddle|baseline|bottom|absbottom"
CLASS
="Style Sheet Class"
COLS
="Number of columns"
DATAFLD
="Data Source Column Name"
DATASRC
="Data Source Identifier"
DISABLED
="Flag"
ID
="Unique Identifier"
LANG
="Language descriptor"
LANGUAGE
="Scripting Language descriptor"
NAME
="Element Identifier"
READONLY
="Flag"
ROWS
="Number of rows"
STYLE
="Style Sheet Setting"
TABINDEX
="Tab-order Index"
TITLE
="Title of element"
WRAP
="off|virtual|physical||off|soft|hard"
onClick
="Script Function"
onDblClick
="Script Function"
onDragStart
="Script Function"
onFilterChange
="Script Function"
onHelp
="Script Function"
onKeyDown
="Script Function"
onKeyPress
="Script Function"
onKeyUp
="Script Function"
onMouseDown
="Script Function"
onMouseMove
="Script Function"
onMouseOut
="Script Function"
onMouseOver
="Script Function"
onMouseUp
="Script Function"
onSelectStart
="Script Function"
onAfterUpdate
="Script Function"
onBeforeUpdate
="Script Function"
onBlur
="Script Function"
onChange
="Script Function"
onErrorUpdate
="Script Function"
onFocus
="Script Function"
onRowEnter
="Script Function"
onRowExit
="Script Function"
>
...
</TEXTAREA>
Renders a multi-line text box, allowing input of more than a single line of text.
Attribute | Description |
ACCESSKEY |
Specifies a key that can be used as a shortcut to access the element. Pressing 'Alt' and the key specified in the ACCESSKEY attribute is the same as clicking on the element. |
ALIGN |
Specifies the alignment of the <TEXTAREA> box, relative to the rest of the document. |
CLASS |
Sets the style sheet class (specified in an in-line, linked or imported style sheet) to be applied to the element. |
COLS |
Sets the number of character columns (I.e. 1 column=the width of 1 character) available in the text box presented in the document. |
DATAFLD |
Specifies the column name of the data (from the data source specified in the DATASRC attribute) to be used for populating the element. |
DATASRC |
Specifies the ID attribute of an embedded data-source object (using the <OBJECT> element) that will be used as the data source for the elements data. |
DISABLED |
Sets whether the element is disabled or not. Disabled elements can be enabled through scripting after the document has been loaded, or depending on user interaction. It prevents the <TEXTAREA> from receiving the users focus, or responding to any interaction, but can still display text. |
ID |
Sets a unique identifier for the element, allowing it to be referenced within scripting functions, or to specify a style sheet setting, set using a #<style_class> class selector. |
LANG |
Specifies the language (using an ISO country code derived classifier) that the element is using, for browsers that support document localisation. |
LANGUAGE |
Sets the scripting language that any in-line scripting events are written in. |
NAME |
Sets the name of the name/value pair for the text area, sent with the form data for processing. |
READONLY |
Causes the contents of the <TEXTAREA> element to be read-only. The element can still receive and react to the users focus, but the contents can not be edited. |
ROWS |
Sets the number of rows (I.e. lines of text) available in the text box presented in the document. |
STYLE |
Sets in-line style sheet settings for the element, which will over-ride any set in a <STYLE> block, or externally linked to the document. |
TABINDEX |
Specifies the tab index order of the embedded object within the document. I.e. an element with a TABINDEX="2" setting would receive the focus after an element with a TABINDEX="1" when the Tab key is pressed. |
TITLE |
Specifies an informational title for the element. The contents of the TITLE attribute may be presented as a Tool-Tip by some browsers. |
WRAP |
Specifies how word-wrapping is handled in the form processing. WRAP="off" causes no wrapping as the data is sent as entered, WRAP="virtual" causes word-wrapping in the text box, but the text is sent with no line-breaks and WRAP="physical" causes word-wrapping and the text is sent with line-breaks included. Version 4.0 browsers support WRAP="off|soft|hard" respoectively for these settings. |
Event | Description |
onClick |
Fired whenever the user clicks the element (or its contents) with the mouse |
onDblClick |
Fired whenever the user double-clicks the element (or its contents) with the mouse (the double-click speed is dependant on the users system settings). |
onDragStart |
Fired when the users initiaties dragging of the element (or it's contents) |
onFilterChange |
Fired whenever a filter is applied to an element, or whenever the properties of an applied filter are changed. |
onHelp |
Fired whenever the user presses 'F1' (for help) and the element has the users current focus. |
onKeyDown |
Fired when the user presses a key (only when the key is actually pressed) when the element has the focus. |
onKeyPress |
The onkeypress event is similar to the onkeydown event, except that it returns the UNICODE value of the key or keys being pressed when the event occurs. |
onKeyUp |
The onkeyup event is fired when a previously pressed key is released while the referenced element has the focus. |
onMouseDown |
The onmousedown event fires whenever the user presses a button on the mouse, with the event being initially fired for the element that has the focus when the mouse button is clicked, and bubbling up through the element objects until an onmousedown event handler is found. |
onMouseMove |
The onmousemove event occurs whenever the users mouse moves over the element. |
onMouseOut |
The onmouseout event fires when the users mouse leaves the area defined by the referenced element. |
onMouseOver |
The onmouseover event fires when the users mouse enters the area defined by the referenced element. |
onMouseUp |
The onmouseup event fires after a users mouse button has been pressed and released. |
onSelectStart |
The onselectstart event is fired whenever the users starts to select some text that is the contents of the referenced element. |
onAfterUpdate |
The onafterupdate event is fired after data is transferred from the element to the data provider and will only fire after the onbeforeupdate event has fired and was successful. |
onBeforeUpdate |
onbeforeupdate fires when a data bound element loses the focus, or the current document is unloaded and will only fire if the value of the element is different to the original value that was present when the element received the users focus. |
onBlur |
Fires when the element loses the users focus (i.e. the user clicks on a different element within the document). |
onChange |
Fires when the user commits a change to the element. For the <TEXTAREA> element, this is when either the form is submitted, or the user passes focus to another element in the document. |
onErrorUpdate |
The onerrorupdate event fires when a data transfer error occurs, through some action by the user. |
onFocus |
Fires whenever the element receives the focus, either by the user directly clicking on, or 'tab'bing to the element, or when the focus is applied through scripting. |
onRowEnter |
Fires on the data source control when the current record has been changed, so new data is available to populate the HTML display elements that are bound to the data source. |
onRowExit |
Fires immediately before the data source changes the current record. |
See 'HTML Reference|Forms|<TEXTAREA>' for more information.