Help Center

Local Navigation

Object: HTMLTextAreaElement

Availability

BlackBerry® Device Software version 4.6 or later

Extends

HTMLElement

The HTMLTextAreaElement object provides access to <textarea> elements within an HTML document.

The <textarea> element specifies a multiline text entry field in a form. It can optionally contain plain text, which is displayed to the user in the text area.

HTMLTextAreaElement properties

Property name

Type

Description

Status

Support level

Availability

accessKey

DOMString

Specifies the keypad key that gives access to the form control.

writable

DOM 2 HTML

4.6 or later

cols

int

Specifies the width of the text area control, in characters.

writable

DOM 2 HTML

4.6 or later

defaultValue

DOMString

Specifies the initial contents of the text area. The value of this property does not change if the contents of the text area control within the form changes.

writable

DOM 2 HTML

4.6 or later

disabled

boolean

When true, indicates that the text area control is not available.

writable

DOM 2 HTML

4.6 or later

form

HTMLFormElement

Returns the parent <form> element for the form control.

Specifies the amount of white space, in pixels, to add between cell content and its borders.

read only

DOM 2 HTML

4.6 or later

name

DOMString

Specifies the name of the form control. This is the name portion of the name-value pair that is submitted with the form.

writable

DOM 2 HTML

4.6 or later

readonly

boolean

When true, indicates that the form control cannot be modified by a user.

writable

DOM 2 HTML

4.6 or later

rows

int

Specifies the height of the form control, in text rows.

writable

DOM 2 HTML

4.6 or later

tabIndex

int

Specifies the tabbing order of the form control.

writable

DOM 2 HTML

4.6 or later

type

DOMString

Returns the type of form control. The value for this property is "textarea".

read only

DOM 2 HTML

4.6 or later

value

DOMString

Specifies the current contents of the form control. This is the value portion of the name-value pair that is submitted with the form.

writable

DOM 2 HTML

4.6 or later

HTMLTextAreaElement methods

Method name

Description

Support level

Availability

blur()

Removes keypad focus from the element.

DOM 2 HTML

4.6 or later

focus()

Gives keypad focus to the element.

DOM 2 HTML

4.6 or later

select()

Selects the entire contents of the element.

DOM 2 HTML

4.6 or later


Was this information helpful? Send us your comments.