TEXTAREA XHTML Element
The TEXTAREA element specifies a multiline text input control. This is an inline element and requires a closing tag.
Using this Element
There are some common properties and collections that apply to all the elements of the document object model, see Common Properties for All DOM Elements in Internet Explorer Mobile.
This element can be used within a web page with attributes.
This element can be used within scripts where it will have properties, events and methods.
Attributes
| Attribute | Value | PPC | SP | Description |
|---|---|---|---|---|
| ACCESSKEY | 0...9, #, * | Yes | Yes | Gives access or focus to an active HTML element by using a keypad number.
Note For Pocket PCs, supported only for devices running Windows Mobile 2003 software or later. |
| CLASS | Yes | Yes | Associates the element with a CSS style.
Note Supported only for devices running Windows Mobile 2003 software or later. |
|
| COLS | 0...# | Yes | Yes | Specifies the number of columns for the text input control that is used to determine its width. The default value of this attribute is 20. |
| ID | Yes | Yes | Uniquely identifies the element within a document.
Note Supported only for devices running Windows Mobile 2003 software or later. |
|
| NAME | String | Yes | Yes | Specifies the text input control name that is submitted with its contents. |
| ONBLUR | Yes | Yes | Event that occurs when the text input control loses focus by the pointing device or by tabbing navigation.
Note Supported only for devices running PocketPC 2002 and Smartphone 2002 software or later. |
|
| ONCHANGE | Yes | Yes | Event that occurs when the text input control loses the input focus and its value has been modified since gaining focus.
Note Supported only for devices running PocketPC 2002 and Smartphone 2002 software or later. |
|
| ONFOCUS | Yes | Yes | Event that occurs when the text input control receives focus by a pointing device or by tabbing navigation.
Note Supported only for devices running PocketPC 2002 and Smartphone 2002 software or later. |
|
| READONLY | Yes | Yes | ||
| ROWS | 0...# | Yes | Yes | Specifies the number of rows in the text input control that is used to determine its height. The default value of this attribute is 2.
Note On Smartphone the value of ROWS is always 1, regardless of the HTML definition. |
| STYLE | Yes | Yes | Provides the definition of the CSS styles used for this element.
Note Supported only for devices running Windows Mobile 2003 software or later. |
|
| TABINDEX | Yes | Yes | Sets the order in which elements are tabbed to.
Note Supported only for devices running Windows Mobile 2003 software or later. |
Scripting Properties
| Property | Type | Access | Comments |
|---|---|---|---|
| accessKey | string | Read/Write | |
| cols | long | Read Only | |
| defaultValue | string | Read/Write | Sets or retrieves the default value (initial contents) of the textarea control. |
| disabled | boolean | Read/Write | |
| form | object | Read Only | |
| maxLength | long | Read/Write | |
| name | string | Read Only | |
| readOnly | boolean | Read/Write | |
| rows | long | Read Only | |
| size | long | Read Only | |
| type | string | Read Only | Always returns: textarea |
| value | string | Read/Write | Sets or retrieves the value of the textarea control. |
Scripting Events
| Event | Supported | Comment |
|---|---|---|
| onblur | Yes | |
| onchange | Yes | This event fires when the contents of the input type=text have changed and the user commits the change (by leaving the textarea which has focus). |
| onfocus | Yes |
Scripting Methods
| Method | Support | Comments |
|---|---|---|
| focus | Yes | Syntax:
|
| select | Yes | Syntax:
|
Requirements
Pocket PC: Windows Mobile 5.0 and later
Smartphone: Windows Mobile 5.0 and later
OS Versions: Windows CE 5.01 and later
See Also
Send Feedback on this topic to the authors