HTML XHTML The Complete Reference
home » reference » appendix a » html element reference

<textarea> (Multiline Text Input)


This element specifies a multiline text input field contained within a form.

Standard Syntax


<textarea
accesskey="character"
class="class name"
cols="number"
dir="ltr | rtl"
disabled="disabled"
id="unique alphanumeric identifier"
lang="language code"
name="unique alphanumeric identifier"
readonly="readonly"
rows="number"
style="style information"
tabindex="number"
title="advisory text"
</textarea>

Attributes Defined by Internet Explorer


contenteditable="false | true | inherit" (5.5)
datafld="column name" (4)
datasrc="data source ID" (4)
hidefocus="true | false" (5.5)
language="javascript | jscript | vbs | vbscript" (4)
wrap="off | physical | virtual" (4)

Attributes Defined by Netscape 4


wrap="hard | off | soft"

Standard Event Attributes


onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup, onselect

Events Defined by Internet Explorer


onactivate, onafterupdate, onbeforeactivate, onbeforecopy, onbeforecut, onbeforedeactivate, onbeforeeditfocus, onbeforepaste, oncontextmenu, oncontrolselect, oncopy, oncut, ondeactivate, ondrag, ondragend, ondragenter, ondragleave, ondragover, ondragstart, ondrop, onerrorupdate, onfilterchange, onfocus, onfocusin, onfocusout, onhelp, onlosecapture, onmouseenter, onmouseleave, onmousewheel, onmove, onmoveend, onmovestart, onpaste, onpropertychange, onreadystatechange, onresize, onresizeend, onresizestart, onselectstart, ontimeerror

Element Specific Attributes


accesskey
This Microsoft-specific attribute specifies a keyboard navigation accelerator for the element. Pressing ALT or a similar key in association with the specified character selects the form control correlated with that key sequence. Page designers are forewarned to avoid key sequences already bound to browsers.

cols
This attribute sets the width in characters of the text area. The typical default values for the size of a <textarea> element when this attribute is not set is 20 characters.

datafld
This attribute is used to indicate the column name in the data source that is bound to the content enclosed by the <textarea> element.

datasrc
The value of this attribute is an identifier indicating the data source to pull data from.

disabled
This attribute is used to turn off a form control. Elements will not be submitted nor can they receive any focus from the keyboard or mouse. Disabled form controls will not be part of the tabbing order. The browser also can gray out the form that is disabled in order to indicate to the user that the form control is inactive. This attribute requires no value.

name
This attribute allows a form control to be assigned a name so that it can be referenced by a scripting language. name is supported by older browsers, such as Netscape 2 generation browsers, but the W3C encourages the use of the id attribute. For compatibility purposes, both attributes might have to be used.

readonly
This attribute prevents the form control's value from being changed. Form controls with this attribute set might receive focus from the user but might not be modified. Because they receive focus, a readonly form control will be part of the form's tabbing order. Finally the control's value will be sent on form submission. The attribute can be used with <input> only when type is set to text or password. The attribute also is used with the <textarea> element.

rows
This attribute sets the number of rows in the text area. The value of the attribute should be a positive integer.

tabindex
This attribute takes a numeric value indicating the position of the form control in the tabbing index for the form. Tabbing proceeds from the lowest positive tabindex value to the highest. Negative values for tabindex will leave the form control out of the tabbing order. When tabbing is not explicitly set, the browser can tab through items in the order they are encountered. Form controls that are disabled due to the presence of the disabled attribute will not be part of the tabbing index, although read-only controls will be.

wrap
In some versions of Netscape and Microsoft browsers, this attribute controls word-wrap behavior. A value of off for the attribute forces the <textarea> not to wrap text, so the viewer must manually enter line breaks. A value of hard causes word wrap and includes line breaks in text submitted to the server. A value of soft causes word wrap but removes line breaks from text submitted to the server. Internet Explorer supports a value of physical, which is equivalent to Netscape's hard value, and a value of virtual, which is equivalent to Netscape's soft value. If the wrap attribute is not included, text will still wrap under Internet Explorer, but older versions of Netscape, notably Netscape 4, will scroll horizontally in the text box. Given this problem, even though it is nonstandard, it may be a good idea to include the wrap attribute.

Examples


<textarea name="CommentBox" cols="40" rows="8">
Default text in field
</textarea>

<textarea name="comment" rows="10" cols="40"
 wrap="virtual" align="center">
</textarea>

Compatibility


HTML 2, 3.2, 4, 4.01, XHTML 1.0, 1.1
Internet Explorer 2, 3, 4, 5, 5.5, 6
Netscape 1, 2, 3, 4, 4.5-4.8, 6, 7
Opera 4-7

Notes


Any text between the <textarea> and </textarea> tags is rendered as the default entry for the form control. Content within a textarea is not interpreted, so white space is preserved and tags themselves are ignored.

The HTML 2.0 and 3.2 specifications define only the cols, name, and rows attributes for this element.

The textarea element lacks a maxlength attribute, which causes a potential security risk. Potential intruders to a site may copy and paste large amounts of text or script code into a textarea element in an attempt to break a Web application. All submissions from a textarea should be checked carefully to avoid security risks.

The HTML 4.01 specification reserves the datafld and datasrc attributes for future use with the textarea element.

(X)HTML Elements
CSS Properties
Previous: td Next: tfoot
< Home | About | Chapters | Examples | Errata | Reference | Site Map >