HTML/Elements/input/email

From W3C Wiki
< HTML‎ | Elements‎ | input
Jump to: navigation, search

<input type="email">

The E-mail state represents a control for editing a list of e-mail addresses given in the element's value.

Point

  • If the multiple attribute is specified on the element, then, while the value of the element is not a valid e-mail address list, the element is suffering from a type mismatch; otherwise, while the value of the element is not a single valid e-mail address, the element is suffering from a type mismatch.


HTML Attributes

  • autocomplete = on/ off/ defult
    • on
      The on state indicates that the value is not particularly sensitive and the user can expect to be able to rely on his user agent to remember values he has entered for that control.
    • off
      The off state indicates either that the control's input data is particularly sensitive (for example the activation code for a nuclear weapon); or that it is a value that will never be reused (for example a one-time-key for a bank login) and the user will therefore have to explicitly enter the data each time, instead of being able to rely on the UA to prefill the value for him; or that the document provides its own autocomplete mechanism and does not want the user agent to provide autocompletion values.
    • defult
      The default state indicates that the user agent is to use the autocomplete attribute on the element's form owner instead. (By default, the autocomplete attribute of form elements is in the on state.)


  • list = ID reference
    Identify an element that lists predefined options suggested to the user.
    If present, its value must be the ID of a datalist element in the same document.


  • maxlength = positive integer
    Gives the maximum allowed value length of the element.


  • multiple = boolean
    Indicates whether the user is to be allowed to specify more than one value. [Example A]


  • name = string
    Gives the name of the input element.


  • pattern =
    Specifies a regular expression against which the control's value is to be checked.
    If specified, the attribute's value must match the JavaScript Pattern production.
    When an input element has a pattern attribute specified, authors should include a title attribute to give a description of the pattern.


  • placeholder = string
    Represents a short hint (a word or short phrase) intended to aid the user with data entry.
    A hint could be a sample value or a brief description of the expected format. For a longer hint or other advisory text, the title attribute is more appropriate.


  • readonly = boolean
    Controls whether or not the user can edit the form control.


  • required = boolean
    When specified, the element is required.


  • size = valid non-negative integer
    The number of options meant to be shown by the control represented by its element.


  • value = string
    Gives the default value of the input element.


Examples

Example A

The following extract shows how an e-mail client's "Cc" field could accept multiple e-mail addresses. [try it]:

<label>Cc: <input type=email multiple name=cc></label>

Input email01.png

HTML Reference

The HTML5 specification defines the E-mail state in 4.10.7.1.5 E-MAIL STATE.