Warning:
This wiki has been archived and is now read-only.
Elements/input/email
From HTML Wiki
Contents
<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.)
- on
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>
HTML Reference
The HTML5 specification defines the E-mail state in 4.10.7.1.5 E-MAIL STATE.