input type=text – text-input field

Permitted contents #

Permitted attributes #

global attributes & name & disabled & form & type & maxlength & readonly & size & value & common.attrs.aria or notAllowed & autocomplete & autofocus & list & pattern & required & placeholder & dirname

ⓘ 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.
ⓘ type = d:string "text" #: Specifies that its input element is a one-line plain-text edit control for the input element’s value.
ⓘ maxlength = non-negative integer #: The maximum allowed value length of the element.
ⓘ readonly = d:string "readonly" or d:string "" #: Specifies that element represents a control whose value is not meant to be edited.
ⓘ size = positive integer #: The number of options meant to be shown by the control represented by its element.
ⓘ value = string without line breaks #: Specifies a value for this input element.; Any string that contains no line feed (U+000A, “LF”) or carriage return (U+000D, “CR”) characters.
aria = #: (detailed attribute description to come)
ⓘ autocomplete = d:string "on" or d:string "off" NEW #: Specifies whether the element represents an input control for which a UA is meant to store the value entered by the user (so that the UA can prefill the form later).
ⓘ 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.
ⓘ list = ID reference NEW #: The value of the id attribute on the datalist with which to associate the element.
ⓘ pattern = pattern NEW #: Specifies a regular expression against which a UA is meant to check the value of the control represented by its element.; A regular expression that must match the JavaScript Pattern production as specified in [ECMA 262].
ⓘ 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.

Additional constraints and admonitions #

The interactive element “input” must not appear as a descendant of the “a” element.
The interactive element “input” must not appear as a descendant of the “button” element.
Any “input” element descendant of a “label” element with a “for” attribute must have an ID value that matches that “for” attribute.
The “list” attribute of the “input” element must refer to a “datalist” element.
Element “input” with attribute “type” whose value is “button” must have non-empty attribute “value”.
The “usemap” attribute on the “input” element is obsolete. Use the “img” element instead of the “input” element for image maps.
The “align” attribute on the “input” element is obsolete. Use CSS instead. http://wiki.whatwg.org/wiki/Presentational_elements_and_attributes

Tag omission #

The input element is a void element. An input element must have a start tag but must not have an end tag.

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

interface HTMLInputElement : HTMLElement {
           attribute DOMString accept;
           attribute DOMString alt;
           attribute DOMString autocomplete;
           attribute boolean autofocus;
           attribute boolean defaultChecked;
           attribute boolean checked;
           attribute DOMString dirName;
           attribute boolean disabled;
  readonly attribute HTMLFormElement? form;
  readonly attribute FileList? files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute unsigned long height;
           attribute boolean indeterminate;
  readonly attribute HTMLElement? list;
           attribute DOMString max;
           attribute long maxLength;
           attribute DOMString min;
           attribute boolean multiple;
           attribute DOMString name;
           attribute DOMString pattern;
           attribute DOMString placeholder;
           attribute boolean readOnly;
           attribute boolean required;
           attribute unsigned long size;
           attribute DOMString src;
           attribute DOMString step;
           attribute DOMString type;
           attribute DOMString defaultValue;
           attribute DOMString value;
           attribute Date? valueAsDate;
           attribute double valueAsNumber;
           attribute unsigned long width;

  void stepUp(optional long n);
  void stepDown(optional long n);

  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);
};

HTML 5: The Markup Language (ARIA Edition)

ⓘ input type=text – text-input field # T

Permitted contents #

Permitted attributes #

Additional constraints and admonitions #

Tag omission #

Permitted parent elements #

DOM interface #