jump

HTML 5: The Markup Language (ARIA Edition)

« td tfoot »

ⓘ textarea – text input area # T

The textarea element represents a multi-line plain-text edit control for the element’s raw value.

Permitted contents #

Permitted attributes #

global attributes & name & disabled & form & readonly & maxlength & autofocus & required & placeholder & dirname & rows & wrap.hard★ & cols★ or wrap.soft & cols

ⓘ global attributes
Any attributes permitted globally.
ⓘ name = string #
The name part of the name/value pair associated with this element for the purposes of form submission.
ⓘ disabled = d:string "disabled" or d:string "" #
Specifies that the element represents a disabled control.
ⓘ form = ID reference NEW #
The value of the id attribute on the form with which to associate the element.
ⓘ readonly = d:string "readonly" or d:string "" #
Specifies that element represents a control whose value is not meant to be edited.
ⓘ maxlength = non-negative integer #
The maximum allowed value length of the element.
ⓘ autofocus = d:string "autofocus" or d:string "" NEW #
Specifies that the element represents a control to which a UA is meant to give focus as soon as the document is loaded.
ⓘ required = d:string "required" or d:string "" NEW #
Specifies that the element is a required part of form submission.
ⓘ placeholder = string without line breaks NEW #
A short hint (one word or a short phrase) intended to aid the user when entering data into the control represented by its element.
Any string that contains no line feed (U+000A, “LF”) or carriage return (U+000D, “CR”) characters.
ⓘ dirname = non-empty string NEW #
Enables submission of a value for the directionality of the element, and gives the name of the field that contains that value.
Any string that is not empty.
ⓘ rows = positive integer #
The number of lines of text for the UA to show.
ⓘ wrap = d:string "hard" NEW #
Instructs the UA to insert line breaks into the submitted value of the textarea such that each line has no more characters than the value specified by the cols attribute.
ⓘ cols = positive integer #
The expected maximum number of characters per line of text for the UA to show.
ⓘ wrap = d:string "soft" NEW #
Instructs the UA to add no line breaks to the submitted value of the textarea.

Additional constraints and admonitions #

Tag omission #

A textarea element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain phrasing elements

Details #

The contents of the textarea element represent the control’s default value.

DOM interface #

interface HTMLTextAreaElement : HTMLElement {
           attribute boolean autofocus;
           attribute unsigned long cols;
           attribute DOMString dirName;
           attribute boolean disabled;
  readonly attribute HTMLFormElement? form;
           attribute long maxLength;
           attribute DOMString name;
           attribute DOMString placeholder;
           attribute boolean readOnly;
           attribute boolean required;
           attribute unsigned long rows;
           attribute DOMString wrap;

  readonly attribute DOMString type;
           attribute DOMString defaultValue;
           attribute DOMString value;
  readonly attribute unsigned long textLength;

  readonly attribute boolean willValidate;
  readonly attribute ValidityState validity;
  readonly attribute DOMString validationMessage;
  boolean checkValidity();
  void setCustomValidity(DOMString error);

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
           attribute DOMString selectionDirection;
  void setSelectionRange(unsigned long start, unsigned long end, optional DOMString direction);
};
« td tfoot »