| CARVIEW |
HTML5: Edition for Web Authors
W3C Working Group Note 28 May 2013
- This Version:
- https://www.w3.org/TR/2013/NOTE-html5-author-20130528/
- Latest Published Version:
- https://www.w3.org/TR/html5-author/
- Latest Editor's Draft:
- https://dev.w3.org/html5/spec-author-view/
- Previous Versions:
- https://www.w3.org/TR/2012/WD-html5-author-20121025/
- https://www.w3.org/TR/2012/WD-html5-author-20120329/
- https://www.w3.org/TR/2011/WD-html5-author-20110809/
- Editors:
- Robin Berjon, W3C
- Travis Leithead, Microsoft
- Silvia Pfeiffer
- Erika Doyle Navara, Microsoft
- Theresa O'Connor, Apple Inc.
- Previous Editor:
- Ian Hickson, Google, Inc.
Copyright © 2013 W3C® (MIT, ERCIM, Keio, Beihang), All Rights Reserved. W3C liability, trademark and document use rules apply.
Abstract
This document has been discontinued and is only made available for historical purposes. The HTML specification includes a style switcher that will hide implementer-oriented content.
This document is a strict subset of the full HTML5 specification that omits user-agent (UA) implementation details. It is targeted toward Web authors and others who are not UA implementors and who want a view of the HTML specification that focuses more precisely on details relevant to using the HTML language to create Web documents and Web applications. Because this document does not provide implementation conformance criteria, UA implementors should not rely on it, but should instead refer to the full HTML5 specification.
This document is an automated redaction of the full HTML5 specification. As such, the two documents are supposed to agree on normative matters concerning Web authors. However, if the documents disagree, this is a bug in the redaction process and the unredacted full HTML specification takes precedence. Readers are encouraged to report such discrepancies as bugs in the bug tracking system of the HTML Working Group.
Status of This document
This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/.
If you wish to make comments regarding this document in a manner that is tracked by the W3C, please submit them via using our public bug database. If you cannot do this then you can also e-mail feedback to public-html-comments@w3.org (subscribe, archives), and arrangements will be made to transpose the comments to our public bug database. All feedback is welcome.
The bulk of the text of this specification is also available in the WHATWG Web Applications 1.0 specification, under a license that permits reuse of the specification text.
The working groups maintains a list of all bug reports that the editors have not yet tried to address and a list of issues for which the chairs have not yet declared a decision. These bugs and issues apply to multiple HTML-related specifications, not just this one.
Implementors should be aware that this specification is not stable. Implementors who are not taking part in the discussions are likely to find the specification changing out from under them in incompatible ways. Vendors interested in implementing this specification before it eventually reaches the Candidate Recommendation stage should join the aforementioned mailing lists and take part in the discussions.
Publication as a Working Group Note does not imply endorsement by the W3C Membership. This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.
The latest stable version of the editor's draft of this specification is always available on the W3C CVS server. There are various ways to follow the change history for this specification:
- Browsable version-control record of all changes:
- Github repository (real-time updates): https://github.com/w3c/html/commits/master
- CVSWeb interface (hourly updates): https://dev.w3.org/cvsweb/html5/spec/
- E-mail notifications of changes:
- HTML-Commits mailing list (commit notifications for dev.w3.org/html5): https://lists.w3.org/Archives/Public/public-html-commits/latest
The W3C HTML Working Group is the W3C working group responsible for this specification's progress along the W3C Recommendation track.
Work on this specification is also done at the WHATWG. The W3C HTML working group actively pursues convergence with the WHATWG, as required by the W3C HTML working group charter. There are various ways to follow this work at the WHATWG:
- Commit-Watchers mailing list (complete source diffs): https://lists.whatwg.org/listinfo.cgi/commit-watchers-whatwg.org
- Annotated summary with unified diffs: https://html5.org/tools/web-apps-tracker
- Raw Subversion interface:
svn checkout https://svn.whatwg.org/webapps/
This document was produced by a group operating under the 5 February 2004 W3C Patent Policy. W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.
Table of Contents
- 1 Introduction
- 2 Common
infrastructure
- 2.1 Terminology
- 2.2 Conformance requirements
- 2.3 Case-sensitivity and string comparison
- 2.4 Common microsyntaxes
- 2.5 URLs
- 2.6 Common DOM interfaces
- 2.7 Namespaces
- 3 Semantics,
structure, and APIs of HTML documents
- 3.1 Documents
- 3.2 Elements
- 3.2.1 Semantics
- 3.2.2 Elements in the DOM
- 3.2.3 Global
attributes
- 3.2.3.1 The
idattribute - 3.2.3.2 The
titleattribute - 3.2.3.3 The
langandxml:langattributes - 3.2.3.4 The
translateattribute - 3.2.3.5 The
xml:baseattribute (XML only) - 3.2.3.6 The
dirattribute - 3.2.3.7
The
classattribute - 3.2.3.8
The
styleattribute -
3.2.3.9 Embedding custom non-visible
data with the
data-*attributes
- 3.2.3.1 The
- 3.2.4 Element definitions
- 3.2.5 Content models
- 3.2.6 Requirements relating to bidirectional-algorithm formatting characters
- 3.2.7 WAI-ARIA
- 3.3 Dynamic markup insertion
- 4 The elements
of HTML
- 4.1 The root element
- 4.2 Document metadata
- 4.3 Scripting
- 4.4 Sections
- 4.5 Grouping content
- 4.6
Text-level semantics
- 4.6.1 The
aelement - 4.6.2 The
emelement - 4.6.3 The
strongelement - 4.6.4 The
smallelement - 4.6.5 The
selement - 4.6.6 The
citeelement - 4.6.7 The
qelement - 4.6.8 The
dfnelement - 4.6.9 The
abbrelement - 4.6.10 The
timeelement - 4.6.11 The
codeelement - 4.6.12 The
varelement - 4.6.13 The
sampelement - 4.6.14 The
kbdelement - 4.6.15 The
subandsupelements - 4.6.16 The
ielement - 4.6.17 The
belement - 4.6.18 The
uelement - 4.6.19 The
markelement - 4.6.20 The
rubyelement - 4.6.21 The
rtelement - 4.6.22 The
rpelement - 4.6.23 The
bdielement - 4.6.24 The
bdoelement - 4.6.25 The
spanelement - 4.6.26 The
brelement - 4.6.27 The
wbrelement - 4.6.28 Usage summary
- 4.6.1 The
- 4.7 Edits
- 4.8
Embedded content
- 4.8.1 The
imgelement- 4.8.1.1 Requirements
for providing text to act as an alternative for images
- 4.8.1.1.1 General guidelines
- 4.8.1.1.2 A link or button containing nothing but the image
- 4.8.1.1.3 A phrase or paragraph with an alternative graphical representation: charts, diagrams, graphs, maps, illustrations
- 4.8.1.1.4 A short phrase or label with an alternative graphical representation: icons, logos
- 4.8.1.1.5 Text that has been rendered to a graphic for typographical effect
- 4.8.1.1.6 A graphical representation of some of the surrounding text
- 4.8.1.1.7 A purely decorative image that doesn't add any information
- 4.8.1.1.8 A group of images that form a single larger picture with no links
- 4.8.1.1.9 A group of images that form a single larger picture with links
- 4.8.1.1.10 A key part of the content
- 4.8.1.1.11 An image not intended for the user
- 4.8.1.1 Requirements
for providing text to act as an alternative for images
- 4.8.2 The
iframeelement - 4.8.3 The
embedelement - 4.8.4 The
objectelement - 4.8.5 The
paramelement - 4.8.6
The
videoelement - 4.8.7
The
audioelement - 4.8.8 The
sourceelement - 4.8.9 The
trackelement - 4.8.10
Media elements
- 4.8.10.1 Error codes
- 4.8.10.2 Location of the media resource
- 4.8.10.3 MIME types
- 4.8.10.4 Network states
- 4.8.10.5 Loading the media resource
- 4.8.10.6 Offsets into the media resource
- 4.8.10.7 Ready states
- 4.8.10.8 Playing the media resource
- 4.8.10.9 Seeking
- 4.8.10.10 Media resources with multiple media tracks
- 4.8.10.11 Synchronising multiple media elements
- 4.8.10.12 Timed text tracks
- 4.8.10.13 User interface
- 4.8.10.14 Time ranges
- 4.8.10.15 Event definitions
- 4.8.10.16 Event summary
- 4.8.10.17 Best practices for authors using media elements
- 4.8.11
The
canvaselement - 4.8.12 The
mapelement - 4.8.13 The
areaelement - 4.8.14 Image maps
- 4.8.15 MathML
- 4.8.16 SVG
- 4.8.17 Dimension attributes
- 4.8.1 The
- 4.9 Tabular data
- 4.10 Forms
- 4.10.1 Introduction
- 4.10.2 Categories
- 4.10.3 The
formelement - 4.10.4 The
fieldsetelement - 4.10.5 The
legendelement - 4.10.6 The
labelelement - 4.10.7 The
inputelement- 4.10.7.1 States of the
typeattribute- 4.10.7.1.1 Hidden state (
type=hidden) -
4.10.7.1.2 Text (
type=text) state and Search state (type=search) - 4.10.7.1.3 Telephone state (
type=tel) - 4.10.7.1.4 URL state (
type=url) - 4.10.7.1.5 E-mail state (
type=email) - 4.10.7.1.6 Password state (
type=password) - 4.10.7.1.7 Date and Time state (
type=datetime) - 4.10.7.1.8 Date state (
type=date) - 4.10.7.1.9 Month state (
type=month) - 4.10.7.1.10 Week state (
type=week) - 4.10.7.1.11 Time state (
type=time) -
4.10.7.1.12 Local Date and Time state (
type=datetime-local) - 4.10.7.1.13 Number state (
type=number) - 4.10.7.1.14 Range state (
type=range) - 4.10.7.1.15 Color state (
type=color) - 4.10.7.1.16 Checkbox state (
type=checkbox) - 4.10.7.1.17 Radio Button state (
type=radio) - 4.10.7.1.18 File Upload state (
type=file) - 4.10.7.1.19 Submit Button state (
type=submit) - 4.10.7.1.20 Image Button state (
type=image) - 4.10.7.1.21 Reset Button state (
type=reset) - 4.10.7.1.22 Button state (
type=button)
- 4.10.7.1.1 Hidden state (
- 4.10.7.2 Common
inputelement attributes- 4.10.7.2.1 The
autocompleteattribute - 4.10.7.2.2 The
dirnameattribute - 4.10.7.2.3 The
listattribute - 4.10.7.2.4 The
readonlyattribute - 4.10.7.2.5 The
sizeattribute - 4.10.7.2.6 The
requiredattribute - 4.10.7.2.7 The
multipleattribute - 4.10.7.2.8 The
maxlengthattribute - 4.10.7.2.9 The
patternattribute - 4.10.7.2.10 The
minandmaxattributes - 4.10.7.2.11 The
stepattribute - 4.10.7.2.12 The
placeholderattribute
- 4.10.7.2.1 The
- 4.10.7.3 Common
inputelement APIs
- 4.10.7.1 States of the
- 4.10.8 The
buttonelement - 4.10.9 The
selectelement - 4.10.10
The
datalistelement - 4.10.11
The
optgroupelement - 4.10.12 The
optionelement - 4.10.13
The
textareaelement - 4.10.14 The
keygenelement - 4.10.15 The
outputelement - 4.10.16
The
progresselement - 4.10.17 The
meterelement - 4.10.18 Association of controls and forms
- 4.10.19 Attributes common to form controls
- 4.10.20 APIs for the text field selections
- 4.10.21 Constraints
- 4.10.22 Form submission
- 4.11 Interactive elements
- 4.12 Links
- 4.12.1 Introduction
- 4.12.2 Links created by
aandareaelements - 4.12.3 Downloading resources
- 4.12.4 Link
types
- 4.12.4.1
Link type "
alternate" - 4.12.4.2
Link type "
author" - 4.12.4.3
Link type "
bookmark" - 4.12.4.4 Link
type "
help" - 4.12.4.5 Link type "
icon" - 4.12.4.6
Link type "
license" - 4.12.4.7
Link type "
nofollow" - 4.12.4.8
Link type "
noreferrer" - 4.12.4.9
Link type "
prefetch" - 4.12.4.10
Link type "
search" - 4.12.4.11 Link type
"
stylesheet" - 4.12.4.12 Link
type "
tag" - 4.12.4.13 Sequential link types
- 4.12.4.14 Other link types
- 4.12.4.1
Link type "
- 4.13 Common idioms without dedicated elements
- 5 Loading Web pages
- 6 Web application APIs
- 7 User interaction
- 8 The HTML syntax
- 9 The XHTML syntax
- 10 Obsolete features
- 11 IANA considerations
- Index
- Index of terms
- References
- Acknowledgements