- From: poot <cvsmail@w3.org>
- Date: Sat, 3 Apr 2010 06:50:04 +0900 (JST)
- To: public-html-diffs@w3.org
microdata; hixie: readd annotations
http://dev.w3.org/cvsweb/html5/md/Overview.html?r1=1.58&r2=1.59&f=h
===================================================================
RCS file: /sources/public/html5/md/Overview.html,v
retrieving revision 1.58
retrieving revision 1.59
diff -u -d -r1.58 -r1.59
--- Overview.html 2 Apr 2010 21:44:57 -0000 1.58
+++ Overview.html 2 Apr 2010 21:49:55 -0000 1.59
@@ -436,8 +436,8 @@
<li><a href="#application-microdata-json"><span class="secno">7.1 </span><code>application/microdata+json</code></a></ol></li>
<li><a class="no-num" href="#references">References</a></li>
<li><a class="no-num" href="#acknowledgements">Acknowledgements</a></ol>
-<!--end-toc--><hr><h2 id="common-infrastructure"><span class="secno">1 </span>Common infrastructure</h2><h3 id="dependencies"><span class="secno">1.1 </span>Dependencies</h3><p>This specification depends on the Web IDL and HTML5
- specifications. <a href="#refsWEBIDL">[WEBIDL]</a> <a href="#refsHTML5">[HTML5]</a><h3 id="terminology"><span class="secno">1.2 </span>Terminology</h3><p>This specification relies heavily on the HTML5 specification to
+<!--end-toc--><hr><h2 id="common-infrastructure"><span class="secno">1 </span>Common infrastructure</h2><h3 id="dependencies"><span class="secno">1.1 </span>Dependencies</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>This specification depends on the Web IDL and HTML5
+ specifications. <a href="#refsWEBIDL">[WEBIDL]</a> <a href="#refsHTML5">[HTML5]</a><h3 id="terminology"><span class="secno">1.2 </span>Terminology</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>This specification relies heavily on the HTML5 specification to
define underlying terms.<p>HTML5 defines the concept of DOM <dfn id="collections">collections</dfn>, and of
IDL attributes <dfn id="reflect" title="reflect">reflecting</dfn> content
attributes. It also defines <dfn id="tree-order">tree order</dfn> and the concept of
@@ -462,7 +462,7 @@
is.<p>Finally, HTML5 also defines the concepts of <dfn id="drag-and-drop-initialization-steps">drag-and-drop
initialization steps</dfn> and of the <dfn id="list-of-dragged-nodes">list of dragged
nodes</dfn>, which come up in the context of drag-and-drop
- interfaces.</p><!--FIXUP 2dcontext +1--><h3 id="conformance-requirements"><span class="secno">1.3 </span>Conformance requirements</h3><!--FIXUP 2dcontext -1--><p>All diagrams, examples, and notes in this specification are
+ interfaces.</p><!--FIXUP 2dcontext +1--><h3 id="conformance-requirements"><span class="secno">1.3 </span>Conformance requirements</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!--FIXUP 2dcontext -1--><p>All diagrams, examples, and notes in this specification are
non-normative, as are all sections explicitly marked non-normative.
Everything else in this specification is normative.<p>The key words "MUST", "MUST NOT", "REQUIRED", <!--"SHALL", "SHALL
NOT",--> "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
@@ -589,14 +589,14 @@
values obtained from the <code title="dom-itemValue"><a href="#dom-itemvalue">itemValue</a></code> DOM property of each of the
elements represented by the object, in <a href="#tree-order">tree order</a>.</p>
- </div><h2 id="introduction"><span class="secno">2 </span>Introduction</h2><h3 id="overview"><span class="secno">2.1 </span>Overview</h3><p><i>This section is non-normative.</i><p>Sometimes, it is desirable to annotate content with specific
+ </div><h2 id="introduction"><span class="secno">2 </span>Introduction</h2><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><h3 id="overview"><span class="secno">2.1 </span>Overview</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>Sometimes, it is desirable to annotate content with specific
machine-readable labels, e.g. to allow generic scripts to provide
services that are customised to the page, or to enable content from
a variety of cooperating authors to be processed by a single script
in a consistent manner.<p>For this purpose, authors can use the microdata features
described in this section. Microdata allows nested groups of
name-value pairs to be added to documents, in parallel with the
- existing content.<h3 id="the-basic-syntax"><span class="secno">2.2 </span>The basic syntax</h3><p><i>This section is non-normative.</i><p>At a high level, microdata consists of a group of name-value
+ existing content.<h3 id="the-basic-syntax"><span class="secno">2.2 </span>The basic syntax</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>At a high level, microdata consists of a group of name-value
pairs. The groups are called <a href="#concept-item" title="concept-item">items</a>, and each name-value pair is a
property. Items and properties are represented by regular
elements.<p>To create an item, the <code title="attr-itemscope"><a href="#attr-itemscope">itemscope</a></code> attribute is used.<p>To add a property to an item, the <code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code> attribute is used on one of
@@ -744,7 +744,7 @@
drag-and-drop data. In neither case is the image in any way
associated with the item.</p>
- </div><h3 id="typed-items"><span class="secno">2.3 </span>Typed items</h3><p><i>This section is non-normative.</i><p>The examples in the previous section show how information could
+ </div><h3 id="typed-items"><span class="secno">2.3 </span>Typed items</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>The examples in the previous section show how information could
be marked up on a page that doesn't expect its microdata to be
re-used. Microdata is most useful, though, when it is used in
contexts where other authors and readers are able to cooperate to
@@ -772,7 +772,7 @@
given for an item with the type "http://census.example/person" might
refer to the economic class of an individual, while a property named
"class" given for an item with the type "http://example.com/school/teacher"
- might refer to the classroom a teacher has been assigned.<h3 id="global-identifiers-for-items"><span class="secno">2.4 </span>Global identifiers for items</h3><p><i>This section is non-normative.</i><p>Sometimes, an <a href="#concept-item" title="concept-item">item</a> gives
+ might refer to the classroom a teacher has been assigned.<h3 id="global-identifiers-for-items"><span class="secno">2.4 </span>Global identifiers for items</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>Sometimes, an <a href="#concept-item" title="concept-item">item</a> gives
information about a topic that has a global identifier. For example,
books can be identified by their ISBN number.<p>Vocabularies (as identified by the <code title="attr-itemtype"><a href="#attr-itemtype">itemtype</a></code> attribute) can be designed
such that <a href="#concept-item" title="concept-item">items</a> get associated
@@ -811,7 +811,7 @@
leads to a situation where it is ambiguous whether the identifier,
and thus the set of properties specified in the microdata,
references the page or something else.</p>
- --><h3 id="selecting-names-when-defining-vocabularies"><span class="secno">2.5 </span>Selecting names when defining vocabularies</h3><p><i>This section is non-normative.</i><p>Using microdata means using a vocabulary. For some purposes, an
+ --><h3 id="selecting-names-when-defining-vocabularies"><span class="secno">2.5 </span>Selecting names when defining vocabularies</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>Using microdata means using a vocabulary. For some purposes, an
ad-hoc vocabulary is adequate. For others, a vocabulary will need to
be designed. Where possible, authors are encouraged to re-use
existing vocabularies, as this makes content re-use easier.<p>When designing new vocabularies, identifiers can be created
@@ -866,7 +866,7 @@
<td>white
<tr><td>img
<td>.../hedral.jpeg
- </table></div><h3 id="using-the-microdata-dom-api"><span class="secno">2.6 </span>Using the microdata DOM API</h3><p><i>This section is non-normative.</i><p>The microdata becomes even more useful when scripts can use it to
+ </table></div><h3 id="using-the-microdata-dom-api"><span class="secno">2.6 </span>Using the microdata DOM API</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>The microdata becomes even more useful when scripts can use it to
expose information to the user, for example offering it in a form
that can be used by other applications.<p>The <code title="dom-document-getItems"><a href="#dom-document-getitems">document.getItems(<var title="">typeNames</var>)</a></code> method provides access to the
<a href="#top-level-microdata-items">top-level microdata items</a>. It returns a
@@ -971,13 +971,13 @@
</ul><p>(The duplicate occurrence of "http://example.com/color" is not included
in the list.)</p>
- </div><h2 id="encoding-microdata"><span class="secno">3 </span>Encoding microdata</h2><p>The following attributes are added as <a href="#global-attributes">global
+ </div><h2 id="encoding-microdata"><span class="secno">3 </span>Encoding microdata</h2><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The following attributes are added as <a href="#global-attributes">global
attributes</a> to HTML elements:<ul class="brief"><li><code title="attr-itemid"><a href="#attr-itemid">itemid</a></code></li>
<li><code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code></li>
<li><code title="attr-itemref"><a href="#attr-itemref">itemref</a></code></li>
<li><code title="attr-itemscope"><a href="#attr-itemscope">itemscope</a></code></li>
<li><code title="attr-itemtype"><a href="#attr-itemtype">itemtype</a></code></li>
- </ul><h3 id="the-microdata-model"><span class="secno">3.1 </span>The microdata model</h3><p>The microdata model consists of groups of name-value pairs known
+ </ul><h3 id="the-microdata-model"><span class="secno">3.1 </span>The microdata model</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The microdata model consists of groups of name-value pairs known
as <a href="#concept-item" title="concept-item">items</a>.<p>Each group is known as an <a href="#concept-item" title="concept-item">item</a>. Each <a href="#concept-item" title="concept-item">item</a> can have an <a href="#item-type">item type</a>,
a <a href="#global-identifier">global identifier</a> (if the <a href="#item-type">item type</a>
<a href="#support-global-identifiers-for-items" title="support global identifiers for items">supports global
@@ -990,7 +990,7 @@
item">property</a> of a <a href="#typed-item">typed item</a>. The
<dfn id="relevant-type">relevant type</dfn> for a <a href="#typed-item">typed item</a> is the <a href="#concept-item" title="concept-item">item</a>'s <a href="#item-type">item type</a>, if it has
one, or else is the <a href="#relevant-type">relevant type</a> of the <a href="#concept-item" title="concept-item">item</a> for which it is a <a href="#the-properties-of-an-item" title="the
- properties of an item">property</a>'s <a href="#concept-property-value" title="concept-property-value">value</a>.<h3 id="items"><span class="secno">3.2 </span>Items</h3><p>Every <span title="HTML elements">HTML element</span> may have an
+ properties of an item">property</a>'s <a href="#concept-property-value" title="concept-property-value">value</a>.<h3 id="items"><span class="secno">3.2 </span>Items</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>Every <span title="HTML elements">HTML element</span> may have an
<dfn id="attr-itemscope" title="attr-itemscope"><code>itemscope</code></dfn> attribute
specified. The <code title="attr-itemscope"><a href="#attr-itemscope">itemscope</a></code>
attribute is a <a href="#boolean-attribute">boolean attribute</a>.<p>An element with the <code title="attr-itemscope"><a href="#attr-itemscope">itemscope</a></code>
@@ -1044,7 +1044,7 @@
specified, must have a value that is an <a href="#unordered-set-of-unique-space-separated-tokens">unordered set of
unique space-separated tokens</a> consisting of <a href="#concept-id" title="concept-ID">IDs</a> of elements in the same <a href="#home-subtree">home
subtree</a>.<p>The <code title="attr-itemref"><a href="#attr-itemref">itemref</a></code> attribute must not
- be specified on elements that do not have an <code title="attr-itemscope"><a href="#attr-itemscope">itemscope</a></code> attribute specified.<h3 id="names:-the-itemprop-attribute"><span class="secno">3.3 </span>Names: the <dfn title="attr-itemprop"><code>itemprop</code></dfn> attribute</h3><p>Every <span title="HTML elements">HTML element</span> may have an
+ be specified on elements that do not have an <code title="attr-itemscope"><a href="#attr-itemscope">itemscope</a></code> attribute specified.<h3 id="names:-the-itemprop-attribute"><span class="secno">3.3 </span>Names: the <dfn title="attr-itemprop"><code>itemprop</code></dfn> attribute</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>Every <span title="HTML elements">HTML element</span> may have an
<code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code> attribute specified, if
doing so <a href="#the-properties-of-an-item" title="the properties of an item">adds a
property</a> to one or more <a href="#concept-item" title="concept-item">items</a> (as defined below).<p>The <code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code> attribute, if
@@ -1124,7 +1124,7 @@
</div>
</pre>
- </div><h3 id="values"><span class="secno">3.4 </span>Values</h3><p>The <dfn id="concept-property-value" title="concept-property-value">property value</dfn> of a
+ </div><h3 id="values"><span class="secno">3.4 </span>Values</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="concept-property-value" title="concept-property-value">property value</dfn> of a
name-value pair added by an element with an <code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code> attribute depends on the
element, as follows:<dl><dt>If the element also has an <code title="attr-itemscope"><a href="#attr-itemscope">itemscope</a></code> attribute</dt>
@@ -1191,7 +1191,7 @@
element</a>.<p>If a property's <a href="#concept-property-value" title="concept-property-value">value</a>
represents a <a href="#concept-date" title="concept-date">date</a>, <a href="#concept-time" title="concept-time">time</a>, or <a href="#concept-datetime" title="concept-datetime">global date and time</a>, the property
must be specified using the <code title="attr-time-datetime">datetime</code> attribute of a
- <code>time</code> element.<h3 id="associating-names-with-items"><span class="secno">3.5 </span>Associating names with items</h3><p>To find <dfn id="the-properties-of-an-item">the properties of an item</dfn> defined by the
+ <code>time</code> element.<h3 id="associating-names-with-items"><span class="secno">3.5 </span>Associating names with items</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>To find <dfn id="the-properties-of-an-item">the properties of an item</dfn> defined by the
element <var title="">root</var>, the user agent must try to
<a href="#crawl-the-properties">crawl the properties</a> of the element <var title="">root</var>, with an empty list as the value of <var title="">memory</var>: if this fails, then <a href="#the-properties-of-an-item" title="the
properties of an item">the properties of the item</a> defined by
@@ -1336,7 +1336,7 @@
properties.)</span>
</p></pre>
- </div><h2 id="microdata-dom-api"><span class="secno">4 </span>Microdata DOM API</h2><pre class="idl">[Supplemental] interface <span>HTMLDocument</span> { <!--WARNING: ALSO DUPLICATED IN HTMLDocument SECTION-->
+ </div><h2 id="microdata-dom-api"><span class="secno">4 </span>Microdata DOM API</h2><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><pre class="idl">[Supplemental] interface <span>HTMLDocument</span> { <!--WARNING: ALSO DUPLICATED IN HTMLDocument SECTION-->
NodeList <a href="#dom-document-getitems" title="dom-document-getItems">getItems</a>(in optional DOMString typeNames); // <span>microdata</span>
};
@@ -1499,7 +1499,7 @@
<pre>for (var index = 0; index < element.itemRef.length; index += 1)
process(document.getElementById(element.itemRef[index]));</pre>
- </div><h2 id="other-changes-to-html5"><span class="secno">5 </span>Other changes to HTML5</h2><h3 id="content-models"><span class="secno">5.1 </span>Content models</h3><p>If the <code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code> attribute is
+ </div><h2 id="other-changes-to-html5"><span class="secno">5 </span>Other changes to HTML5</h2><h3 id="content-models"><span class="secno">5.1 </span>Content models</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>If the <code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code> attribute is
present on <code>link</code> or <code>meta</code>, they are
<a href="#flow-content">flow content</a> and <a href="#phrasing-content">phrasing content</a>. The
<code>link</code> and <code>meta</code> elements may be used where
@@ -1520,12 +1520,12 @@
</li>
</ol></div><div class="impl">
- <h2 id="converting-html-to-other-formats"><span class="secno">6 </span>Converting HTML to other formats</h2>
+ <h2 id="converting-html-to-other-formats"><span class="secno">6 </span>Converting HTML to other formats</h2><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
- <h3 id="json"><span class="secno">6.1 </span>JSON</h3>
+ <h3 id="json"><span class="secno">6.1 </span>JSON</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
<p>Given a list of nodes <var title="">nodes</var> in a
<code>Document</code>, a user agent must run the following algorithm
@@ -1597,7 +1597,7 @@
<li><p>Return <var title="">result</var>.</li>
- </ol><h3 id="rdf"><span class="secno">6.2 </span>RDF</h3>
+ </ol><h3 id="rdf"><span class="secno">6.2 </span>RDF</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
<p>To <dfn id="extracting-rdf" title="extracting rdf">convert a <code>Document</code> to
RDF</dfn>, a user agent must run the following algorithm:</p>
@@ -1898,7 +1898,7 @@
<li><p>Return <var title="">subject</var>.</li>
- </ol><h4 id="examples"><span class="secno">6.2.1 </span>Examples</h4>
+ </ol><h4 id="examples"><span class="secno">6.2.1 </span>Examples</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p>
<p><i>This section is non-normative.</i></p>
@@ -2046,7 +2046,7 @@
<dd>W3C and WHATWG</dd>
</dl><p>Fragment identifiers used with
<code><a href="#application-microdata-json">application/microdata+json</a></code> resources have the same
- semantics as when used with <code>application/json</code>. <a href="#refsJSON">[JSON]</a><h2 class="no-num" id="references">References</h2><!--REFS--><p>All references are normative unless marked "Non-normative".</p><!-- Dates are only included for standards older than the Web,
+ semantics as when used with <code>application/json</code>. <a href="#refsJSON">[JSON]</a><h2 class="no-num" id="references">References</h2><p class="XXX annotation"><b>Status: </b><i>Implemented and widely deployed</i></p><!--REFS--><p>All references are normative unless marked "Non-normative".</p><!-- Dates are only included for standards older than the Web,
because the newer ones keep changing. --><dl><dt id="refsHTML5">[HTML5]</dt>
<dd><cite><a href="http://dev.w3.org/html5/spec/">HTML5</a></cite>,
I. Hickson, D. Hyatt. W3C.</dd>
@@ -2072,5 +2072,5 @@
<dd><cite><a href="http://dev.w3.org/2006/webapi/WebIDL/">Web
IDL</a></cite>, C. McCormack. W3C.</dd>
- </dl><h2 class="no-num" id="acknowledgements">Acknowledgements</h2><p>For a full list of acknowledgements, please see the HTML5
+ </dl><h2 class="no-num" id="acknowledgements">Acknowledgements</h2><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>For a full list of acknowledgements, please see the HTML5
specification. <a href="#refsHTML5">[HTML5]</a>
Received on Friday, 2 April 2010 21:50:34 UTC