HTML: The Markup Language

Abstract

This non-normative reference describes the HTML markup language and provides details to help producers of HTML content create documents that conform to the language. It is intended to complement the normative conformance criteria defined in the HTML5: A vocabulary and associated APIs for HTML and XHTML specification [HTML5]. By design, this reference does not describe related APIs in detail, nor attempt to explain how implementations that are consumers of HTML content are meant to process documents (those areas are covered by the HTML5 specification itself), nor attempt to also be a tutorial or “how to” authoring guide.

1. Introduction # T

This document is a non-normative reference that provides details to help producers of HTML content create conformant documents, and to help others check the conformance of existing documents. It has the following design goals:

to describe the syntax and structure of the HTML language
to describe the semantics of HTML elements and their attributes (that is, to describe what the elements and attributes represent)
to be clear and unambiguous
to be as concise and readable as possible

The first two of the above design goals make this reference similar in scope to the HTML5 (Edition for Web Authors) subset [HTML5AUTHOR] of the normative HTML5: A vocabulary and associated APIs for HTML and XHTML full specification [HTML5].

Certain purposes are intentionally out of scope for this reference document; specifically, it:

does not provide any descriptions of implementation conformance criteria for HTML consumers; in particular, it does not attempt to explain how Web browsers and other user agents are meant to process documents
does not provide detailed information on APIs related to processing of HTML content by HTML consumers.

For implementation conformance criteria for HTML consumers and detailed information on related APIs, instead see the HTML5: A vocabulary and associated APIs for HTML and XHTML full specification [HTML5].

Finally, because this document is intended for use strictly as a reference, it does not attempt to also be a tutorial or “how to” authoring guide.

2. Terminology # T

The following is a list of terms that are used in other sections of this reference.

browsing context

A browsing context is an environment in which UAs present documents to users. A tab or window in a Web browser typically contains a browsing context, as does an iframe, or frame elements in a frameset.

case-insensitive match

For the purposes of this reference, performing a case-insensitive match between two strings means comparing the strings exactly, codepoint for codepoint, except that the characters in the range A-Z and the corresponding characters in the range a-z are considered to also match.

fallback content

Some embedded content elements can have fallback content: content that is to be used when the embedded content cannot be used (for example, when it is of an unsupported format).

flow content

Flow content consists of flow elements intermixed with normal character data.

HTML producers

HTML authors (that is, people) and applications (such as editors and content management systems) that produce HTML content.

HTML consumers

HTML user agents; that is, applications (such as Web browsers) which consume HTML content.

must

The word must is used in this reference to mark document-conformance requirements that are normatively defined in the HTML5: A vocabulary and associated APIs for HTML and XHTML full specification. [HTML5].

This reference does not itself normatively define any requirements.

newline

A newline may be represented as any of the following:

a U+000D CARRIAGE RETURN (CR) character
a U+000A LINE FEED (LF) character
a U+000D CARRIAGE RETURN (CR) followed by a U+000A LINE FEED (LF) character

phrasing content

Phrasing content consists of phrasing elements intermixed with normal character data.

space

A space character is any of the following:

U+0020 SPACE
U+0009 CHARACTER TABULATION (tab)
U+000A LINE FEED (LF)
U+000C FORM FEED (FF)
U+000D CARRIAGE RETURN (CR)

transparent

If the content model of a particular element foo is described as transparent, it means:

when element foo is a child of a parent element bar whose content model is allowed to contain flow elements, then the contents of element foo may also contain flow elements
when element foo is a child of a parent element baz whose content model restricts its child elements to only being phrasing elements, then any child elements of element foo are also restricted to only being phrasing elements

3. Documents # T

This section defines the term document, and provides additional details related to the definition of that term. It is divided into the following parts:

1.The HTML language and HTML and XML syntaxes
2.The HTML namespace and MIME types
3.Conformant documents
4.Case insensitivity in tag names and attribute names

3.01. The HTML language and HTML and XML syntaxes # T

The term document is used in this reference to mean an instance of the HTML language.

The HTML language is the language described in this reference; it is an abstract language that applications can potentially represent in memory in any number of possible ways, and that can be transmitted using any number of possible concrete syntaxes.

This reference describes two particular concrete syntaxes for the HTML language: One syntax, which is referred to throughout this reference as the HTML syntax, and another syntax, which is referred to throughout this reference as the XML syntax. Web browsers typically implement two separate parsers for processing documents: an HTML parser which is invoked when processing documents in the HTML syntax, and an XML parser which is invoked when processing documents in the XML syntax.

The HTML syntax is the syntax described in the HTML syntax section of this reference.

The XML syntax is defined by rules in the XML specification [XML] and in the Namespaces in XML 1.0 specification [XMLNS]; any syntax-level requirements for documents in the XML syntax described in this reference are intended to be the same as those defined in the XML specification.

3.02. The HTML namespace and MIME types # T

The HTML namespace is defined as http://www.w3.org/1999/xhtml. The HTML namespace is the namespace both for documents in the HTML syntax and for documents in the XML syntax.

Documents that are served with the text/html MIME type must match the descriptions in this reference for characteristics of documents in the HTML syntax.

Documents that have an HTML namespace declaration and that are served with an XML MIME type such as text/xml, application/xml, or application/xhtml+xml must match the descriptions in this reference for characteristics of documents in the XML syntax.

3.03. Conformant documents # T

A conformant document in the HTML syntax must consist of the following parts, in the following order:

Optionally, a single U+FEFF BYTE ORDER MARK (BOM) character.
Any number of comments and space characters.
A doctype.
Any number of comments and space characters.
An html element, with its attributes and contents.
Any number of comments and space characters.

Documents in the HTML syntax must match the syntax described in the HTML syntax section of this reference.

A conformant document in the XML syntax must be a namespace-well-formed XML document, as defined in the Namespaces in XML 1.0 specification [XMLNS], and its root element must be an html element.

Documents in the XML syntax must not make use of any features of the HTML syntax that do not follow XML well-formedness constraints (for example, documents in the XML syntax must not use unquoted attribute value syntax and must not omit tags).

3.04. Case insensitivity in tag names and attribute names # T

In documents in the HTML syntax:

Tag names for HTML elements may be written with any mix of lowercase and uppercase letters that are a case-insensitive match for the names of the elements given in the HTML elements section of this document; that is, tag names are case-insensitive.
Attribute names for HTML elements may be written with any mix of lowercase and uppercase letters that are an case-insensitive match for the names of the attributes given in the HTML elements section of this document; that is, attribute names are case-insensitive.

In documents in the XML syntax:

Tag names for HTML elements must exactly match the names of the elements given in the HTML elements section of this document; that is, tag names are case-sensitive.
Attribute names for HTML elements must exactly match the names of the attributes given in the HTML elements section of this document; that is, attribute names are case-sensitive.

4. HTML syntax # T

This section describes the HTML syntax in detail. In places, it also notes differences between the the HTML syntax and the XML syntax, but it does not describe the XML syntax in detail (the XML syntax is instead defined by rules in the XML specification [XML] and in the Namespaces in XML 1.0 specification [XMLNS]).

This section is divided into the following parts:

1.The doctype
2.Character encoding declaration
3.Elements
4.Attributes
5.Text and character data
6.Character references
7.Comments
8.SVG and MathML elements in HTML documents
9.CDATA sections in SVG and MathML contents

4.01. The doctype # T

A doctype (sometimes capitalized as “DOCTYPE”) is an special instruction which, for legacy reasons that have to do with processing modes in browsers, is a required part of any document in the HTML syntax; it must match the characteristics of one of the following three formats:

normal doctype
deprecated doctype
legacy-tool-compatible doctype

A normal doctype consists of the following parts, in exactly the following order:

Any case-insensitive match for the string "<!DOCTYPE".
One or more space characters.
Any case-insensitive match for the string "HTML".
Optionally, one or more space characters.
A ">" character.

The following is an example of a conformant normal doctype.

<!DOCTYPE html>

A deprecated doctype consists of the following parts, in exactly the following order:

Any case-insensitive match for the string "<!DOCTYPE".
One or more space characters.
Any case-insensitive match for the string "HTML".
One or more space characters.
Any case-insensitive match for the string "PUBLIC".
One or more space characters.
A quote mark (public ID), consisting of either a """ character or a "'" character.
A permitted public ID
A matching quote mark (public ID), identical to the quote mark (public ID) used earlier (either a """ character or a "'" character).
Conditionally, depending on whether it is part of a permitted-public-ID-system-ID-combination, the following parts, in exactly the following order:
1. One or more space characters.
2. A quote mark (system ID), consisting of either a """ character or a "'" character.
3. A permitted system ID
4. A matching quote mark (system ID), identical to the quote mark (system ID) used earlier (either a """ character or a "'" character).
Optionally, one or more space characters.
A ">" character.

A permitted-public-ID-system-ID-combination is any combination of a public ID (the first quoted string in the doctype) and system ID (the second quoted string, if any, in the doctype) such that the combination corresponds to one of the six deprecated doctypes in the following list of deprecated doctypes:

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN">
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

A legacy-tool-compatible doctype consists of the following parts, in exactly the following order:

Any case-insensitive match for the string "<!DOCTYPE".
One or more space characters.
Any case-insensitive match for the string "HTML".
One or more space characters.
Any case-insensitive match for the string "SYSTEM".
One or more space characters
A quote mark, consisting of either a """ character or a "'" character.
The literal string "about:legacy-compat".
A matching quote mark, identical to the quote mark used earlier (either a """ character or a "'" character).
Optionally, one or more space characters.
A ">" character.

The following is examples of a conformant legacy-tool-compatible doctype.

<!doctype HTML system "about:legacy-compat">

4.02. Character encoding declaration # T

A character encoding declaration is a mechanism for specifying the character encoding used to store or transmit a document.

The following restrictions apply to character encoding declarations:

The character encoding name given must be the name of the character encoding used to serialize the file.
The value must be a valid character encoding name, and must be the preferred name for that encoding. [IANACHARSET]
The character encoding declaration must be serialized without the use of character references or character escapes of any kind.
The element containing the character encoding declaration must be serialized completely within the first 512 bytes of the document.

If the document does not start with a U+FEFF BYTE ORDER MARK (BOM) character, and if its encoding is not explicitly given by a Content-Type HTTP header, then the character encoding used must be an ASCII-compatible character encoding, and, in addition, if that encoding isn't US-ASCII itself, then the encoding must be specified using a meta element with a charset attribute or a meta element in the encoding declaration state.

If the document contains a meta element with a charset attribute or a meta element in the encoding declaration state, then the character encoding used must be an ASCII-compatible character encoding.

An ASCII-compatible character encoding is one that is a superset of US-ASCII (specifically, ANSI_X3.4-1968) for bytes in the set 0x09, 0x0A, 0x0C, 0x0D, 0x20 - 0x22, 0x26, 0x27, 0x2C - 0x3F, 0x41 - 0x5A, and 0x61 - 0x7A.

Documents should not use UTF-32, JIS_C6226-1983, JIS_X0212-1990, HZ-GB-2312, JOHAB (Windows code page 1361), encodings based on ISO-2022, or encodings based on EBCDIC.

Documents must not use CESU-8, UTF-7, BOCU-1, or SCSU encodings.

In a document in the XML syntax, the XML declaration, as defined in the XML specification [XML] should be used to provide character-encoding information, if necessary.

4.03. Elements # T

An element’s content model defines the element’s structure: What contents (if any) the element can contain, as well as what attributes (if any) the element can have. The HTML elements section of this reference describes the content models for all of elements that are part of the HTML language. An element must not contain contents or attributes that are not part of its content model.

The contents of an element are any elements, character data, and comments that it contains. Attributes and their values are not considered to be the “contents” of an element.

A void element is an element whose content model never allows it to have contents under any circumstances. Void elements can have attributes.

The following is a complete list of the void elements in HTML:

area, base, br, col, command, embed, hr, img, input, keygen, link, meta, param, source, wbr

The following list describes syntax rules for the the HTML syntax. Rules for the the XML syntax are defined in the XML specification [XML].

Tags are used to delimit the start and end of elements in markup. Elements have a start tag to indicate where they begin. Non-void elements have an end tag to indicate where they end.
Tag names are used within element start tags and end tags to give the element’s name. HTML elements all have names that only use characters in the range 0–9, a–z, and A–Z.
Start tags consist of the following parts, in exactly the following order:
1. A "<" character.
2. The element’s tag name.
3. Optionally, one or more attributes, each of which must be preceded by one or more space characters.
4. Optionally, one or more space characters.
5. Optionally, a "/" character, which may be present only if the element is a void element.
6. A ">" character.
End tags consist of the following parts, in exactly the following order:
1. A "<" character.
2. A "/" character
3. The element’s tag name.
4. Optionally, one or more space characters.
5. A ">" character.
Void elements only have a start tag; end tags must not be specified for void elements.
The start and end tags of certain elements can be omitted. The subsection for each element in the HTML elements section of this reference provides information about which tags (if any) can be omitted for that particular element.
A non-void element must have an end tag, unless the subsection for that element in the HTML elements section of this reference indicates that its end tag can be omitted.
The contents of an element must be placed between just after its start tag (which might be implied, in certain cases) and just before its end tag (which might be implied in certain cases).

4.3.01. Misnested tags #

If an element has both a start tag and an end tag, its end tag must be contained within the contents of the same element in which its start tag is contained. An end tag that is not contained within the same contents as its start tag is said to be a misnested tag.

In the following example, the "</i>" end tag is a misnested tag, because it is not contained within the contents of the b element that contains its corresponding "<i>" start tag.

<b>foo <i>bar</b> baz</i>

4.04. Attributes # T

Attributes for an element are expressed inside the element’s start tag. Attributes have a name and a value.

There must never be two or more attributes on the same start tag whose names are a case-insensitive match for each other.

The following list describes syntax rules for attributes in documents in the HTML syntax. Syntax rules for attributes in documents in the XML syntax. are defined in the XML specification [XML].

Attribute names must consist of one or more characters other than the space characters, U+0000 NULL, """, "'", ">", "/", "=", the control characters, and any characters that are not defined by Unicode.
XML-compatible attribute names are those that match the Name production defined in the XML specification [XML] and that contain no ":" characters, and whose first three characters are not a case-insensitive match for the string "xml".
Attribute values, in general, are normal character data; however, the HTML elements section of this reference describes further restrictions on the allowed values of all attributes that are part of the HTML language. An attribute must not have a value that is not allowed by the content model of the element that contains it.

In the the HTML syntax, attributes can be specified in four different ways:

empty attribute syntax
unquoted attribute-value syntax
single-quoted attribute-value syntax
double-quoted attribute-value syntax

Empty attribute syntax

Certain attributes may be specified by providing just the attribute name, with no value.

In the following example, the disabled attribute is given with the empty attribute syntax:

<input disabled>

Unquoted attribute-value syntax

An unquoted attribute value is specified by providing the following parts in exactly the following order:

an attribute name
zero or more space characters
a single "=" character
zero or more space characters
an attribute value

In addition to the general requirements given above for attribute values, an unquoted attribute value has the following restrictions:

must not contain any literal space characters
must not contain any """, "'", ">", "=", characters
must not be the empty string

In the following example, the value attribute is given with the unquoted attribute value syntax:

<input value=yes>

If the value of an attribute using the unquoted attribute syntax is followed by a "/" character, then there must be at least one space character after the value and before the "/" character.

Single-quoted attribute-value syntax

A single-quoted attribute value is specified by providing the following parts in exactly the following order:

an attribute name
zero or more space characters
a "=" character
zero or more space characters
a single "'" character
an attribute value
a "'" character.

In addition to the general requirements given above for attribute values, a single-quoted attribute value has the following restriction:

must not contain any literal "'" characters

In the following example, the type attribute is given with the single-quoted attribute value syntax:

<input type='checkbox'>

Double-quoted attribute-value syntax

A double-quoted attribute value is specified by providing the following parts in exactly the following order:

an attribute name
zero or more space characters
a single "=" character
zero or more space characters
a single """ character
an attribute value
a """ character

In addition to the general requirements given above for attribute values, a double-quoted attribute value has the following restriction:

must not contain any literal """ characters

In the following example, the title attribute is given with the double-quoted attribute value syntax:

<code title="U+003C LESS-THAN SIGN">&lt;</code>

4.05. Text and character data # T

Text in element contents (including in comments) and attribute values must consist of Unicode characters, with the following restrictions:

must not contain U+0000 characters
must not contain permanently undefined Unicode characters
must not contain control characters other than space characters

Character data contains text, in some cases in combination with character references, along with certain additional restrictions. There are three types of character data that can occur in documents:

normal character data
replaceable character data
non-replaceable character data

Normal character data

Certain elements and strings in the values of particular attributes contain normal character data. Normal character data can contain the following:

text
character references

Normal character data has the following restrictions:

must not contain any "<" characters

Replaceable character data

In documents in the HTML syntax, the title and textarea elements can contain replaceable character data. Replaceable character data can contain the following:

text, optionally including "<" characters
character references

Replaceable character data has the following restrictions:

must not contain any ambiguous ampersands
must not contain any occurrences of the string "</" followed by characters that are a case-insensitive match for the tag name of the element containing the replaceable character data (for example, "</title" or "</textarea"), followed by a space character, ">", or "/".

Replaceable character data, as described in this reference, is a feature of the HTML syntax that is not available in the XML syntax. Documents in the XML syntax must not contain replaceable character data as described in this reference; instead they must conform to all syntax constraints described in the XML specification [XML].

Non-replaceable character data

In documents in the HTML syntax, the script, and style elements can contain non-replaceable character data. Non-replaceable character data can contain the following:

text, optionally including "<" characters
ambiguous ampersands

Non-replaceable character data has the following restrictions:

must not contain character references
must not contain any occurrences of the string "</", followed by characters that are a case-insensitive match for the tag name of the element containing the replaceable character data (for example, "</script" or "</style", followed by a space character, ">", or "/".

Non-replaceable character data, as described in this reference, is a feature of the HTML syntax that is not available in the XML syntax. Documents in the XML syntax must not contain non-replaceable character data as described in this reference; instead they must conform to all syntax constraints defined in the XML specification [XML].

4.06. Character references # T

Character references are a form of markup for representing single individual characters. There are three types of character references:

named character references
decimal numeric character references
hexadecimal numeric character references

Named character reference

Named character references consist of the following parts in exactly the following order:

An "&" character.
One of the entity names defined in XML Entity definitions for Characters [Entities], using the same case.
A ";" character.

The following is an example of a named character reference for the character "†" (U+2020 DAGGER).

&dagger;

Decimal numeric character reference

Decimal numerical character references consist of the following parts, in exactly the following order.

An "&" character.
A "#" character.
One or more digits in the range 0–9, representing a base-ten integer that itself is a Unicode code point that is not U+0000, U+000D, in the range U+0080–U+009F, or in the range 0xD8000–0xDFFF (surrogates).
A ";" character.

The following is an example of a decimal numeric character reference for the character "†" (U+2020 DAGGER).

&#8224;

Hexadecimal numeric character reference

Hexadecimal numeric character references consist of the following parts, in exactly the following order.

An "&" character.
A "#" character.
Either a "x" character or a "X" character.
One or more digits in the range 0–9, a–f, and A–F, representing a base-sixteen integer that itself is a Unicode code point that is not U+0000, U+000D, in the range U+0080–U+009F, or in the range 0xD800–0xDFFF (surrogates).
A ";" character.

The following is an example of a hexadecimal numeric character reference for the character "†" (U+2020 DAGGER).

&#x2020;

Character references are not themselves text, and no part of a character reference is text.

An ambiguous ampersand is an "&" character that is followed by some text other than a space character, a "<", character, or another "&" character.

4.07. Comments # T

Comments consist of the following parts, in exactly the following order:

the comment start delimiter "<!--"
text
the comment end delimiter "-->"

The text part of comments has the following restrictions:

must not start with a ">" character
must not start with the string "->"
must not contain the string "--"
must not end with a "-" character

The following is an example of a comment.

<!-- main content starts here -->

4.08. SVG and MathML elements in HTML documents # T

SVG and MathML elements are elements from the SVG and MathML namespaces. SVG and MathML elements can be used both in documents in the HTML syntax and in documents in the XML syntax. Syntax rules for SVG and MathML elements in documents in the XML syntax are defined in the XML specification [XML]. The following list describes additional syntax rules that specifically apply to SVG and MathML elements in documents in the HTML syntax.

SVG and MathML elements whose start tags have a single "/" character before the closing ">" character are said to be marked as self-closing.
SVG and MathML elements must either have a start tag and an end tag, or a start tag that is marked as self-closing, in which case they must not have an end tag.
SVG and MathML elements whose start tag is marked as self-closing, can’t have any contents.
The contents of an SVG or MathML element whose start tag is not marked as self-closing are any elements, character data, comments, and CDATA sections that it contains, with the restriction that any character data it contains must be normal character data.

4.09. CDATA sections in SVG and MathML contents # T

CDATA sections in SVG and MathML contents in documents in the HTML syntax consist of the following parts, in exactly the following order:

the CDATA start delimiter "<![CDATA["
text, with the additional restriction that the text must not contain the string "]]>“
the CDATA end delimiter "]]>"

CDATA sections are allowed only in the contents of elements from the SVG and MathML namespaces.

The following shows an example of a CDATA section.

<annotation encoding="text/latex">
  <![CDATA[\documentclass{article}
  \begin{document}
  \title{E}
  \maketitle
  The base of the natural logarithms, approximately 2.71828.
  \end{document}]]>
</annotation>

5. HTML elements # T

The complete set of HTML elements is the set of elements described in the following sections.

a – hyperlink ⓘ
abbr – abbreviation ⓘ
address – contact information ⓘ
area – image-map hyperlink ⓘ
article – article ⓘ NEW
aside – tangential content ⓘ NEW
audio – audio stream ⓘ NEW
b – offset text typically styled in bold ⓘ CHANGED
base – base URL ⓘ
bdo – BiDi override ⓘ
blockquote – block quotation ⓘ
body – document body ⓘ
br – line break ⓘ
button ⓘ
button type=submit – submit button
button type=reset – reset button
button type=button – button with no additional semantics
canvas – canvas for dynamic graphics ⓘ NEW
caption – table title ⓘ
cite – cited title of a work ⓘ CHANGED
code – code fragment ⓘ
col – table column ⓘ
colgroup – table column group ⓘ
command ⓘ NEW
command type=command – command with an associated action NEW
command type=radio – selection of one item from a list of items NEW
command type=checkbox – state or option that can be toggled NEW
datalist – predefined options for other controls ⓘ NEW
dd – description or value ⓘ
del – deleted text ⓘ
details – control for additional on-demand information ⓘ NEW
dfn – defining instance ⓘ
div – generic flow container ⓘ
dl – description list ⓘ
dt – term or name ⓘ
em – emphatic stress ⓘ CHANGED
embed – integration point for plugins ⓘ NEW
fieldset – set of related form controls ⓘ
figcaption – figure caption ⓘ NEW
figure – figure with optional caption ⓘ NEW
footer – footer ⓘ NEW
form – user-submittable form ⓘ
h1 – heading ⓘ
h2 – heading ⓘ
h3 – heading ⓘ
h4 – heading ⓘ
h5 – heading ⓘ
h6 – heading ⓘ
head – document metadata ⓘ
header – header ⓘ NEW
hgroup – heading group ⓘ NEW
hr – thematic break ⓘ CHANGED
html – root element ⓘ
i – offset text typically styled in italic ⓘ
iframe – nested browsing context (inline frame) ⓘ
img – image ⓘ
input ⓘ
input type=text – text-input field
input type=password – password-input field
input type=checkbox – checkbox
input type=radio – radio button
input type=button – button
input type=submit – submit button
input type=reset – reset button
input type=file – file upload control
input type=hidden – hidden input control
input type=image – image-coordinates input control
input type=datetime – global date-and-time input control NEW
input type=datetime-local – local date-and-time input control NEW
input type=date – date input control NEW
input type=month – year-and-month input control NEW
input type=time – time input control NEW
input type=week – year-and-week input control NEW
input type=number – number input control NEW
input type=range – imprecise number-input control NEW
input type=email – e-mail address input control NEW
input type=url – URL input control NEW
input type=search – search field NEW
input type=tel – telephone-number-input field NEW
input type=color – color-well control NEW
ins – inserted text ⓘ
kbd – user input ⓘ
keygen – key-pair generator/input control ⓘ NEW
label – caption for a form control ⓘ
legend – title or explanatory caption ⓘ
li – list item ⓘ
link – inter-document relationship metadata ⓘ
map – image-map definition ⓘ
mark – marked (highlighted) text ⓘ NEW
menu – list of commands ⓘ CHANGED
meta ⓘ
meta name – name-value metadata
meta http-equiv=refresh – “refresh” pragma directive
meta http-equiv=default-style – “preferred stylesheet” pragma directive
meta http-equiv=content-language – “default language” pragma directive OBSOLETE
meta charset – document character-encoding declaration NEW
meta http-equiv=content-type – document character-encoding declaration
meter – scalar gauge ⓘ NEW
nav – group of navigational links ⓘ NEW
noscript – fallback content for script ⓘ
object – generic external content ⓘ
ol – ordered list ⓘ
optgroup – group of options ⓘ
option – option ⓘ
output – result of a calculation in a form ⓘ NEW
p – paragraph ⓘ
param – initialization parameters for plugins ⓘ
pre – preformatted text ⓘ
progress – progress indicator ⓘ NEW
q – quoted text ⓘ
rp – ruby parenthesis ⓘ NEW
rt – ruby text ⓘ NEW
ruby – ruby annotation ⓘ NEW
samp – (sample) output ⓘ
script – embedded script ⓘ
section – section ⓘ NEW
select – option-selection form control ⓘ
small – small print ⓘ CHANGED
source – media source ⓘ NEW
span – generic span ⓘ
strong – strong importance ⓘ CHANGED
style – style (presentation) information ⓘ
sub – subscript ⓘ
summary – summary, caption, or legend for a details control ⓘ NEW
sup – superscript ⓘ
table – table ⓘ
tbody – table row group ⓘ
td – table cell ⓘ
textarea – text input area ⓘ
tfoot – table footer row group ⓘ
th – table header cell ⓘ
thead – table heading group ⓘ
time – date and/or time ⓘ NEW
title – document title ⓘ
tr – table row ⓘ
ul – unordered list ⓘ
var – variable or placeholder text ⓘ
video – video ⓘ NEW
wbr – line-break opportunity ⓘ NEW

a – hyperlink ⓘ # T

The a element represents a hyperlink.

Permitted content #

transparent (either phrasing content or flow content)

Permitted attributes #

common attributes & name & href & target & rel & hreflang & media & type

Descriptions for attributes specific to this element #

name = ID OBSOLETE: Specifies that its a element is a named hyperlink, with the name given by the value of this attribute.; The name attribute on the a element is obsolete. Consider putting an id attribute on the nearest container instead.
href = URI: A URL that provides the destination of the hyperlink. If the href attribute is not specified, the element represents a placeholder hyperlink.
target = browsing-context name or keyword CHANGED: A name or keyword giving a browsing context for UAs to use when following the hyperlink.; The target attribute on the a element was deprecated in a previous version of HTML, but is no longer deprecated, as it useful in Web applications, particularly in combination with the iframe element.
rel = tokens: A list of tokens that specify the relationship between the document containing the hyperlink and the destination indicated by the hyperlink.
hreflang = language tag: The language of the destination of the hyperlink.
media = media-query list NEW: The media for which the destination of the hyperlink was designed.
type = MIME type: The MIME type of the destination of the hyperlink.

Additional constraints and admonitions #

The interactive element a must not appear as a descendant of the a element.
The interactive element a must not appear as a descendant of the button element.
The coords attribute on the a element is obsolete. For image maps, use the area element instead of the a element.
The shape attribute on the a element is obsolete. For image maps, use the area element instead of the a element.
The urn attribute on the a element is obsolete. Specify the preferred persistent identifier using the href attribute instead.
The charset attribute on the a element is obsolete. Use an HTTP Content-Type header on the linked resource instead.
The methods attribute on the a element is obsolete. Use the HTTP OPTIONS feature instead.
The rev attribute on the a element is obsolete. Use the rel attribute instead, with a term having the opposite meaning.

Tag omission #

An a element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain phrasing elements, any element that can contain flow elements

Details #

If the contents of an a element are empty, the element represents an empty hyperlink.

Although previous versions of HTML restricted the a element to only containing phrasing content, the a element is now transparent; and so is now also allowed to contain flow content if its parent element is is allowed to contain flow content.

DOM interface #

interface HTMLAnchorElement : HTMLElement {
  stringifier attribute DOMString href;
           attribute DOMString target;
           attribute DOMString rel;
  readonly attribute DOMTokenList relList;
           attribute DOMString media;
           attribute DOMString hreflang;
           attribute DOMString type;

           attribute DOMString text;

  // URL decomposition IDL attributes
           attribute DOMString protocol;
           attribute DOMString host;
           attribute DOMString hostname;
           attribute DOMString port;
           attribute DOMString pathname;
           attribute DOMString search;
           attribute DOMString hash;
};

Typical default display properties #

a:link, a:visited {

color: (internal value);

text-decoration: underline;

cursor: auto; }

a:link:active, a:visited:active {

color: (internal value); }

abbr – abbreviation ⓘ # T

The abbr element represents an abbreviation or acronym.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

An abbr element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain phrasing elements

Details #

The title attribute on the abbr element represents the expansion of the abbreviation or acronym.

DOM interface #

Uses HTMLElement.

address – contact information ⓘ # T

The address element represents contact information.

Permitted content #

flow content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The address element must not contain any nested address elements.

Tag omission #

An address element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain flow elements

Details #

If an address element applies to a body element, then it represents contact information for the document as a whole. If an address element applies to a section of a document, then it represents contact information for that section only.

DOM interface #

Uses HTMLElement.

Typical default display properties #

address {

display: block; }

address {

font-style: italic; }

area – image-map hyperlink ⓘ # T

The area element represents either a hyperlink with some text and a corresponding area on an image map, or a dead area on an image map.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & alt★ & href★ & target & rel & media & hreflang & type & shape="rect" & coords★ or shape="circle"★ & coords★ or shape="poly"★ & coords★ or shape="default"

Descriptions for attributes specific to this element #

alt = normal character data: The fallback content for the image map.
href = URI: A URL that provides the destination of the hyperlink for this area.
target = browsing-context name or keyword: A name or keyword giving a browsing context for UAs to use when following the hyperlink for this area.
rel = tokens NEW: A list of tokens that specify the relationship between the document containing the area and the destination indicated by the area.
media = media-query list NEW: The media for which the destination of the hyperlink was designed.
hreflang = language tag NEW: The language of the destination of the hyperlink.
type = MIME type: The MIME type of the destination of the hyperlink.
shape = "rect" & coords = rectangle: Specifies that the shape of the area of this hyperlink on the image map is a rectangle.
shape = "circle" & coords = circle: Specifies that the shape of the area of this hyperlink on the image map is a circle.
shape = "poly" & coords = polygon: Specifies that the shape of the area of this hyperlink on the image map is a polygon.
shape = "default": Specifies that the shape of the area of this hyperlink on the image map is a rectangle that exactly covers the entire image.

Additional constraints and admonitions #

The area element must have an ancestor map element.
The nohref attribute on the area element is obsolete. Omitting the href attribute is sufficient.

Tag omission #

The area element is a void element. An area 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 HTMLAreaElement : HTMLElement {
           attribute DOMString alt;
           attribute DOMString coords;
           attribute DOMString shape;
  stringifier attribute DOMString href;
           attribute DOMString target;
           attribute DOMString rel;
  readonly attribute DOMTokenList relList;
           attribute DOMString media;
           attribute DOMString hreflang;
           attribute DOMString type;

  // URL decomposition IDL attributes
           attribute DOMString protocol;
           attribute DOMString host;
           attribute DOMString hostname;
           attribute DOMString port;
           attribute DOMString pathname;
           attribute DOMString search;
           attribute DOMString hash;
};

Typical default display properties #

area {

display: none; }

article – article ⓘ NEW # T

The article element represents a section of content that forms an independent part of a document or site; for example, a magazine or newspaper article, or a blog entry.

Permitted content #

zero or more style elements, followed by flow content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The sectioning element article must not appear as a descendant of the address element.

Tag omission #

An article element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain flow elements

DOM interface #

Uses HTMLElement.

Typical default display properties #

article {

display: block; }

aside – tangential content ⓘ NEW # T

The aside element represents content that is tangentially related to the content that forms the main textual flow of a document.

Permitted content #

zero or more style elements, followed by flow content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The sectioning element aside must not appear as a descendant of the address element.

Tag omission #

An aside element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain flow elements

Details #

In printed documents, the type of tangential content that the aside element represents is sometimes formatted as a sidebar or annotation or footnote.

DOM interface #

Uses HTMLElement.

Typical default display properties #

aside {

display: block; }

audio – audio stream ⓘ NEW # T

An audio element represents an audio stream.

Permitted content #

Transparent, with the following specific structure:

a src attribute, or zero or more source elements followed by flow content

a src attribute, or zero or more source elements followed by phrasing content

Permitted attributes #

common attributes & autoplay & preload & controls & loop & src

Descriptions for attributes specific to this element #

autoplay = "autoplay" or "" (empty string) or empty

Instructs the UA to automatically begin playback of the audio stream as soon as it can do so without stopping.

preload = "none" or "metadata" or "auto" or "" (empty string) or empty

Represents a hint to the UA about whether optimistic downloading of the audio stream itself or its metadata is considered worthwhile.

"none": Hints to the UA that the user is not expected to need the video, or that minimizing unnecessary traffic is desirable.
"metadata": Hints to the UA that the user is not expected to need the audio stream, but that fetching its metadata (duration and so on) is desirable.
"auto": Hints to the UA that optimistically downloading the entire audio stream is considered desirable.

Specifying the empty string is equivalent to specifying the value "auto".

controls = "controls" or "" (empty string) or empty

Instructs the UA to expose a user interface for controlling playback of the audio stream.

loop = "loop" or "" (empty string) or empty

Instructs the UA to seek back to the start of the audio stream upon reaching the end.

src = URI

The URL for the audio stream.

Additional constraints and admonitions #

The interactive element audio with the attribute controls must not appear as a descendant of the a element.
The interactive element audio with the attribute controls must not appear as a descendant of the button element.

Tag omission #

An audio element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain phrasing elements, any element that can contain flow elements

DOM interface #

[NamedConstructor=Audio(),
 NamedConstructor=Audio(in DOMString src)]
interface HTMLAudioElement : HTMLMediaElement {};

b – offset text typically styled in bold ⓘ CHANGED # T

The b element represents a span of text offset from its surrounding content without conveying any extra importance; for example, keywords in a document abstract, product names in a review, or other spans of text whose typical typographic presentation is bold text.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

Uses HTMLElement.

Typical default display properties #

b {

font-weight: bolder; }

base – base URL ⓘ # T

The base element specifies a document-wide base URL for the purposes of resolving relative URLs, and a document-wide default browsing context name for the purposes of following hyperlinks.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & href★ & target or target★

Descriptions for attributes specific to this element #

href = URI: The base URL for the document.
target = browsing-context name or keyword NEW: A browsing context name or keyword for use in following hyperlinks.

Tag omission #

The base element is a void element. A base element must have a start tag but must not have an end tag.

Permitted parent elements #

head

DOM interface #

interface HTMLBaseElement : HTMLElement {
           attribute DOMString href;
           attribute DOMString target;
};

bdo – BiDi override ⓘ # T

The bdo element provides a means to specify a direction override of the Unicode BiDi algorithm.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Additional constraints and admonitions #

A bdo element must have an dir attribute.

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

Uses HTMLElement.

blockquote – block quotation ⓘ # T

The blockquote element represents a section that is quoted from another source.

Permitted content #

flow content

Permitted attributes #

common attributes & cite

Descriptions for attributes specific to this element #

cite = URI: A URL referencing the original source for the quoted material.

Tag omission #

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

Permitted parent elements #

any element that can contain flow elements

DOM interface #

interface HTMLQuoteElement : HTMLElement {
           attribute DOMString cite;
};

Typical default display properties #

blockquote {

display: block;

margin: 1em 40px 1em 40px; }

body – document body ⓘ # T

The body element represents the body of a document (as opposed to the document’s metadata).

Permitted content #

flow content

Permitted attributes #

common attributes & onafterprint & onbeforeprint & onbeforeunload & onhashchange & onmessage & onoffline & ononline & onpopstate & onredo & onresize & onstorage & onundo & onunload

Descriptions for attributes specific to this element #

onafterprint = string
onbeforeprint = string
onbeforeunload = string
onhashchange = string
onmessage = string
onoffline = string
ononline = string
onpopstate = string
onredo = string
onresize = string
onstorage = string
onundo = string
onunload = string

Additional constraints and admonitions #

The alink attribute on the body element is obsolete. Use CSS instead.
The background attribute on the body element is obsolete. Use CSS instead.
The bgcolor attribute on the body element is obsolete. Use CSS instead.
The link attribute on the body element is obsolete. Use CSS instead.
The marginbottom attribute on the body element is obsolete. Use CSS instead.
The marginheight attribute on the body element is obsolete. Use CSS instead.
The marginleft attribute on the body element is obsolete. Use CSS instead.
The marginright attribute on the body element is obsolete. Use CSS instead.
The margintop attribute on the body element is obsolete. Use CSS instead.
The marginwidth attribute on the body element is obsolete. Use CSS instead.
The text attribute on the body element is obsolete. Use CSS instead.
The vlink attribute on the body element is obsolete. Use CSS instead.

Tag omission #

A body element’s start tag may be omitted if the first thing inside the body element is not a space character or a comment, except if the first thing inside the body element is a script or style element.

A body element’s end tag may be omitted if the body element is not immediately followed by a comment and the element is either not empty or its start tag has not been omitted.

Permitted parent elements #

html

DOM interface #

interface HTMLBodyElement : HTMLElement {
           attribute Function onafterprint;
           attribute Function onbeforeprint;
           attribute Function onbeforeunload;
           attribute Function onblur;
           attribute Function onerror;
           attribute Function onfocus;
           attribute Function onhashchange;
           attribute Function onload;
           attribute Function onmessage;
           attribute Function onoffline;
           attribute Function ononline;
           attribute Function onpopstate;
           attribute Function onpagehide;
           attribute Function onpageshow;
           attribute Function onredo;
           attribute Function onresize;
           attribute Function onstorage;
           attribute Function onundo;
           attribute Function onunload;
};

Typical default display properties #

body {

display: block;

margin: 8px; }

body:focus {

outline: none; }

br – line break ⓘ # T

The br element represents a line break.

Permitted content #

empty (void element)

Permitted attributes #

common attributes

Additional constraints and admonitions #

The clear attribute on the br element is obsolete. Use CSS instead.

Tag omission #

The br element is a void element. A br 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 HTMLBRElement : HTMLElement {};

button ⓘ # T

See the following sections:

button type=submit
button type=reset
button type=button

A button element with no type attribute specified represents the same thing as a button element with its type attribute set to "submit".

button type=submit – submit button # T

The button element with a type attribute whose value is "submit" represents a button for submitting a form.

Permitted content #

phrasing content

Permitted attributes #

common attributes & name & disabled & form & type & value & formaction & autofocus & formenctype & formmethod & formtarget & formnovalidate

Descriptions for attributes specific to this element #

type = "submit": Specifies that its button element is a button for submitting a form.
value = string: The value part of the name/value pair associated with this button for the purposes of form submission.

Additional constraints and admonitions #

The interactive element button must not appear as a descendant of the a element.
The interactive element button must not appear as a descendant of the button element.
Any button element descendant of a label element with a for attribute must have an ID value that matches that for attribute.

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

interface HTMLButtonElement : HTMLElement {
           attribute boolean autofocus;
           attribute boolean disabled;
  readonly attribute HTMLFormElement form;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute DOMString formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString name;
           attribute DOMString type;
           attribute DOMString value;

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

  readonly attribute NodeList labels;
};

button type=reset – reset button # T

The button element with a type attribute whose value is "reset" represents a button for resetting a form.

Permitted content #

phrasing content

Permitted attributes #

common attributes & name & disabled & form & type★ & value & autofocus

Descriptions for attributes specific to this element #

type = "reset": Specifies that its button element is a button for resetting a form.
value = string: The value part of the name/value pair associated with this button for the purposes of form submission.

Additional constraints and admonitions #

The interactive element button must not appear as a descendant of the a element.
The interactive element button must not appear as a descendant of the button element.
Any button element descendant of a label element with a for attribute must have an ID value that matches that for attribute.

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

interface HTMLButtonElement : HTMLElement {
           attribute boolean autofocus;
           attribute boolean disabled;
  readonly attribute HTMLFormElement form;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute DOMString formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString name;
           attribute DOMString type;
           attribute DOMString value;

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

  readonly attribute NodeList labels;
};

button type=button – button with no additional semantics # T

The button element with a type attribute whose value is "button" represents a button with no additional semantics.

Permitted content #

phrasing content

Permitted attributes #

common attributes & name & disabled & form & type★ & value & autofocus

Descriptions for attributes specific to this element #

type = "button": Specifies that its button element is a button with no additional semantics.
value = string: The value part of the name/value pair associated with this button for the purposes of form submission.

Additional constraints and admonitions #

The interactive element button must not appear as a descendant of the a element.
The interactive element button must not appear as a descendant of the button element.
Any button element descendant of a label element with a for attribute must have an ID value that matches that for attribute.

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

interface HTMLButtonElement : HTMLElement {
           attribute boolean autofocus;
           attribute boolean disabled;
  readonly attribute HTMLFormElement form;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute DOMString formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString name;
           attribute DOMString type;
           attribute DOMString value;

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

  readonly attribute NodeList labels;
};

canvas – canvas for dynamic graphics ⓘ NEW # T

The canvas element represents a resolution-dependent bitmap canvas, which can be used for dynamically rendering of images such as game graphics, graphs, or other images.

Permitted content #

transparent (either phrasing content or flow content)

Permitted attributes #

common attributes & height & width

Descriptions for attributes specific to this element #

height = non-negative integer: The height of the canvas, in CSS pixels.
width = non-negative integer: The width of the canvas, in CSS pixels.

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements, any element that can contain flow elements

DOM interface #

interface HTMLCanvasElement : HTMLElement {
           attribute unsigned long width;
           attribute unsigned long height;

  DOMString toDataURL(in optional DOMString type, in any... args);

  object getContext(in DOMString contextId);
};

caption – table title ⓘ # T

The caption element represents the title of the table that is its parent.

Permitted content #

flow content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The align attribute on the caption element is obsolete. Use CSS instead.

Tag omission #

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

Permitted parent elements #

table

DOM interface #

interface HTMLTableCaptionElement : HTMLElement {};

Typical default display properties #

caption {

display: table-caption;

text-align: center; }

cite – cited title of a work ⓘ CHANGED # T

The cite element represents the cited title of a work; for example, the title of a book mentioned within the main text flow of a document.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

Uses HTMLElement.

Typical default display properties #

cite {

font-style: italic; }

code – code fragment ⓘ # T

The code element represents a fragment of computer code.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

Uses HTMLElement.

Typical default display properties #

code {

font-family: monospace; }

col – table column ⓘ # T

The col element represents one or more columns in the column group represented by its colgroup parent.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & span

Descriptions for attributes specific to this element #

span = positive integer: Specifies the number of columns “spanned” by its col element; the col element shares its attributes with all the columns it spans.

Additional constraints and admonitions #

The align attribute on the col element is obsolete. Use CSS instead.
The width attribute on the col element is obsolete. Use CSS instead.
The char attribute on the col element is obsolete. Use CSS instead.
The charoff attribute on the col element is obsolete. Use CSS instead.
The valign attribute on the col element is obsolete. Use CSS instead.

Tag omission #

The col element is a void element. A col element must have a start tag but must not have an end tag.

Permitted parent elements #

colgroup

DOM interface #

interface HTMLTableColElement : HTMLElement {
           attribute unsigned long span;
};

Typical default display properties #

col {

display: table-column; }

colgroup – table column group ⓘ # T

The colgroup element represents a group of one or more columns in the table that is its parent.

Permitted content #

zero or more col elements, or an optional span attribute

Permitted attributes #

common attributes & span

Descriptions for attributes specific to this element #

span = positive integer: The number of columns in the group.

Additional constraints and admonitions #

The width attribute on the colgroup element is obsolete. Use CSS instead.
The char attribute on the colgroup element is obsolete. Use CSS instead.
The charoff attribute on the colgroup element is obsolete. Use CSS instead.
The valign attribute on the colgroup element is obsolete. Use CSS instead.

Tag omission #

A colgroup element's start tag may be omitted if the first thing inside the colgroup element is a col element, and if the element is not immediately preceded by another colgroup element whose end tag has been omitted.

A colgroup element’s end tag may be omitted if the colgroup element is not immediately followed by a space character or a comment.

Permitted parent elements #

table

DOM interface #

interface HTMLTableColElement : HTMLElement {
           attribute unsigned long span;
};

Typical default display properties #

colgroup {

display: table-column-group; }

command ⓘ NEW # T

See the following sections:

command type=command
command type=radio
command type=checkbox

A command element with no type attribute specified represents the same thing as a command element with its type attribute set to "command".

command type=command – command with an associated action NEW # T

The command element with a type attribute whose value is "command" represents a command with an associated action.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & type & label & icon & disabled

Descriptions for attributes specific to this element #

type = "command": Specifies that its command element is a command with an associated action.
label = string: The name of the command, as shown to the user.
icon = URI: A URL for an image that represents the command.
disabled = "disabled" or "" (empty string) or empty: Specifies that the command is not currently available.

Tag omission #

The command element is a void element. A command element must have a start tag but must not have an end tag.

Permitted parent elements #

any element that can contain metadata elements, any element that can contain phrasing elements

DOM interface #

interface HTMLCommandElement : HTMLElement {
           attribute DOMString type;
           attribute DOMString label;
           attribute DOMString icon;
           attribute boolean disabled;
           attribute boolean checked;
           attribute DOMString radiogroup;
};

command type=radio – selection of one item from a list of items NEW # T

The command element with a type attribute whose value is "radio" represents a selection of one item from a list of items.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & type★ & radiogroup★ & checked & label & icon & disabled

Descriptions for attributes specific to this element #

type = "radio": Specifies that its command element represents a selection of one item from a list of items.
radiogroup = string: The name of the group of commands that will be toggled when the command itself is toggled.
checked = "checked" or "" (empty string) or empty: Specifies that the command is selected.
label = string: The name of the command, as shown to the user.
icon = URI: A URL for an image that represents the command.
disabled = "disabled" or "" (empty string) or empty: Specifies that the command is not currently available.

Tag omission #

The command element is a void element. A command element must have a start tag but must not have an end tag.

Permitted parent elements #

any element that can contain metadata elements, any element that can contain phrasing elements

DOM interface #

interface HTMLCommandElement : HTMLElement {
           attribute DOMString type;
           attribute DOMString label;
           attribute DOMString icon;
           attribute boolean disabled;
           attribute boolean checked;
           attribute DOMString radiogroup;
};

command type=checkbox – state or option that can be toggled NEW # T

The command element with a type attribute whose value is "checkbox" represents a state or option that can be toggled.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & type★ & checked & label & icon & disabled

Descriptions for attributes specific to this element #

type = "checkbox": Specifies that its command element represents a state or option that can be toggled.
checked = "checked" or "" (empty string) or empty: Specifies that the command is selected.
label = string: The name of the command, as shown to the user.
icon = URI: A URL for an image that represents the command.
disabled = "disabled" or "" (empty string) or empty: Specifies that the command is not currently available.

Tag omission #

The command element is a void element. A command element must have a start tag but must not have an end tag.

Permitted parent elements #

any element that can contain metadata elements, any element that can contain phrasing elements

DOM interface #

interface HTMLCommandElement : HTMLElement {
           attribute DOMString type;
           attribute DOMString label;
           attribute DOMString icon;
           attribute boolean disabled;
           attribute boolean checked;
           attribute DOMString radiogroup;
};

datalist – predefined options for other controls ⓘ NEW # T

The datalist element represents a set of option elements that represent predefined options for other controls.

Permitted content #

zero or more option elements, intermixed with phrasing content

Permitted attributes #

common attributes

Tag omission #

A datalist 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 datalist element represent fallback content for legacy user agents, intermixed with option elements that represent the predefined options.

DOM interface #

interface HTMLDataListElement : HTMLElement {
  readonly attribute HTMLCollection options;
};

Typical default display properties #

datalist {

display: none; }

dd – description or value ⓘ # T

The dd element represents a description or value.

Permitted content #

flow content

Permitted attributes #

common attributes

Tag omission #

A dd element must have a start tag.

A dd element’s end tag may be omitted if the dd element is immediately followed by another dd element or a dt element, or if there is no more content in the parent element.

Permitted parent elements #

Details #

The dd element represents the description or value part of a term-description (name-value) grouping in a description list.

DOM interface #

Uses HTMLElement.

Typical default display properties #

dd {

display: block;

margin-start: 40px; }

del – deleted text ⓘ # T

The del element represents a range of text that has been deleted from a document.

Permitted content #

transparent (either phrasing content or flow content)

Permitted attributes #

common attributes & cite & datetime

Descriptions for attributes specific to this element #

cite = URI: The address of a document that explains why the text was deleted.
datetime = date-time: The time and date when the text was deleted.

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements, any element that can contain flow elements

DOM interface #

interface HTMLModElement : HTMLElement {
           attribute DOMString cite;
           attribute DOMString dateTime;
};

Typical default display properties #

del {

text-decoration: line-through; }

details – control for additional on-demand information ⓘ NEW # T

The details element represents a control from which the user can obtain additional information or controls on-demand.

Permitted content #

an optional summary element, followed by flow content

Permitted attributes #

common attributes & open

Descriptions for attributes specific to this element #

open = "open" or "" (empty string) or empty: Specifies that the contents of the details element should be shown to the user.

Additional constraints and admonitions #

The interactive element details must not appear as a descendant of the a element.
The interactive element details must not appear as a descendant of the button element.

Tag omission #

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

Permitted parent elements #

any element that can contain flow elements

DOM interface #

interface HTMLDetailsElement : HTMLElement {
           attribute boolean open;
};

dfn – defining instance ⓘ # T

The dfn element represents the defining instance of a term.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The dfn element must not contain any nested dfn elements.

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

Uses HTMLElement.

div – generic flow container ⓘ # T

The div element is a generic container for flow content that by itself does not represent anything.

Permitted content #

zero or more style elements, followed by flow content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The align attribute on the div element is obsolete. Use CSS instead.

Tag omission #

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

Permitted parent elements #

any element that can contain flow elements

Details #

The div can be used with attributes such as class, lang/xml:lang, and title to add additional semantics and structure to flow content.

DOM interface #

interface HTMLDivElement : HTMLElement {};

Typical default display properties #

div {

display: block; }

dl – description list ⓘ # T

The dl element represents a description list.

Permitted content #

zero or more of: one or more dt elements, followed by one or more dd elements

Permitted attributes #

common attributes

Additional constraints and admonitions #

The compact attribute on the dl element is obsolete. Use CSS instead.

Tag omission #

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

Permitted parent elements #

any element that can contain flow elements

Details #

The dl element represents a description list, which consists of zero or more term-description (name-value) groupings; each grouping associates one or more terms/names (the contents of dt elements) with one or more descriptions/values (the contents of dd elements).

DOM interface #

interface HTMLDListElement : HTMLElement {};

Typical default display properties #

dl {

display: block;

margin: 1em 0 1em 0; }

dt – term or name ⓘ # T

The dt element represents a term or name.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

A dt element must have a start tag.

A dt element’s end tag may be omitted if the dt element is immediately followed by another dt element or a dd element.

Permitted parent elements #

Details #

The dt element represents the term or name part of a term-description (name-value) grouping in a description list.

DOM interface #

Uses HTMLElement.

Typical default display properties #

dt {

display: block; }

em – emphatic stress ⓘ CHANGED # T

The em element represents a span of text with emphatic stress.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

An em element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

Uses HTMLElement.

Typical default display properties #

em {

font-style: italic; }

embed – integration point for plugins ⓘ NEW # T

The embed element represents an integration point for external content.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & src & type & height & width & Any other attribute that has no namespace

Descriptions for attributes specific to this element #

src = URI: The address of the content being embedded.
type = MIME type: The MIME type of the plugin to instantiate.
height = non-negative integer: The height of the embedded content, in CSS pixels.
width = non-negative integer: The width of the embedded content, in CSS pixels.

Additional constraints and admonitions #

The interactive element embed must not appear as a descendant of the a element.
The interactive element embed must not appear as a descendant of the button element.
The name attribute on the embed element is obsolete. Use the id attribute instead.
The align attribute on the embed element is obsolete. Use CSS instead.
The hspace attribute on the embed element is obsolete. Use CSS instead.
The vspace attribute on the embed element is obsolete. Use CSS instead.

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

Details #

The embed element represents an integration point for external content — typically, non-HTML content such as an application or some other type of interactive content which involves use of a third-party plugin as a handler (rather than being natively supported by the UA).

DOM interface #

interface HTMLEmbedElement : HTMLElement {
           attribute DOMString src;
           attribute DOMString type;
           attribute DOMString width;
           attribute DOMString height;
};

fieldset – set of related form controls ⓘ # T

The fieldset element represents a set of form controls grouped under a common name.

Permitted content #

an optional legend element, followed by flow content

Permitted attributes #

common attributes & name & disabled & form

Tag omission #

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

Permitted parent elements #

any element that can contain flow elements

DOM interface #

interface HTMLFieldSetElement : HTMLElement {
           attribute boolean disabled;
  readonly attribute HTMLFormElement form;
           attribute DOMString name;

  readonly attribute DOMString type;

  readonly attribute HTMLFormControlsCollection elements;

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

Typical default display properties #

fieldset {

display: block;

margin-left: 2px;

margin-right: 2px;

padding: 0.35em 0.75em 0.625em;

border: 2px groove (internal value); }

figcaption – figure caption ⓘ NEW # T

The figcaption element represents a caption or legend for a figure.

Permitted content #

flow content

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

figure

DOM interface #

Uses HTMLElement.

figure – figure with optional caption ⓘ NEW # T

The figure element represents a unit of content, optionally with a caption, that is self-contained, that is typically referenced as a single unit from the main flow of the document, and that can be moved away from the main flow of the document without affecting the document’s meaning.

Permitted content #

one figcaption element, followed by flow content or flow content followed by an optional figcaption element

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

any element that can contain flow elements

DOM interface #

Uses HTMLElement.

footer – footer ⓘ NEW # T

Permitted content #

Permitted parent elements #

any element that can contain flow elements

form – user-submittable form ⓘ # T

The form element represents a user-submittable form.

Permitted content #

flow content

Permitted attributes #

common attributes & action & method & enctype & name & accept-charset & novalidate & target & autocomplete

Descriptions for attributes specific to this element #

action = URI: The submission action for the form.
method = "get" or "post" or "put" or "delete": The HTTP method with which a UA is meant to associate this element for form submission.
enctype = "application/x-www-form-urlencoded" or "multipart/form-data" or "text/plain": A MIME type with which a UA is meant to associate the form contents for form submission.
accept-charset = character-encoding name list: Specifies the character encodings used for form submission.
novalidate = "novalidate" or "" (empty string) or empty NEW: Specifies that the element represents a form that is not meant to be validated during form submission.
target = browsing-context name or keyword: A browsing context or keyword that represents the target of the form.
autocomplete = "on" or "off" NEW: Specifies whether the element represents a form for which by default a UA is meant to store the values entered into its input elements by the user (so that the UA can pre-fill the form later).

Additional constraints and admonitions #

The form element must not contain any nested form elements.

Tag omission #

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

Permitted parent elements #

any element that can contain flow elements

DOM interface #

[OverrideBuiltins]
interface HTMLFormElement : HTMLElement {
           attribute DOMString acceptCharset;
           attribute DOMString action;
           attribute DOMString autocomplete;
           attribute DOMString enctype;
           attribute DOMString method;
           attribute DOMString name;
           attribute boolean noValidate;
           attribute DOMString target;

  readonly attribute HTMLFormControlsCollection elements;
  readonly attribute long length;
  caller getter any item(in unsigned long index);
  caller getter any namedItem(in DOMString name);

  void submit();
  void reset();
  boolean checkValidity();

  void dispatchFormInput();
  void dispatchFormChange();
};

Typical default display properties #

form {

display: block;

margin-top: 0em; }

h1 – heading ⓘ # T

The h1 through h6 elements are headings for the sections with which they are associated.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The h1 element must not appear as a descendant of the address element.
The align attribute on the h1 element is obsolete. Use CSS instead.

Tag omission #

An h1 element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain flow elements, hgroup

DOM interface #

interface HTMLHeadingElement : HTMLElement {};

Typical default display properties #

h1 {

display: block;

font-size: 2em;

margin: .67em 0 .67em 0;

font-weight: bold; }

h2 – heading ⓘ # T

The h1 through h6 elements are headings for the sections with which they are associated.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The h2 element must not appear as a descendant of the address element.
The align attribute on the h2 element is obsolete. Use CSS instead.

Tag omission #

An h2 element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain flow elements, hgroup

DOM interface #

interface HTMLHeadingElement : HTMLElement {};

Typical default display properties #

h2 {

display: block;

font-size: 1.5em;

margin: .83em 0 .83em 0;

font-weight: bold; }

h3 – heading ⓘ # T

The h1 through h6 elements are headings for the sections with which they are associated.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The h3 element must not appear as a descendant of the address element.
The align attribute on the h3 element is obsolete. Use CSS instead.

Tag omission #

An h3 element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain flow elements, hgroup

DOM interface #

interface HTMLHeadingElement : HTMLElement {};

Typical default display properties #

h3 {

display: block;

font-size: 1.17em;

margin: 1em 0 1em 0;

font-weight: bold; }

h4 – heading ⓘ # T

The h1 through h6 elements are headings for the sections with which they are associated.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The h4 element must not appear as a descendant of the address element.
The align attribute on the h4 element is obsolete. Use CSS instead.

Tag omission #

An h4 element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain flow elements, hgroup

DOM interface #

interface HTMLHeadingElement : HTMLElement {};

Typical default display properties #

h4 {

display: block;

margin: 1.33em 0 1.33em 0;

font-weight: bold; }

h5 – heading ⓘ # T

The h1 through h6 elements are headings for the sections with which they are associated.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The h5 element must not appear as a descendant of the address element.
The align attribute on the h5 element is obsolete. Use CSS instead.

Tag omission #

An h5 element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain flow elements, hgroup

DOM interface #

interface HTMLHeadingElement : HTMLElement {};

Typical default display properties #

h5 {

display: block;

font-size: .83em;

margin: 1.67em 0 1.67em 0;

font-weight: bold; }

h6 – heading ⓘ # T

The h1 through h6 elements are headings for the sections with which they are associated.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The h6 element must not appear as a descendant of the address element.
The align attribute on the h6 element is obsolete. Use CSS instead.

Tag omission #

An h6 element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain flow elements, hgroup

DOM interface #

interface HTMLHeadingElement : HTMLElement {};

Typical default display properties #

h6 {

display: block;

font-size: .67em;

margin: 2.33em 0 2.33em 0;

font-weight: bold; }

head – document metadata ⓘ # T

The head element collects the document’s metadata.

Permitted content #

one title element, intermixed with an optional base element, intermixed with metadata elements

Permitted attributes #

common attributes

Additional constraints and admonitions #

The profile attribute on the head element is obsolete. To declare which meta element terms are used in the document, instead register the names as meta extensions. To trigger specific UA behaviors, use a link element instead.

Tag omission #

A head element’s start tag may be omitted if the first thing inside the head element is an element.

A head element’s end tag may be omitted if the head element is not immediately followed by a space character or a comment.

Permitted parent elements #

html

DOM interface #

interface HTMLHeadElement : HTMLElement {};

Typical default display properties #

head {

display: none; }

header – header ⓘ NEW # T

The header element represents the header of a section.

Permitted content #

flow content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The header element must not appear as a descendant of the footer element.
The header element must not appear as a descendant of the address element.
The header element must not appear as a descendant of the header element.

Tag omission #

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

Permitted parent elements #

any element that can contain flow elements

Details #

The header element typically contains the headings for a section (an h1-h6 element or hgroup element), along with content such as introductory material or navigational aids for the section.

DOM interface #

Uses HTMLElement.

Typical default display properties #

header {

display: block; }

hgroup – heading group ⓘ NEW # T

The hgroup element represents a group of headings.

Permitted content #

one or more of: one h1 element, or one h2 element, or one h3 element, or one h4 element, or one h5 element, or one h6 element

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

any element that can contain flow elements

Details #

The hgroup element is typically used to group a set of one or more h1-h6 elements — to group, for example, a section title and an accompanying subtitle.

DOM interface #

Uses HTMLElement.

Typical default display properties #

hgroup {

display: block; }

hr – thematic break ⓘ CHANGED # T

The hr element represents a paragraph-level thematic break.

Permitted content #

empty (void element)

Permitted attributes #

common attributes

Additional constraints and admonitions #

The align attribute on the hr element is obsolete. Use CSS instead.
The width attribute on the hr element is obsolete. Use CSS instead.
The noshade attribute on the hr element is obsolete. Use CSS instead.
The size attribute on the hr element is obsolete. Use CSS instead.
The color attribute on the hr element is obsolete. Use CSS instead.

Tag omission #

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

Permitted parent elements #

any element that can contain flow elements

Details #

Some examples of thematic breaks that can be marked up using the hr element include a scene change in a story, or a transition to another topic within a section of a reference book.

DOM interface #

interface HTMLHRElement : HTMLElement {};

Typical default display properties #

hr {

display: block;

margin: 0.5em auto;

border-style: inset;

border-width: 1px; }

html – root element ⓘ # T

The html element represents the root of a document.

Permitted content #

one head element, followed by one body element

Permitted attributes #

common attributes & manifest

Descriptions for attributes specific to this element #

manifest = URI NEW: The address of the document’s application cache manifest (which controls caching of content for offline use).

Additional constraints and admonitions #

The version attribute on the html element is obsolete. You can safely omit it.

Tag omission #

An html element’s start tag may be omitted if the first thing inside the html element is not a comment.

An html element’s end tag may be omitted if the html element is not immediately followed by a comment and the element contains a body element that is either not empty or whose start tag has not been omitted.

DOM interface #

interface HTMLHtmlElement : HTMLElement {};

Typical default display properties #

html {

display: block; }

html:focus {

outline: none; }

i – offset text typically styled in italic ⓘ # T

The i element represents a span of text in an alternate voice or mood, or otherwise offset from the normal prose (content whose typical typographic presentation is italicized).

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

An i element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain phrasing elements

Details #

Some examples of spans that might use the i element include a taxonomic designation, a technical term, an idiomatic phrase from another language, a thought, a ship name, or some other prose whose typical typographic presentation is italicized.

DOM interface #

Uses HTMLElement.

Typical default display properties #

i {

font-style: italic; }

iframe – nested browsing context (inline frame) ⓘ # T

The iframe element introduces a new nested browsing context.

Permitted content #

normal character data

Permitted attributes #

common attributes & src & name & width & height & sandbox & seamless

Descriptions for attributes specific to this element #

src = URI: The address of a page that the nested browsing context is to contain.
name = browsing-context name: A valid browsing context name.
width = non-negative integer: The width of the iframe, in CSS pixels.
height = non-negative integer: The height of the iframe, in CSS pixels.
sandbox = sandbox allow list NEW: Instructs the UA to enable a set of extra restrictions on any content hosted by the iframe.
seamless = "seamless" or "" (empty string) or empty NEW: Instructs the UA that the iframe element's browsing context is to be rendered in a manner that makes it appear to be part of the containing document (seamlessly included in the parent document).

Additional constraints and admonitions #

The interactive element iframe must not appear as a descendant of the a element.
The interactive element iframe must not appear as a descendant of the button element.
The longdesc attribute on the iframe element is obsolete. Use a regular a element to link to the description.
The align attribute on the iframe element is obsolete. Use CSS instead.
The allowtransparency attribute on the iframe element is obsolete. Use CSS instead.
The frameborder attribute on the iframe element is obsolete. Use CSS instead.
The marginheight attribute on the iframe element is obsolete. Use CSS instead.
The marginwidth attribute on the iframe element is obsolete. Use CSS instead.
The scrolling attribute on the iframe element is obsolete. Use CSS instead.

Tag omission #

An iframe element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

interface HTMLIFrameElement : HTMLElement {
           attribute DOMString src;
           attribute DOMString srcdoc;
           attribute DOMString name;
  [PutForwards=value] readonly attribute DOMSettableTokenList sandbox;
           attribute boolean seamless;
           attribute DOMString width;
           attribute DOMString height;
  readonly attribute Document contentDocument;
  readonly attribute WindowProxy contentWindow;
};

Typical default display properties #

iframe {

border: 2px inset; }

img – image ⓘ # T

The img element represents an image.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & src★ & alt & height & width & usemap & ismap & border

Descriptions for attributes specific to this element #

src = URI: A URL referencing a non-interactive, optionally animated, image that is neither paged nor scripted.
alt = normal character data: The fallback content for the image.
height = non-negative integer: The height of the image, in CSS pixels.
width = non-negative integer: The width of the image, in CSS pixels.
usemap = hash-name reference: A hash-name reference to a map element with which to associate the image.
ismap = "ismap" or "" (empty string) or empty: Specifies that its img element provides access to a server-side image map.
border = zero OBSOLETE: Specifies that its img element represents a borderless image.; The border attribute on the img element is obsolete. Consider specifying “img { border: 0; }“ in CSS instead.

Additional constraints and admonitions #

The element img with the attribute usemap must not appear as a descendant of the a element.
The element img with the attribute usemap must not appear as a descendant of the button element.
The img element with the ismap attribute set must have an ancestor a element with the href attribute.
The longdesc attribute on the img element is obsolete. Use a regular a element to link to the description.
The name attribute on the img element is obsolete. Use the id attribute instead.
The align attribute on the img element is obsolete. Use CSS instead.
The hspace attribute on the img element is obsolete. Use CSS instead.
The vspace attribute on the img element is obsolete. Use CSS instead.
The border attribute on the img element is obsolete. Use CSS instead.

Tag omission #

The img element is a void element. An img 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 #

[NamedConstructor=Image(),
 NamedConstructor=Image(in unsigned long width),
 NamedConstructor=Image(in unsigned long width, in unsigned long height)]
interface HTMLImageElement : HTMLElement {
           attribute DOMString alt;
           attribute DOMString src;
           attribute DOMString useMap;
           attribute boolean isMap;
           attribute unsigned long width;
           attribute unsigned long height;
  readonly attribute unsigned long naturalWidth;
  readonly attribute unsigned long naturalHeight;
  readonly attribute boolean complete;
};

input ⓘ # T

See the following sections:

input type=text
input type=password
input type=checkbox
input type=radio
input type=button
input type=submit
input type=reset
input type=file
input type=hidden
input type=image
input type=datetime
input type=datetime-local
input type=date
input type=month
input type=time
input type=week
input type=number
input type=range
input type=email
input type=url
input type=search
input type=tel
input type=color

An input element with no type attribute specified represents the same thing as a input element with its type attribute set to "text".

input type=text – text-input field # T

The input element with a type attribute whose value is "text" represents a one-line plain text edit control for the input element’s value.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type & maxlength & readonly & size & value & autocomplete & autofocus & list & pattern & required & placeholder

Descriptions for attributes specific to this element #

type = "text": Specifies that its input element is a one-line plain-text edit control for the input element’s value.
value = string: Specifies a value for this input element.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=password – password-input field # T

The input element with a type attribute whose value is "password" represents a one-line plain-text edit control for entering a password.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & maxlength & readonly & size & value & autocomplete & autofocus & pattern & required & placeholder

Descriptions for attributes specific to this element #

type = "password": Specifies that its input element is a one-line plain-text edit control for entering a password.
value = string: Specifies a value for this input element.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=checkbox – checkbox # T

The input element with a type attribute whose value is "checkbox" represents a state or option that can be toggled.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & checked & value & autofocus & required

Descriptions for attributes specific to this element #

type = "checkbox": Specifies that its input element represents a state or option that can be toggled.
value = string: Specifies a value for the input element.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=radio – radio button # T

The input element with a type attribute whose value is "radio" represents a selection of one item from a list of items (a radio button).

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & checked & value & autofocus & required

Descriptions for attributes specific to this element #

type = "radio": Specifies that its input element represents a selection of one item from a list of items.
value = string: Specifies a value for the input element.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=button – button # T

The input element with a type attribute whose value is "button" represents a button with no additional semantics.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & value & autofocus

Descriptions for attributes specific to this element #

type = "button": Specifies that its input element is a button with no additional semantics.
value = string: Specifies a value for the input element.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=submit – submit button # T

The input element with a type attribute whose value is "submit" represents a button for submitting a form.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & value & formaction & autofocus & formenctype & formmethod & formtarget & formnovalidate

Descriptions for attributes specific to this element #

type = "submit": Specifies that its input element is a button for submitting a form.
value = string: Specifies a value for the input element.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=reset – reset button # T

The input element with a type attribute whose value is "reset" represents a button for resetting a form.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & value & autofocus

Descriptions for attributes specific to this element #

type = "reset": Specifies that its input element is a button for resetting a form.
value = string: Specifies a value for the input element.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=file – file upload control # T

The input element with a type attribute whose value is "file" represents a list of file items, each consisting of a file name, a file type, and a file body (the contents of the file).

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & accept & autofocus & required & multiple

Descriptions for attributes specific to this element #

type = "file": Specifies that its input element represents a list of file items.
accept = mime-type list: Provides the UA with a hint of what file types the server is able to accept.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=hidden – hidden input control # T

The input element with a type attribute whose value is "hidden" represents a value that is not intended to be examined or manipulated by the user.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & value

Descriptions for attributes specific to this element #

type = "hidden": Specifies that its input element represents a value that is not intended to be examined or manipulated by the user.
value = string: Specifies a value for the input element.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=image – image-coordinates input control # T

The input element with a type attribute whose value is "image" represents either an image from which the UA enables a user to interactively select a pair of coordinates and submit the form, or alternatively a button from which the user can submit the form.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & alt★ & src & formaction & autofocus & formenctype & formmethod & formtarget & formnovalidate & height & width

Descriptions for attributes specific to this element #

type = "image": Specifies that its input element represents either an image from which the UA enables a user to interactively select a pair of coordinates and submit the form, or alternatively a button from which the user can submit the form.
alt = string: Provides a textual label for an alternative button for users and UAs who cannot use the image specified by the src attribute.
src = URI: Specifies the location of an image.
height = non-negative integer: The height of the image, in CSS pixels.
width = non-negative integer: The width of the image, in CSS pixels.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=datetime – global date-and-time input control NEW # T

The input element with a type attribute whose value is "datetime" represents a control for setting the element’s value to a string representing a global date and time (with timezone information).

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & autocomplete & autofocus & list & min & max & step (float) & readonly & required & value

Descriptions for attributes specific to this element #

type = "datetime": Specifies that its input element is a control for setting the element’s value to a string representing a global date and time.
min = date-time NEW: The expected lower bound for the element’s value.
max = date-time NEW: The expected upper bound for the element’s value.
value = date-time: A string representing a global date and time.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=datetime-local – local date-and-time input control NEW # T

The input element with a type attribute whose value is "datetime-local" represents a control for setting the element’s value to a string representing a local date and time (with no timezone information).

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & autocomplete & autofocus & list & min & max & step (float) & readonly & required & value

Descriptions for attributes specific to this element #

type = "datetime-local": Specifies that its input element is a control for setting the element’s value to a string representing a local date and time.
min = local date-time NEW: The expected lower bound for the element’s value.
max = local date-time NEW: The expected upper bound for the element’s value.
value = local date-time: A string representing a local date and time.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=date – date input control NEW # T

The input element with a type attribute whose value is "date" represents a control for setting the element’s value to a string representing a date.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & autocomplete & autofocus & list & min & max & step (integer) & readonly & required & value

Descriptions for attributes specific to this element #

type = "date": Specifies that its input element is a control for setting the element’s value to a string representing a date.
min = date NEW: The expected lower bound for the element’s value.
max = date NEW: The expected upper bound for the element’s value.
value = date: A string representing a date.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=month – year-and-month input control NEW # T

The input element with a type attribute whose value is "month" represents a control for setting the element’s value to a string representing a month.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & autocomplete & autofocus & list & min & max & step (integer) & readonly & required & value

Descriptions for attributes specific to this element #

type = "month": Specifies that its input element is a control for setting the element’s value to a string representing a month.
min = month NEW: The expected lower bound for the element’s value.
max = month NEW: The expected upper bound for the element’s value.
value = month: A string representing a month.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=time – time input control NEW # T

The input element with a type attribute whose value is "time" represents a control for setting the element’s value to a string representing a time (with no timezone information).

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & autocomplete & autofocus & list & min & max & step (float) & readonly & required & value

Descriptions for attributes specific to this element #

type = "time": Specifies that its input element is a control for setting the element’s value to a string representing a time.
min = time NEW: The expected lower bound for the element’s value.
max = time NEW: The expected upper bound for the element’s value.
value = time: A string representing a time (with no timezone information).

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=week – year-and-week input control NEW # T

The input element with a type attribute whose value is "week" represents a control for setting the element’s value to a string representing a week.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & autocomplete & autofocus & list & min & max & step (integer) & readonly & required & value

Descriptions for attributes specific to this element #

type = "week": Specifies that its input element is a control for setting the element’s value to a string representing a week.
min = week NEW: The expected lower bound for the element’s value.
max = week NEW: The expected upper bound for the element’s value.
value = week: A string representing a week.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=number – number input control NEW # T

The input element with a type attribute whose value is "number" represents a precise control for setting the element’s value to a string representing a number.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & autocomplete & autofocus & list & min & max & step (float) & readonly & required & value

Descriptions for attributes specific to this element #

type = "number": Specifies that its input element is a precise control for setting the element’s value to a string representing a number.
min = float NEW: The expected lower bound for the element’s value.
max = float NEW: The expected upper bound for the element’s value.
value = float: A string representing a number.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=range – imprecise number-input control NEW # T

The input element with a type attribute whose value is "range" represents an imprecise control for setting the element’s value to a string representing a number.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & autocomplete & autofocus & list & min & max & step (float) & value

Descriptions for attributes specific to this element #

type = "range": Specifies that its input element is an imprecise control for setting the element’s value to a string representing a number.
min = float NEW: The expected lower bound for the element’s value.
max = float NEW: The expected upper bound for the element’s value.
value = float: A string representing a number.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=email – e-mail address input control NEW # T

The input element with a type attribute whose value is "email" represents a control for editing a list of e-mail addresses given in the element’s value.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & autocomplete & autofocus & list & maxlength & pattern & readonly & required & size & placeholder & multiple★ & value (multiple addresses) or value (single address)

Descriptions for attributes specific to this element #

type = "email": Specifies that its input element is a control for editing a list of e-mail addresses given in the element’s value.
value = e-mail address list: A list of e-mail addresses.
value = e-mail address: A single e-mail address.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=url – URL input control NEW # T

The input element with a type attribute whose value is "url" represents a control for editing an absolute URL given in the element’s value.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & autocomplete & autofocus & list & maxlength & pattern & readonly & required & size & placeholder & value

Descriptions for attributes specific to this element #

type = "url": Specifies that its input element is a control for editing an absolute URL given in the element’s value.
value = "" or absolute URI: An absolute URL.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=search – search field NEW # T

The input element with a type attribute whose value is "search" represents a one-line plain-text edit control for entering one or more search terms.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & autocomplete & autofocus & list & maxlength & pattern & readonly & required & size & placeholder & value

Descriptions for attributes specific to this element #

type = "search": Specifies that its input element is a one-line plain-text edit control for entering one or more search terms.
value = string: Specifies a value for this input element.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=tel – telephone-number-input field NEW # T

The input element with a type attribute whose value is "tel" represents a one-line plain-text edit control for entering a telephone number.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & autocomplete & autofocus & list & maxlength & pattern & readonly & required & size & placeholder & value

Descriptions for attributes specific to this element #

type = "tel": Specifies that its input element is a one-line plain-text edit control for entering a telephone number.
value = string: Specifies a value for this input element.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

input type=color – color-well control NEW # T

The input element with a type attribute whose value is "color" represents a color-well control, for setting the element’s value to a string representing a simple color.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name & disabled & form & type★ & autocomplete & autofocus & list & value

Descriptions for attributes specific to this element #

type = "color": Specifies that its input element is a color-well control, for setting the element’s value to a string representing a simple color.
value = color: An string representing a simple color.

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.
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.

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 boolean disabled;
  readonly attribute HTMLFormElement form;
  readonly attribute  files;
           attribute DOMString formAction;
           attribute DOMString formEnctype;
           attribute DOMString formMethod;
           attribute boolean formNoValidate;
           attribute DOMString formTarget;
           attribute DOMString 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  valueAsDate;
           attribute double valueAsNumber;
  readonly attribute HTMLOptionElement selectedOption;
           attribute DOMString width;

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

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

  readonly attribute NodeList labels;

  void select();
           attribute unsigned long selectionStart;
           attribute unsigned long selectionEnd;
  void setSelectionRange(in unsigned long start, in unsigned long end);
};

ins – inserted text ⓘ # T

The ins element represents a range of text that has been inserted (added) to a document.

Permitted content #

transparent (either phrasing content or flow content)

Permitted attributes #

common attributes & cite & datetime

Descriptions for attributes specific to this element #

cite = URI: The address of a document that explains why the text was added.
datetime = date-time: The time and date when the text was added.

Tag omission #

An ins element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain phrasing elements, any element that can contain flow elements

DOM interface #

interface HTMLModElement : HTMLElement {
           attribute DOMString cite;
           attribute DOMString dateTime;
};

Typical default display properties #

ins {

text-decoration: underline; }

kbd – user input ⓘ # T

The kbd element represents user input.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

Details #

The kbd element typically represents keyboard input, though it may also represent other input, such as voice commands.

DOM interface #

Uses HTMLElement.

Typical default display properties #

kbd {

font-family: monospace; }

keygen – key-pair generator/input control ⓘ NEW # T

The keygen element represents a control for generating a public-private key pair and for submitting the public key from that key pair.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & challenge & keytype & autofocus & name & disabled & form

Descriptions for attributes specific to this element #

challenge = string: A challenge string that is submitted along with the public key.
keytype = "rsa": The type of key generated.

Additional constraints and admonitions #

The interactive element keygen must not appear as a descendant of the a element.
The interactive element keygen must not appear as a descendant of the button element.
Any keygen element descendant of a label element with a for attribute must have an ID value that matches that for attribute.

Tag omission #

The keygen element is a void element. A keygen 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 HTMLKeygenElement : HTMLElement {
           attribute boolean autofocus;
           attribute DOMString challenge;
           attribute boolean disabled;
  readonly attribute HTMLFormElement form;
           attribute DOMString keytype;
           attribute DOMString name;

  readonly attribute DOMString type;

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

  readonly attribute NodeList labels;
};

label – caption for a form control ⓘ # T

The label element represents a caption for a form control.

Permitted content #

phrasing content

Permitted attributes #

common attributes & for & form

Descriptions for attributes specific to this element #

for = IDREF: Identifies a form control for which the label is a caption.

Additional constraints and admonitions #

The label element must not contain any nested label elements.
The label element may contain at most one descendant input element, button element, select element, or textarea element.
The for attribute of the “label” element must refer to a form control.
The interactive element label must not appear as a descendant of the a element.
The interactive element label must not appear as a descendant of the button element.

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

interface HTMLLabelElement : HTMLElement {
  readonly attribute HTMLFormElement form;
           attribute DOMString htmlFor;
  readonly attribute HTMLElement control;
};

Typical default display properties #

label {

cursor: default; }

legend – title or explanatory caption ⓘ # T

The legend element represents a title or explanatory caption for the rest of the contents of the legend element’s parent element.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

fieldset

DOM interface #

interface HTMLLegendElement : HTMLElement {
  readonly attribute HTMLFormElement form;
};

Typical default display properties #

legend {

display: block;

padding-left: 2px;

padding-right: 2px;

border: none; }

li – list item ⓘ # T

The li element represents a list item.

Permitted content #

flow content

Permitted attributes #

common attributes & value

Descriptions for attributes specific to this element #

value = integer CHANGED: The ordinal value of the list item. Permitted only if the li element is a child of an ol element.; The value attribute on the li element was deprecated in a previous version of HTML, but is no longer deprecated, as it has meaning and is not simply presentational.

Additional constraints and admonitions #

The type attribute on the li element is obsolete. Use CSS instead.

Tag omission #

An li element must have a start tag.

An li element’s end tag may be omitted if the li element is immediately followed by another li element or if there is no more content in the parent element.

Permitted parent elements #

ul, ol, menu

DOM interface #

interface HTMLLIElement : HTMLElement {
           attribute long value;
};

Typical default display properties #

li {

display: list-item; }

link – inter-document relationship metadata ⓘ # T

The link element represents metadata that expresses inter-document relationships.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & href★ & rel★ & hreflang & media & type & sizes

Descriptions for attributes specific to this element #

href = URI: A URL that provides the destination of the link.
rel = tokens: A list of tokens that specify the relationship between the document containing the link and the destination indicated by the link.
hreflang = language tag: The language of the destination of the link.
media = media-query list: The media for which the destination of the link was designed.
type = MIME type: The MIME type of the destination of the link.
sizes = "any" or sizes NEW: The sizes of icons for visual media.

Additional constraints and admonitions #

The target attribute on the link element is obsolete. You can safely omit it.
The urn attribute on the link element is obsolete. Specify the preferred persistent identifier using the href attribute instead.
The charset attribute on the link element is obsolete. Use an HTTP Content-Type header on the linked resource instead.
The methods attribute on the link element is obsolete. Use the HTTP OPTIONS feature instead.
The rev attribute on the link element is obsolete. Use the rel attribute instead, with a term having the opposite meaning.

Tag omission #

The link element is a void element. A link element must have a start tag but must not have an end tag.

Permitted parent elements #

any element that can contain metadata elements, noscript

DOM interface #

interface HTMLLIElement : HTMLElement {
           attribute long value;
};

Typical default display properties #

link {

display: none; }

map – image-map definition ⓘ # T

The map element, in conjunction with any area element descendants, defines an image map.

Permitted content #

transparent (either phrasing content or flow content)

Permitted attributes #

common attributes & name★

Descriptions for attributes specific to this element #

name = name: A name by which the map can be referenced.

Additional constraints and admonitions #

The id attribute on a map element must have an the same value as the name attribute.

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements, any element that can contain flow elements

DOM interface #

interface HTMLMapElement : HTMLElement {
           attribute DOMString name;
  readonly attribute HTMLCollection areas;
  readonly attribute HTMLCollection images;
};

Typical default display properties #

map {

display: inline; }

mark – marked (highlighted) text ⓘ NEW # T

The mark element represents a run of text in one document marked or highlighted for reference purposes, due to its relevance in another context.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

Uses HTMLElement.

menu – list of commands ⓘ CHANGED # T

Descriptions for attributes specific to this element #

type = "toolbar" or "context" NEW

The kind of menu being declared.

"toolbar": Indicates that the element represents a tool bar.
"context": Indicates that the element represents a context menu.
If the attribute is omitted, the element represents a list of commands that is neither a context menu nor a tool bar.

label = string NEW

The label of the menu.

DOM interface #

interface HTMLMenuElement : HTMLElement {
           attribute DOMString type;
           attribute DOMString label;
};

meta ⓘ # T

The meta element is defined in the following sections:

meta name
meta http-equiv=refresh
meta http-equiv=default-style
meta charset
meta http-equiv=content-type

meta name – name-value metadata # T

The meta element with a name attribute represents document metadata in the form of name/value pairs.

Permitted content #

empty (void element)

Permitted attributes #

core attributes & event-handler attributes & xml attributes & name★ & content★

Descriptions for attributes specific to this element #

name = string: Specifies the name part of a name/value pair.
content = string: Specifies the value part of a name/value pair.

Tag omission #

The meta element is a void element. A meta element must have a start tag but must not have an end tag.

Permitted parent elements #

any element that can contain metadata elements

DOM interface #

interface HTMLMetaElement : HTMLElement {
           attribute DOMString name;
           attribute DOMString httpEquiv;
           attribute DOMString content;
};

meta http-equiv=refresh – “refresh” pragma directive # T

The meta element with a http-equiv attribute whose value is "refresh" represents a pragma directive that specifies either a number of seconds after which to reload the current page, or a number of seconds after which to load a different page in place of the current page, and the URL for the replacement page.

Permitted content #

empty (void element)

Permitted attributes #

core attributes & event-handler attributes & xml attributes & http-equiv="refresh"★ & content★

Descriptions for attributes specific to this element #

http-equiv = "refresh"

Indicates that the meta element is a pragma directive that specifies either a number of seconds after which to reload the current page, or a number of seconds after which to load a different page in place of the current page, and the URL for the replacement page.

content = refresh value

Specifies one of the following:

the number of seconds after which to reload the current page
the number of seconds after which to load a different page in place of the current page, and the URL for the replacement page

Tag omission #

The meta element is a void element. A meta element must have a start tag but must not have an end tag.

Permitted parent elements #

any element that can contain metadata elements, noscript

DOM interface #

interface HTMLMetaElement : HTMLElement {
           attribute DOMString name;
           attribute DOMString httpEquiv;
           attribute DOMString content;
};

meta http-equiv=default-style – “preferred stylesheet” pragma directive # T

The meta element with a http-equiv attribute whose value is "default-style" represents a pragma directive that specifies the document’s preferred stylesheet.

Permitted content #

empty (void element)

Permitted attributes #

core attributes & event-handler attributes & xml attributes & http-equiv="default-style"★ & content★

Descriptions for attributes specific to this element #

http-equiv = "default-style"

Indicates that the meta element is a pragma directive that specifies the document’s preferred stylesheet.

content = default-style name

Specifies the name of the document’s preferred stylesheet. The name must meet either of the following sets of constraints:

The name must match the value of the title attribute on a link element in the same document, and that link element must have an href attribute that references the location of a CSS stylesheet.
The name must match the value of the title attribute on a style element in the same document, and the contents of that element must be a CSS stylesheet.

Tag omission #

The meta element is a void element. A meta element must have a start tag but must not have an end tag.

Permitted parent elements #

any element that can contain metadata elements, noscript

DOM interface #

interface HTMLMetaElement : HTMLElement {
           attribute DOMString name;
           attribute DOMString httpEquiv;
           attribute DOMString content;
};

meta http-equiv=content-language – “default language” pragma directive OBSOLETE # T

The meta element with a http-equiv attribute whose value is "content-language" represents a pragma directive that specifies a document-wide default language.

Warning: Using the meta element to specify the document-wide default language is obsolete. Consider specifying the language on the root element instead.

Permitted content #

empty (void element)

Permitted attributes #

core attributes & event-handler attributes & xml attributes & http-equiv="content-language"★ & content★

Descriptions for attributes specific to this element #

http-equiv = "content-language": Indicates that the meta element is a pragma directive that specifies a document-wide default language.
content = language tag: Specifies a language to use as the document-wide default language.

Additional constraints and admonitions #

The scheme attribute on the meta element is obsolete. Use only one scheme per field, or make the scheme declaration part of the value.

Tag omission #

The meta element is a void element. A meta element must have a start tag but must not have an end tag.

Permitted parent elements #

any element that can contain metadata elements

DOM interface #

interface HTMLMetaElement : HTMLElement {
           attribute DOMString name;
           attribute DOMString httpEquiv;
           attribute DOMString content;
};

meta charset – document character-encoding declaration NEW # T

The meta element with a charset attribute represents a character encoding declaration.

Permitted content #

empty (void element)

Permitted attributes #

core attributes & event-handler attributes & xml attributes & charset★

Descriptions for attributes specific to this element #

charset = character encoding name NEW: Specifies a character encoding name.

Additional constraints and admonitions #

There must not be more than one meta element per document with a charset attribute.
If a document contains a meta element with a charset attribute, then the document must not contain a meta element in the encoding declaration state.
The scheme attribute on the meta element is obsolete. Use only one scheme per field, or make the scheme declaration part of the value.

Tag omission #

The meta element is a void element. A meta element must have a start tag but must not have an end tag.

Permitted parent elements #

any element that can contain metadata elements

DOM interface #

interface HTMLMetaElement : HTMLElement {
           attribute DOMString name;
           attribute DOMString httpEquiv;
           attribute DOMString content;
};

meta http-equiv=content-type – document character-encoding declaration # T

A meta element with a http-equiv attribute whose value is "content-type" and which has an accompanying content attribute and value represents a character encoding declaration.

Permitted content #

empty (void element)

Permitted attributes #

core attributes & event-handler attributes & xml attributes & http-equiv="content-type"★ & content★

Descriptions for attributes specific to this element #

http-equiv = "content-type": Indicates that the meta element is in the encoding declaration state and represents a character encoding declaration.
content = meta-charset string: A specially formatted string providing a character encoding name.

Additional constraints and admonitions #

A meta element in the encoding declaration state may be used in a document in the HTML syntax, but it must not be used in a document in the XML syntax.
There must not be more than one meta element in the encoding declaration state per document.
If a document contains a meta element in the encoding declaration state, then the document must not contain a meta element with a charset attribute.
The scheme attribute on the meta element is obsolete. Use only one scheme per field, or make the scheme declaration part of the value.

Tag omission #

The meta element is a void element. A meta element must have a start tag but must not have an end tag.

Permitted parent elements #

any element that can contain metadata elements

Details #

A meta element with a http-equiv attribute whose value is "content-type" and which has an accompanying content attribute and value is said to be in the encoding declaration state.

DOM interface #

interface HTMLMetaElement : HTMLElement {
           attribute DOMString name;
           attribute DOMString httpEquiv;
           attribute DOMString content;
};

meter – scalar gauge ⓘ NEW # T

The meter element represents a scalar gauge providing a measurement within a known range, or a fractional value.

Permitted content #

phrasing content

Permitted attributes #

common attributes & value★ & min & low & high & max & optimum

Descriptions for attributes specific to this element #

value = float: The “measured” value shown by meter.
min = float: The lower bound of the range for the meter.
low = float: The point that marks the upper boundary of the “low” segment of the meter.
high = float: The point that marks the lower boundary of the “high” segment of the meter.
max = float: The upper bound of the range for the meter.
optimum = float: The point that marks the “optimum” position for the meter.

Additional constraints and admonitions #

The element meter must not appear as a descendant of the meter element.
The value of the min attribute must be less than or equal to the value of the value attribute.
The value of the value attribute must be greater than or equal to zero when the min attribute is absent.
The value of the value attribute must be less than or equal to the value of the max attribute.
The value of the value attribute must be less than or equal to one when the max attribute is absent.
The value of the min attribute must be less than or equal to the value of the max attribute.
The value of the max attribute must be greater than or equal to zero when the min attribute is absent.
The value of the min attribute must be less than or equal to one when the max attribute is absent.
The value of the min attribute must be less than or equal to the value of the low attribute.
The value of the low attribute must be greater than or equal to zero when the min attribute is absent.
The value of the min attribute must be less than or equal to the value of the high attribute.
The value of the high attribute must be greater than or equal to zero when the min attribute is absent.
The value of the low attribute must be less than or equal to the value of the high attribute.
The value of the high attribute must be less than or equal to the value of the max attribute.
The value of the high attribute must be less than or equal to one when the max attribute is absent.
The value of the low attribute must be less than or equal to the value of the max attribute.
The value of the low attribute must be less than or equal to one when the max attribute is absent.
The value of the min attribute must be less than or equal to the value of the optimum attribute.
The value of the optimum attribute must be greater than or equal to zero when the min attribute is absent.
The value of the optimum attribute must be less than or equal to the value of the max attribute.
The value of the optimum attribute must be less than or equal to one when the max attribute is absent.

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

interface HTMLMeterElement : HTMLElement {
           attribute float value;
           attribute float min;
           attribute float max;
           attribute float low;
           attribute float high;
           attribute float optimum;
  readonly attribute HTMLFormElement form;
  readonly attribute NodeList labels;
};

Typical default display properties #

meter {

display: inline-block;

height: 1em;

width: 5em;

vertical-align: -0.2em; }

nav – group of navigational links ⓘ NEW # T

The nav element represents a section of a document that links to other documents or to parts within the document itself; that is, a section of navigation links.

Permitted content #

flow content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The sectioning element nav must not appear as a descendant of the address element.

Tag omission #

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

Permitted parent elements #

any element that can contain flow elements

DOM interface #

Uses HTMLElement.

Typical default display properties #

nav {

display: block; }

noscript – fallback content for script ⓘ # T

The noscript element is used to present different markup to user agents that don’t support scripting, by affecting how the document is parsed.

Permitted content #

zero or more of: one link element, or one meta http-equiv=default-style element, or one meta http-equiv=refresh element, or one style element

transparent (either phrasing content or flow content)

Permitted attributes #

common attributes

Additional constraints and admonitions #

The noscript element must not be used in a document in the XML syntax.
The noscript element must not contain any nested noscript elements.

Tag omission #

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

Permitted parent elements #

any element that can contain metadata elements, any element that can contain phrasing elements, any element that can contain flow elements

DOM interface #

Uses HTMLElement.

object – generic external content ⓘ # T

The object element represents external content.

Permitted content #

Transparent, with the following specific structure:

zero or more param elements, followed by flow content

zero or more param elements, followed by phrasing content

Permitted attributes #

common attributes & data★ & type or type★ & height & width & usemap & name & form

Descriptions for attributes specific to this element #

data = URI: The address of the content.
type = MIME type: The MIME type of the content.
height = non-negative integer: The height of the object, in CSS pixels.
width = non-negative integer: The width of the object, in CSS pixels.
usemap = hash-name reference: A hash-name reference to a map element with which to associate the object.
name = browsing-context name: A valid browsing context name.

Additional constraints and admonitions #

The element object with the attribute usemap must not appear as a descendant of the a element.
The element object with the attribute usemap must not appear as a descendant of the button element.
The archive attribute on the object element is obsolete. Use the data attribute and type attribute to invoke plugins. To set a parameter with the name “archive”, use the param element.
The classid attribute on the object element is obsolete. Use the data attribute and type attribute to invoke plugins. To set a parameter with the name “classid”, use the param element.
The code attribute on the object element is obsolete. Use the data attribute and type attribute to invoke plugins. To set a parameter with the name “code”, use the param element.
The codebase attribute on the object element is obsolete. Use the data attribute and type attribute to invoke plugins. To set a parameter with the name “codebase”, use the param element.
The codetype attribute on the object element is obsolete. Use the data attribute and type attribute to invoke plugins. To set a parameter with the name “codetype”, use the param element.
The declare attribute on the object element is obsolete. Repeat the object element completely each time the resource is to be reused.
The standby attribute on the object element is obsolete. Optimize the linked resource so that it loads quickly or, at least, incrementally.
The align attribute on the object element is obsolete. Use CSS instead.
The hspace attribute on the object element is obsolete. Use CSS instead.
The vspace attribute on the object element is obsolete. Use CSS instead.
The border attribute on the object element is obsolete. Use CSS instead.

Tag omission #

An object element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain phrasing elements, any element that can contain flow elements

Details #

The object element represents external content, which, depending on the type of the content, will either be treated as an image, as a nested browsing context, or as external content to be processed by a plugin.

DOM interface #

interface HTMLObjectElement : HTMLElement {
           attribute DOMString data;
           attribute DOMString type;
           attribute DOMString name;
           attribute DOMString useMap;
  readonly attribute HTMLFormElement form;
           attribute DOMString width;
           attribute DOMString height;
  readonly attribute Document contentDocument;
  readonly attribute WindowProxy contentWindow;

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

ol – ordered list ⓘ # T

The ol element represents a list (or sequence) of items; that is, a list in which the items are intentionally ordered, such that changing the order would change the meaning of the list.

Permitted content #

zero or more li elements

Permitted attributes #

common attributes & start & reversed

Descriptions for attributes specific to this element #

start = integer CHANGED: The ordinal value of the first list item.; The start attribute on the li element was deprecated in a previous version of HTML, but is no longer deprecated, as it has meaning and is not simply presentational.
reversed = "reversed" or "" (empty string) or empty NEW: If present, indicates that the list is a descending list (…, 3, 2, 1).; If not present, indicates that the list is an ascending list (1, 2, 3, …).

Additional constraints and admonitions #

The type attribute on the ol element is obsolete. Use CSS instead.
The compact attribute on the ol element is obsolete. Use CSS instead.

Tag omission #

An ol element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain flow elements

DOM interface #

interface HTMLOListElement : HTMLElement {
           attribute boolean reversed;
           attribute long start;
};

Typical default display properties #

ol {

display: block;

list-style-type: decimal;

margin: 1em 0 1em 0;

padding-start: 40px; }

optgroup – group of options ⓘ # T

The optgroup element represents a group of option elements with a common label.

Permitted content #

zero or more option elements

Permitted attributes #

common attributes & label★ & disabled

Descriptions for attributes specific to this element #

label = string: Specifies the name of the group of options its optgroup element represents.

Tag omission #

An optgroup element must have a start tag.

An optgroup element’s end tag may be omitted if the optgroup element is immediately followed by another optgroup element, or if there is no more content in the parent element.

Permitted parent elements #

select

DOM interface #

interface HTMLOptGroupElement : HTMLElement {
           attribute boolean disabled;
           attribute DOMString label;
};

option – option ⓘ # T

The option element represents an option in a select control, or an option in a labelled set of options grouped together in an optgroup, or an option among the list of suggestions in a datalist.

Permitted content #

normal character data

Permitted attributes #

common attributes & disabled & selected & label & value

Descriptions for attributes specific to this element #

selected = "selected" or "" (empty string) or empty: Specifies that this option is pre-selected.
label = string: Specifies a label for the option.
value = string: Specifies a value for the option.

Additional constraints and admonitions #

The name attribute on the option element is obsolete. Use the id attribute instead.

Tag omission #

An option element must have a start tag.

An option element’s end tag may be omitted if the option element is immediately followed by another option element, or if it is immediately followed by an optgroup element, or if there is no more content in the parent element.

Permitted parent elements #

optgroup, select, datalist

DOM interface #

[NamedConstructor=Option(),
 NamedConstructor=Option(in DOMString text),
 NamedConstructor=Option(in DOMString text, in DOMString value),
 NamedConstructor=Option(in DOMString text, in DOMString value, in boolean defaultSelected),
 NamedConstructor=Option(in DOMString text, in DOMString value, in boolean defaultSelected, in boolean selected)]
interface HTMLOptionElement : HTMLElement {
           attribute boolean disabled;
  readonly attribute HTMLFormElement form;
           attribute DOMString label;
           attribute boolean defaultSelected;
           attribute boolean selected;
           attribute DOMString value;

           attribute DOMString text;
  readonly attribute long index;
};

output – result of a calculation in a form ⓘ NEW # T

The output element represents the result of a calculation.

Permitted content #

phrasing content

Permitted attributes #

common attributes & name & form & for

Descriptions for attributes specific to this element #

for = IDREFS: Identifies one or more elements associated with the calculation whose result this output element represents.

Tag omission #

An output element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

interface HTMLOutputElement : HTMLElement {
  [PutForwards=value] readonly attribute DOMSettableTokenList ;
  readonly attribute HTMLFormElement form;
           attribute DOMString name;

  readonly attribute DOMString type;
           attribute DOMString defaultValue;
           attribute DOMString value;

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

  readonly attribute NodeList labels;
};

p – paragraph ⓘ # T

The p element represents a paragraph.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The align attribute on the p element is obsolete. Use CSS instead.

Tag omission #

A p element must have a start tag.

A p element’s end tag may be omitted if the p element is immediately followed by an address, article, aside, blockquote, dir, div, dl, fieldset, footer, form, h1, h2, h3, h4, h5, h6, header, hr, menu, nav, ol, p, pre, section, table, or ul element, or if there is no more content in the parent element and the parent element is not an a element.

Permitted parent elements #

any element that can contain flow elements

DOM interface #

interface HTMLParagraphElement : HTMLElement {};

Typical default display properties #

p {

display: block;

margin: 1.0em 0px; }

param – initialization parameters for plugins ⓘ # T

The param element defines parameters for plugins invoked by object elements.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & name★ & value★

Descriptions for attributes specific to this element #

name = string: The name of the parameter.
value = string: The value of the parameter.

Additional constraints and admonitions #

The type attribute on the param element is obsolete. Use the name attribute and value attribute without declaring value types.
The valuetype attribute on the param element is obsolete. Use the name attribute and value attribute without declaring value types.

Tag omission #

The param element is a void element. A param element must have a start tag but must not have an end tag.

Permitted parent elements #

object

DOM interface #

interface HTMLParamElement : HTMLElement {
           attribute DOMString name;
           attribute DOMString value;
};

Typical default display properties #

param {

display: none; }

pre – preformatted text ⓘ # T

The pre element represents a block of preformatted text, in which structure is represented by typographic conventions rather than by elements.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The width attribute on the pre element is obsolete. Use CSS instead.

Tag omission #

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

Permitted parent elements #

any element that can contain flow elements

DOM interface #

interface HTMLPreElement : HTMLElement {};

Typical default display properties #

pre {

display: block;

font-family: monospace;

white-space: pre;

margin: 1em 0; }

progress – progress indicator ⓘ NEW # T

The progress element represents the completion progress of a task.

Permitted content #

phrasing content

Permitted attributes #

common attributes & value & max

Descriptions for attributes specific to this element #

value = non-negative float: Specifies how much of the task has been completed. The units are arbitrary and not specified.
max = positive float: Specifies how much work the task requires in total. The units are arbitrary and not specified.

Additional constraints and admonitions #

The element progress must not appear as a descendant of the progress element.
The value of the value attribute must be less than or equal to the value of the max attribute.
The value of the value attribute must be less than or equal to one when the max attribute is absent.

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

interface HTMLProgressElement : HTMLElement {
           attribute float value;
           attribute float max;
  readonly attribute float position;
  readonly attribute HTMLFormElement form;
  readonly attribute NodeList labels;
};

Typical default display properties #

progress {

display: inline-block;

height: 1em;

width: 10em;

vertical-align: -0.2em; }

q – quoted text ⓘ # T

The q element represents phrasing content quoted from another source.

Permitted content #

phrasing content

Permitted attributes #

common attributes & cite

Descriptions for attributes specific to this element #

cite = URI: Specifies the address of the source of the quoted text.

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

Uses HTMLElement.

Typical default display properties #

q {

display: inline; }

q:before {

content: '"'; }

q:after {

content: '"'; }

rp – ruby parenthesis ⓘ NEW # T

The rp element can be used to provide parentheses around a ruby text component of a ruby annotation, to be shown by UAs that don’t support ruby annotations.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

An rp element must have a start tag.

An rp element’s end tag may be omitted if the rp element is immediately followed by an rt or rp element, or if there is no more content in the parent element.

Permitted parent elements #

ruby

DOM interface #

Uses HTMLElement.

rt – ruby text ⓘ NEW # T

The rt element marks the ruby text component of a ruby annotation.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

An rt element must have a start tag.

An rt element’s end tag may be omitted if the rt element is immediately followed by an rt or rp element, or if there is no more content in the parent element.

Permitted parent elements #

ruby

DOM interface #

Uses HTMLElement.

Typical default display properties #

rt {

text-indent: 0;

line-height: normal; }

ruby – ruby annotation ⓘ NEW # T

The ruby element allows spans of phrasing content to be marked with ruby annotations.

Permitted content #

one or more of: phrasing content followed by one rt element, or one rp element, followed by one rt element, followed by one rp element

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

Uses HTMLElement.

Typical default display properties #

ruby {

text-indent: 0;

line-height: normal; }

samp – (sample) output ⓘ # T

The samp element represents (sample) output from a program or computing system.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

Uses HTMLElement.

Typical default display properties #

samp {

font-family: monospace; }

script – embedded script ⓘ # T

The script element enables dynamic script and data blocks to be included in documents.

Permitted content #

non-replaceable character data

Permitted attributes #

common attributes & type & language

common attributes & src★ & defer & async & type & charset & language

Descriptions for attributes specific to this element #

type = MIME type: The language of the script or format of the data.; The language attribute on the script element is obsolete. You can safely omit it.
language = string OBSOLETE: Specifies that the language of the script is JavaScript.
src = URI: The address of the external script to use.
defer = "defer" or "" (empty string) or empty: Specifies that script should be executed after the document has been parsed.
async = "async" or "" (empty string) or empty NEW: Specifies that the script should be executed asynchronously, as soon as it becomes available.
charset = character encoding name: The character encoding of the external script.

Additional constraints and admonitions #

A script element must not contain an occurrence of the character sequence "".
A script element with a “src” attribute must contain only:
- lines that consist solely of a newline, optionally preceded by one or more space (U+0020) characters or tab (U+0009) characters
- single-line comments, which are lines beginning with the character sequence "//", optionally preceded by one more more space (U+0020) characters or tab (U+0009) characters, followed by any number of characters that are not a newline, and ending with a newline
- multi-lines comments, which begin with the character sequence "/*", optionally preceded by one more more space (U+0020) characters or tab (U+0009) characters, and that end with the character sequence "*/"
A script element with a language attribute whose value is “JavaScript” must not have a type attribute whose value is not “text/javascript”.
The language attribute on the script element is obsolete. Use the type attribute instead.

Tag omission #

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

Permitted parent elements #

any element that can contain metadata elements, any element that can contain phrasing elements

DOM interface #

interface HTMLScriptElement : HTMLElement {
           attribute DOMString src;
           attribute boolean async;
           attribute boolean defer;
           attribute DOMString type;
           attribute DOMString charset;
           attribute DOMString text;
};

Typical default display properties #

script {

display: none; }

section – section ⓘ NEW # T

The section element represents a section of a document, typically with a title or heading.

Permitted content #

zero or more style elements, followed by flow content

Permitted attributes #

common attributes

Additional constraints and admonitions #

The sectioning element section must not appear as a descendant of the address element.

Tag omission #

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

Permitted parent elements #

any element that can contain flow elements

DOM interface #

Uses HTMLElement.

Typical default display properties #

section {

display: block; }

select – option-selection form control ⓘ # T

The select element represents a control for selecting among a list of options.

Permitted content #

zero or more optgroup elements, intermixed with zero or more option elements

Permitted attributes #

common attributes & name & disabled & form & size & multiple

Descriptions for attributes specific to this element #

size = positive integer: The number of options to show to the user.
multiple = "multiple" or "" (empty string) or empty: If present, indicates that its select element represents a control for selecting zero or more options from a list of options.; If not present, indicates that its select element represents a control for selecting a single option from a list of options.

Additional constraints and admonitions #

The interactive element select must not appear as a descendant of the a element.
The interactive element select must not appear as a descendant of the button element.
Any select element descendant of a label element with a for attribute must have an ID value that matches that for attribute.
The select element cannot have more than one selected option element descendant unless the multiple attribute is specified.

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

interface HTMLSelectElement : HTMLElement {
           attribute boolean autofocus;
           attribute boolean disabled;
  readonly attribute HTMLFormElement form;
           attribute boolean multiple;
           attribute DOMString name;
           attribute unsigned long size;

  readonly attribute DOMString type;

  readonly attribute HTMLOptionsCollection options;
           attribute unsigned long length;
  caller getter any item(in unsigned long index);
  caller getter any namedItem(in DOMString name);
  void add(in HTMLElement element, in optional HTMLElement before);
  void add(in HTMLElement element, in long before);
  void remove(in long index);

  readonly attribute HTMLCollection selectedOptions;
           attribute long selectedIndex;
           attribute DOMString value;

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

  readonly attribute NodeList labels;
};

small – small print ⓘ CHANGED # T

The small element represents so-called “small print” such as legal disclaimers and caveats.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

Uses HTMLElement.

Typical default display properties #

small {

font-size: smaller; }

source – media source ⓘ NEW # T

The source element enables multiple media sources to be specified for audio and video elements.

Permitted content #

empty (void element)

Permitted attributes #

common attributes & src★ & type & media

Descriptions for attributes specific to this element #

src = URI: The address of the media source.
type = MIME type: The type of the media source (used for helping the UA determine, before fetching this media source, if it can play it).
media = media-query list: The intended media type of the media source (used for helping the UA determine, before fetching this media source, if it is useful to the user).

Tag omission #

The source element is a void element. A source element must have a start tag but must not have an end tag.

Permitted parent elements #

audio, video

Details #

Each separate media source specified within a source element is a complete set of media data — for example, a complete video file, or a complete audio file).

DOM interface #

interface HTMLSourceElement : HTMLElement {
           attribute DOMString src;
           attribute DOMString type;
           attribute DOMString media;
};

span – generic span ⓘ # T

The span element is a generic wrapper for phrasing content that by itself does not represent anything.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

Details #

The span element is a can be used with attributes such as class, lang/xml:lang, and title to add additional semantics and structure to phrasing content.

DOM interface #

interface HTMLSpanElement : HTMLElement {};

strong – strong importance ⓘ CHANGED # T

The strong element represents a span of text with strong importance.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

Uses HTMLElement.

Typical default display properties #

strong {

font-weight: bolder; }

style – style (presentation) information ⓘ # T

The style element allows style information to be embedded in documents.

Permitted content #

non-replaceable character data

Permitted attributes #

common attributes & type & media

common attributes & type & media & scoped★

Descriptions for attributes specific to this element #

type = MIME type: A valid MIME type that designates a styling language.
media = media-query list: Specifies which media the styles apply to.
scoped = "scoped" or "" (empty string) or empty NEW: Indicates that the specified style information is meant to apply only to the style element’s parent element, and that element’s child nodes. Otherwise, the specified styles are meant to apply to the entire document.

Additional constraints and admonitions #

A style element must not contain an occurrence of the character sequence "".

Tag omission #

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

Permitted parent elements #

any element that can contain metadata elements, div, noscript, section, article, aside

DOM interface #

interface HTMLStyleElement : HTMLElement {
           attribute boolean disabled;
           attribute DOMString media;
           attribute DOMString type;
           attribute boolean scoped;
};
HTMLStyleElement implements ;

Typical default display properties #

style {

display: none; }

sub – subscript ⓘ # T

The sub element represents subscript.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

Uses HTMLElement.

Typical default display properties #

sub {

vertical-align: sub;

font-size: smaller; }

summary – summary, caption, or legend for a details control ⓘ NEW # T

The summary element represents a summary, caption, or legend for a details element.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

details

DOM interface #

Uses HTMLElement.

sup – superscript ⓘ # T

The sup element represents superscript.

Permitted content #

phrasing content

Permitted attributes #

common attributes

Tag omission #

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

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

Uses HTMLElement.

HTML: The Markup Language

W3C Working Draft 24 June 2010

Abstract

Status of this Document

Instability and incompleteness of this document

Table of Contents

Full Table of Contents #

1. Introduction # T

2. Terminology # T

3. Documents # T

3.01. The HTML language and HTML and XML syntaxes # T

3.02. The HTML namespace and MIME types # T

3.03. Conformant documents # T

3.04. Case insensitivity in tag names and attribute names # T

4. HTML syntax # T

4.01. The doctype # T

4.02. Character encoding declaration # T

4.03. Elements # T

4.3.01. Misnested tags #

4.04. Attributes # T

4.05. Text and character data # T

4.06. Character references # T

4.07. Comments # T

4.08. SVG and MathML elements in HTML documents # T

4.09. CDATA sections in SVG and MathML contents # T

5. HTML elements # T

a – hyperlink ⓘ # T

Permitted content #

Permitted attributes #

Descriptions for attributes specific to this element #

Additional constraints and admonitions #

Tag omission #

Permitted parent elements #

Details #

DOM interface #

Typical default display properties #

abbr – abbreviation ⓘ # T

Permitted content #

Permitted attributes #

Tag omission #

Permitted parent elements #

Details #

DOM interface #

address – contact information ⓘ # T

Permitted content #

Permitted attributes #

Additional constraints and admonitions #

Tag omission #

Permitted parent elements #

Details #

DOM interface #

Typical default display properties #

area – image-map hyperlink ⓘ # T

Permitted content #

Permitted attributes #

Descriptions for attributes specific to this element #

Additional constraints and admonitions #

Tag omission #

Permitted parent elements #

DOM interface #

Typical default display properties #

article – article ⓘ NEW # T

Permitted content #

Permitted attributes #

Additional constraints and admonitions #

Tag omission #

Permitted parent elements #

DOM interface #

Typical default display properties #

aside – tangential content ⓘ NEW # T

Permitted content #

Permitted attributes #

Additional constraints and admonitions #

Tag omission #

Permitted parent elements #

Details #

DOM interface #

Typical default display properties #

audio – audio stream ⓘ NEW # T

Permitted content #