[html5] r6668 - [acgiowt] (0) Redefine itemtype='' to allow multiple types if they share the sam [...]
whatwg at whatwg.org
whatwg at whatwg.org
Tue Oct 11 17:13:19 PDT 2011
Author: ianh
Date: 2011-10-11 17:13:17 -0700 (Tue, 11 Oct 2011)
New Revision: 6668
Modified:
complete.html
index
source
Log:
[acgiowt] (0) Redefine itemtype='' to allow multiple types if they share the same vocabulary. This was by far the most frequently made request at the recent schema.org event
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=14233
Modified: complete.html
===================================================================
--- complete.html 2011-10-11 23:47:06 UTC (rev 6667)
+++ complete.html 2011-10-12 00:13:17 UTC (rev 6668)
@@ -240,7 +240,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 11 October 2011</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 12 October 2011</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -10281,7 +10281,7 @@
<!--MD--> // <a href=#microdata>microdata</a> <!--WARNING: ALSO DUPLICATED IN MICRODATA SECTION-->
attribute boolean <a href=#dom-itemscope title=dom-itemScope>itemScope</a>;
- attribute DOMString <a href=#dom-itemtype title=dom-itemType>itemType</a>;
+ [PutForwards=<span title=dom-DOMSettableTokenList-value>value</span>] readonly attribute <a href=#domsettabletokenlist>DOMSettableTokenList</a> <a href=#dom-itemtype title=dom-itemType>itemType</a>;
attribute DOMString <a href=#dom-itemid title=dom-itemId>itemId</a>;
[PutForwards=<span title=dom-DOMSettableTokenList-value>value</span>] readonly attribute <a href=#domsettabletokenlist>DOMSettableTokenList</a> <a href=#dom-itemref title=dom-itemRef>itemRef</a>;
[PutForwards=<span title=dom-DOMSettableTokenList-value>value</span>] readonly attribute <a href=#domsettabletokenlist>DOMSettableTokenList</a> <a href=#dom-itemprop title=dom-itemProp>itemProp</a>;
@@ -57512,12 +57512,20 @@
</div>
- <p>An item can only have one type. The type gives the context for
- the properties, thus defining a vocabulary: a property named "class"
- 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.</p>
+ <p>The type gives the context for the properties, thus defining a
+ vocabulary: a property named "class" 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. Several types can share a
+ vocabulary. For example, the types "<code title="">http://example.org/people/teacher</code>" and "<code title="">http://example.org/people/engineer</code>" could be defined
+ to use the same vocabulary (though maybe some properties would not
+ be especially useful in both cases, e.g. maybe the "<code title="">http://example.org/people/engineer</code>" type might not
+ typically be used with the "<code title="">classroom</code>"
+ property). Multiple types defined to use the same vocabulary can be
+ given for a single item by listing the URLs as a space-separated
+ list in the attribute' value. An item cannot be given two types if
+ they do not use the same vocabulary, however.</p>
<h4 id=global-identifiers-for-items><span class=secno>5.1.4 </span>Global identifiers for items</h4>
@@ -57664,7 +57672,7 @@
elements have their <code title=dom-itemScope><a href=#dom-itemscope>element.itemScope</a></code> IDL attribute set to
true.</p>
- <p>The type of <a href=#concept-item title=concept-item>items</a> can be
+ <p>The type(s) of <a href=#concept-item title=concept-item>items</a> can be
obtained using the <code title=dom-itemType><a href=#dom-itemtype>element.itemType</a></code> IDL attribute on the
element with the <code title=attr-itemscope><a href=#attr-itemscope>itemscope</a></code>
attribute.</p>
@@ -57672,8 +57680,8 @@
<div class=example>
<p>This sample shows how the <code title=dom-document-getItems><a href=#dom-document-getitems>getItems()</a></code> method can be used
- to obtain a list of all the top-level microdata items of one type
- given in the document:</p>
+ to obtain a list of all the top-level microdata items of a
+ particular type given in the document:</p>
<pre>var cats = document.getItems("http://example.com/feline");</pre>
@@ -57790,24 +57798,24 @@
as <a href=#concept-item title=concept-item>items</a>.</p>
<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 identifiers for its items</a>), and a list
- of name-value pairs. Each name in the name-value pair is known as a
- <a href=#the-properties-of-an-item title="the properties of an item">property</a>, and each
- <a href=#the-properties-of-an-item title="the properties of an item">property</a> has one or
- more <a href=#concept-property-value title=concept-property-value>values</a>. Each <a href=#concept-property-value title=concept-property-value>value</a> is either a string or
+ Each <a href=#concept-item title=concept-item>item</a> can have <a href=#item-types>item
+ types</a>, a <a href=#global-identifier>global identifier</a> (if the vocabulary
+ specified by the <a href=#item-types>item types</a> <a href=#support-global-identifiers-for-items>support global
+ identifiers for items</a>), and a list of name-value pairs. Each
+ name in the name-value pair is known as a <a href=#the-properties-of-an-item title="the
+ properties of an item">property</a>, and each <a href=#the-properties-of-an-item title="the
+ properties of an item">property</a> has one or more <a href=#concept-property-value title=concept-property-value>values</a>. Each <a href=#concept-property-value title=concept-property-value>value</a> is either a string or
itself a group of name-value pairs (an <a href=#concept-item title=concept-item>item</a>). The names are unordered relative
to each other, but if a particular name has multiple values, they do
have a relative order.</p>
<p>An <a href=#concept-item title=concept-item>item</a> is said to be a
- <dfn id=typed-item>typed item</dfn> when either it has an <a href=#item-type>item type</a>,
- or it is the <a href=#concept-property-value title=concept-property-value>value</a> of a <a href=#the-properties-of-an-item title="the properties of an
- 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
+ <dfn id=typed-item>typed item</dfn> when either it has an <a href=#item-types title="item
+ types">item type</a>, or it is the <a href=#concept-property-value title=concept-property-value>value</a> of a <a href=#the-properties-of-an-item title="the
+ properties of an item">property</a> of a <a href=#typed-item>typed item</a>.
+ The <dfn id=relevant-types>relevant types</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-types>item types</a>, if
+ it has one, or else is the <a href=#relevant-types>relevant types</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>.</p>
@@ -57824,35 +57832,40 @@
<hr><p>Elements with an <code title=attr-itemscope><a href=#attr-itemscope>itemscope</a></code>
attribute may have an <dfn id=attr-itemtype title=attr-itemtype><code>itemtype</code></dfn> attribute
- specified, to give the <a href=#item-type>item type</a> of the <a href=#concept-item title=concept-item>item</a>.</p>
+ specified, to give the <a href=#item-types>item types</a> of the <a href=#concept-item title=concept-item>item</a>.</p>
<p>The <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> attribute, if
- specified, must have a value that is a <a href=#valid-url>valid URL</a> that
- is an <a href=#absolute-url>absolute URL</a>.</p>
+ 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> that are
+ <a href=#case-sensitive>case-sensitive</a>, each of which is a <a href=#valid-url>valid
+ URL</a> that is an <a href=#absolute-url>absolute URL</a>, and all of which
+ are defined to use the same vocabulary.</p>
- <p>The <dfn id=item-type>item type</dfn> of an <a href=#concept-item title=concept-item>item</a> is the value of its element's <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> attribute, if it has one and
- its value is not the empty string. If the <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> attribute is missing or its
- value is the empty string, the <a href=#concept-item title=concept-item>item</a> is said to have no <a href=#item-type>item
- type</a>.</p>
+ <p>The <dfn id=item-types>item types</dfn> of an <a href=#concept-item title=concept-item>item</a> are the <a href=#absolute-url title="absolute
+ URL">absolute URLs</a> obtained by <a href=#split-a-string-on-spaces title="split a string on
+ spaces">splitting the element's <code title=attr-itemtype>itemtype</code> attribute's value on
+ spaces</a>. If the <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code>
+ attribute is missing or parsing it in this way finds no tokens that
+ are <a href=#absolute-url title="absolute URL">absolute URLs</a>, the <a href=#concept-item title=concept-item>item</a> is said to have no <a href=#item-types>item
+ types</a>.</p>
- <p>The <a href=#item-type>item type</a> must be a type defined in an <a href=#other-applicable-specifications title="other applicable specifications">applicable
- specification</a>.</p>
+ <p>The <a href=#item-types>item types</a> must all be types defined in <a href=#other-applicable-specifications title="other applicable specifications">applicable
+ specifications</a> and must all be defined to use the same
+ vocabulary.</p>
<div class=impl>
- <p>Except if otherwise specified by that specification, the
- <a href=#url>URL</a> given as the <a href=#item-type>item type</a> should not be
- automatically dereferenced.</p>
+ <p>Except if otherwise specified by that specification, the <a href=#url title=URL>URLs</a> given as the <a href=#item-types>item types</a> should
+ not be automatically dereferenced.</p>
- <p class=note>A specification could define that its <a href=#item-type>item
- type</a> can be derefenced to provide the user with help
- information, for example. In fact, vocabulary authors are
- encouraged to provide useful information at the given
+ <p class=note>A specification could define that its <a href=#item-types title="item types">item type</a> can be derefenced to provide
+ the user with help information, for example. In fact, vocabulary
+ authors are encouraged to provide useful information at the given
<a href=#url>URL</a>.</p>
- <p><a href=#item-type title="item type">Item types</a> are opaque
- identifiers, and user agents must not dereference unknown <a href=#item-type title="item type">item types</a>, or otherwise deconstruct them,
- in order to determine how to process <a href=#concept-item title=concept-item>items</a> that use them.</p>
+ <p><a href=#item-types>Item types</a> are opaque identifiers, and user agents
+ must not dereference unknown <a href=#item-types>item types</a>, or otherwise
+ deconstruct them, in order to determine how to process <a href=#concept-item title=concept-item>items</a> that use them.</p>
</div>
@@ -57935,7 +57948,7 @@
<li>If the item is a <a href=#typed-item>typed item</a>: a <dfn id=defined-property-name>defined
property name</dfn> allowed in this situation according to the
- specification that defines the <a href=#relevant-type>relevant type</a> for the
+ specification that defines the <a href=#relevant-types>relevant types</a> for the
item, or</li>
<li>If the item is not a <a href=#typed-item>typed item</a>: a string that
@@ -58294,27 +58307,31 @@
representing types. When called, the method must return a
<a href=#live>live</a> <code><a href=#nodelist>NodeList</a></code> object containing all the
elements in the document, in <a href=#tree-order>tree order</a>, that are each
- <a href=#top-level-microdata-items>top-level microdata items</a> with a <a href=#item-type title="item
- type">type</a> equal to one of the types specified in that
- argument, having obtained the types by <a href=#split-a-string-on-spaces title="split a string
- on spaces">splitting the string on spaces</a>. If there are no
- tokens specified in the argument, or if the argument is missing,
- then the method must return a <code><a href=#nodelist>NodeList</a></code> containing all
- the <a href=#top-level-microdata-items>top-level microdata items</a> in the document. When the
- method is invoked on a <code><a href=#document>Document</a></code> object again with the
- same argument, the user agent may return the same object as the
- object returned by the earlier call. In other cases, a new
- <code><a href=#nodelist>NodeList</a></code> object must be returned.</p>
+ <a href=#top-level-microdata-items>top-level microdata items</a> with one of their <a href=#item-types title="item types">types</a> equal to one of the types specified
+ in that argument, having obtained the types by <a href=#split-a-string-on-spaces title="split a
+ string on spaces">splitting the string on spaces</a>. If there
+ are no tokens specified in the argument, or if the argument is
+ missing, then the method must return a <code><a href=#nodelist>NodeList</a></code>
+ containing all the <a href=#top-level-microdata-items>top-level microdata items</a> in the
+ document. When the method is invoked on a <code><a href=#document>Document</a></code>
+ object again with the same argument, the user agent may return the
+ same object as the object returned by the earlier call. In other
+ cases, a new <code><a href=#nodelist>NodeList</a></code> object must be returned.</p>
+ <p class=note>Since a token in the <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> attribute that is not an
+ <a href=#absolute-url>absolute URL</a> is not considered to be one of the item's
+ <a href=#item-types>item types</a>, any tokens passed to <code title=dom-document-getItems><a href=#dom-document-getitems>getItems()</a></code> that are not
+ themselves <a href=#absolute-url title="absolute URL">absolute URLs</a> will not
+ find any items.</p>
+
<p>The <dfn id=dom-itemscope title=dom-itemScope><code>itemScope</code></dfn> IDL
attribute on <a href=#html-elements>HTML elements</a> must <a href=#reflect>reflect</a>
the <code title=attr-itemscope><a href=#attr-itemscope>itemscope</a></code> content attribute.
The <dfn id=dom-itemtype title=dom-itemType><code>itemType</code></dfn> IDL
attribute on <a href=#html-elements>HTML elements</a> must <a href=#reflect>reflect</a>
- the <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> content attribute,
- as if it was a regular string attribute, not a <a href=#url>URL</a>
- string attribute. The <dfn id=dom-itemid title=dom-itemId><code>itemId</code></dfn> IDL attribute on
- <a href=#html-elements>HTML elements</a> must <a href=#reflect>reflect</a> the <code title=attr-itemid><a href=#attr-itemid>itemid</a></code> content attribute. The <dfn id=dom-itemprop title=dom-itemProp><code>itemProp</code></dfn> IDL attribute on
+ the <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> content attribute.
+ The <dfn id=dom-itemid title=dom-itemId><code>itemId</code></dfn> IDL attribute
+ on <a href=#html-elements>HTML elements</a> must <a href=#reflect>reflect</a> the <code title=attr-itemid><a href=#attr-itemid>itemid</a></code> content attribute. The <dfn id=dom-itemprop title=dom-itemProp><code>itemProp</code></dfn> IDL attribute on
<a href=#html-elements>HTML elements</a> must <a href=#reflect>reflect</a> the <code title=attr-itemprop><a href=#names:-the-itemprop-attribute>itemprop</a></code> content attribute. The <dfn id=dom-itemref title=dom-itemRef><code>itemRef</code></dfn> IDL attribute on
<a href=#html-elements>HTML elements</a> must <a href=#reflect>reflect</a> the <code title=attr-itemref><a href=#attr-itemref>itemref</a></code> content attribute.</p>
@@ -58420,7 +58437,7 @@
- <p>An item with the <a href=#item-type>item type</a> <dfn id=md-vcard title=md-vcard><code>http://microformats.org/profile/hcard</code></dfn>
+ <p>An item with the <a href=#item-types title="item types">item type</a> <dfn id=md-vcard title=md-vcard><code>http://microformats.org/profile/hcard</code></dfn>
represents a person's or organization's contact information.</p>
<p>This vocabulary <a href=#support-global-identifiers-for-items title="support global identifiers for
@@ -59509,12 +59526,12 @@
represented by those nodes</dfn> (only the first vCard is
returned):</p>
- <ol><li><p>If none of the nodes in <var title="">nodes</var> are <a href=#concept-item title=concept-item>items</a> with the <a href=#item-type>item type</a>
- <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code>, then
+ <ol><li><p>If none of the nodes in <var title="">nodes</var> are <a href=#concept-item title=concept-item>items</a> with the <a href=#item-types title="item
+ types">item type</a> <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code>, then
there is no vCard. Abort the algorithm, returning nothing.</li>
- <li><p>Let <var title="">node</var> be the first node in <var title="">nodes</var> that is an <a href=#concept-item title=concept-item>item</a> with the <a href=#item-type>item type</a>
- <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code>.</li>
+ <li><p>Let <var title="">node</var> be the first node in <var title="">nodes</var> that is an <a href=#concept-item title=concept-item>item</a> with the <a href=#item-types title="item
+ types">item type</a> <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code>.</li>
<li><p>Let <var title="">output</var> be an empty string.</li>
@@ -59692,7 +59709,7 @@
</ol></dd>
<dt>If the property's <a href=#concept-property-value title=concept-property-value>value</a> is an <a href=#concept-item title=concept-item>item</a> <var title="">subitem</var>
- with the <a href=#item-type>item type</a> <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code>
+ with the <a href=#item-types title="item types">item type</a> <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code>
and <var title="">name</var> is <code title=md-vcard-agent><a href=#md-vcard-agent>agent</a></code></dt>
<dd>
@@ -59918,10 +59935,10 @@
<li><p>Return the mutated <var title="">value</var>.</li>
</ol><p class=note>This algorithm can generate invalid vCard output, if
- the input does not conform to the rules described for the <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code>
- <a href=#item-type>item type</a> and <a href=#defined-property-name title="defined property
- name">defined property names</a>.</p> <!-- of course since vcard
- doesn't define error handling, this is somewhat problematic. -->
+ the input does not conform to the rules described for the <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code> <a href=#item-types title="item types">item type</a> and <a href=#defined-property-name title="defined
+ property name">defined property names</a>.</p> <!-- of course
+ since vcard doesn't define error handling, this is somewhat
+ problematic. -->
@@ -60048,7 +60065,7 @@
- <p>An item with the <a href=#item-type>item type</a> <dfn id=md-vevent title=md-vevent><code>http://microformats.org/profile/hcalendar#vevent</code></dfn>
+ <p>An item with the <a href=#item-types title="item types">item type</a> <dfn id=md-vevent title=md-vevent><code>http://microformats.org/profile/hcalendar#vevent</code></dfn>
represents an event.</p>
<p>This vocabulary <a href=#support-global-identifiers-for-items title="support global identifiers for
@@ -60747,7 +60764,7 @@
</ol><p class=note>This algorithm can generate invalid iCalendar
output, if the input does not conform to the rules described for the
<code title=md-vevent><a href=#md-vevent>http://microformats.org/profile/hcalendar#vevent</a></code>
- <a href=#item-type>item type</a> and <a href=#defined-property-name title="defined property
+ <a href=#item-types title="item types">item type</a> and <a href=#defined-property-name title="defined property
name">defined property names</a>.</p> <!-- of course since
iCalendar doesn't define error handling, this is somewhat
problematic. -->
@@ -60789,7 +60806,7 @@
<pre>function getCalendar(node) {
// This function assumes the content is valid.
// It is not a compliant implementation of the algorithm for <a href=#extracting-vevent-data>extracting vEvent data</a>.
- while (node && (!node.itemScope || !node.itemType == 'http://microformats.org/profile/hcalendar#vevent'))
+ while (node && (!node.itemScope || !node.itemType.contains('http://microformats.org/profile/hcalendar#vevent')))
node = node.parentNode;
if (!node) {
alert('No event data found.');
@@ -60849,7 +60866,7 @@
- <p>An item with the <a href=#item-type>item type</a> <dfn id=md-work title=md-work><code>http://n.whatwg.org/work</code></dfn>
+ <p>An item with the <a href=#item-types title="item types">item type</a> <dfn id=md-work title=md-work><code>http://n.whatwg.org/work</code></dfn>
represents a work (e.g. an article, an image, a video, a song,
etc). This type is primarily intended to allow authors to include
licensing information for works.</p>
@@ -60988,11 +61005,17 @@
<li><p>Add <var title="">item</var> to <var title="">memory</var>.</li>
- <li><p>If the <var title="">item</var> has an <a href=#item-type>item
- type</a>, add an entry to <var title="">result</var> called
- "<code title="">type</code>" whose value is the <a href=#item-type>item
- type</a> of <var title="">item</var>.</li>
+ <li><p>If the <var title="">item</var> has any <a href=#item-types>item
+ types</a>, add an entry to <var title="">result</var> called
+ "<code title="">type</code>" whose value is an array listing the
+ <a href=#item-types>item types</a> of <var title="">item</var>, in the order
+ they were specified on the <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> attribute.</p>
+ <p class=note>Since only <a href=#absolute-url title="absolute URL">absolute
+ URLs</a> can be <a href=#item-types>item types</a>, any tokens in the <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> attribute that are not <a href=#absolute-url title="absolute URL">absolute URLs</a> are dropped.</li> <!--
+ the array is never empty, though, since if they were all dropped
+ then there would be no item types either -->
+
<li><p>If the <var title="">item</var> has a <a href=#global-identifier>global
identifier</a>, add an entry to <var title="">result</var>
called "<code title="">id</code>" whose value is the <a href=#global-identifier>global
@@ -100007,8 +100030,8 @@
<td> <a href=#boolean-attribute>Boolean attribute</a>
<tr><th> <code title="">itemtype</code>
<td> <a href=#attr-itemtype title=attr-itemtype>HTML elements</a>
- <td> <a href=#item-type>Item type</a> of a microdata item
- <td> <a href=#absolute-url title="absolute URL">Valid absolute URL</a>*
+ <td> <a href=#item-types>Item types</a> of a microdata item
+ <td> <a href=#unordered-set-of-unique-space-separated-tokens>Unordered set of unique space-separated tokens</a>, <a href=#case-sensitive>case-sensitive</a>, consisting of <a href=#absolute-url title="absolute URL">valid absolute URL</a>*
<!--MD-->
<tr><th> <code title="">keytype</code>
<td> <code title=attr-keygen-keytype><a href=#attr-keygen-keytype>keygen</a></code>
Modified: index
===================================================================
--- index 2011-10-11 23:47:06 UTC (rev 6667)
+++ index 2011-10-12 00:13:17 UTC (rev 6668)
@@ -240,7 +240,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 11 October 2011</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 12 October 2011</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -10281,7 +10281,7 @@
<!--MD--> // <a href=#microdata>microdata</a> <!--WARNING: ALSO DUPLICATED IN MICRODATA SECTION-->
attribute boolean <a href=#dom-itemscope title=dom-itemScope>itemScope</a>;
- attribute DOMString <a href=#dom-itemtype title=dom-itemType>itemType</a>;
+ [PutForwards=<span title=dom-DOMSettableTokenList-value>value</span>] readonly attribute <a href=#domsettabletokenlist>DOMSettableTokenList</a> <a href=#dom-itemtype title=dom-itemType>itemType</a>;
attribute DOMString <a href=#dom-itemid title=dom-itemId>itemId</a>;
[PutForwards=<span title=dom-DOMSettableTokenList-value>value</span>] readonly attribute <a href=#domsettabletokenlist>DOMSettableTokenList</a> <a href=#dom-itemref title=dom-itemRef>itemRef</a>;
[PutForwards=<span title=dom-DOMSettableTokenList-value>value</span>] readonly attribute <a href=#domsettabletokenlist>DOMSettableTokenList</a> <a href=#dom-itemprop title=dom-itemProp>itemProp</a>;
@@ -57512,12 +57512,20 @@
</div>
- <p>An item can only have one type. The type gives the context for
- the properties, thus defining a vocabulary: a property named "class"
- 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.</p>
+ <p>The type gives the context for the properties, thus defining a
+ vocabulary: a property named "class" 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. Several types can share a
+ vocabulary. For example, the types "<code title="">http://example.org/people/teacher</code>" and "<code title="">http://example.org/people/engineer</code>" could be defined
+ to use the same vocabulary (though maybe some properties would not
+ be especially useful in both cases, e.g. maybe the "<code title="">http://example.org/people/engineer</code>" type might not
+ typically be used with the "<code title="">classroom</code>"
+ property). Multiple types defined to use the same vocabulary can be
+ given for a single item by listing the URLs as a space-separated
+ list in the attribute' value. An item cannot be given two types if
+ they do not use the same vocabulary, however.</p>
<h4 id=global-identifiers-for-items><span class=secno>5.1.4 </span>Global identifiers for items</h4>
@@ -57664,7 +57672,7 @@
elements have their <code title=dom-itemScope><a href=#dom-itemscope>element.itemScope</a></code> IDL attribute set to
true.</p>
- <p>The type of <a href=#concept-item title=concept-item>items</a> can be
+ <p>The type(s) of <a href=#concept-item title=concept-item>items</a> can be
obtained using the <code title=dom-itemType><a href=#dom-itemtype>element.itemType</a></code> IDL attribute on the
element with the <code title=attr-itemscope><a href=#attr-itemscope>itemscope</a></code>
attribute.</p>
@@ -57672,8 +57680,8 @@
<div class=example>
<p>This sample shows how the <code title=dom-document-getItems><a href=#dom-document-getitems>getItems()</a></code> method can be used
- to obtain a list of all the top-level microdata items of one type
- given in the document:</p>
+ to obtain a list of all the top-level microdata items of a
+ particular type given in the document:</p>
<pre>var cats = document.getItems("http://example.com/feline");</pre>
@@ -57790,24 +57798,24 @@
as <a href=#concept-item title=concept-item>items</a>.</p>
<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 identifiers for its items</a>), and a list
- of name-value pairs. Each name in the name-value pair is known as a
- <a href=#the-properties-of-an-item title="the properties of an item">property</a>, and each
- <a href=#the-properties-of-an-item title="the properties of an item">property</a> has one or
- more <a href=#concept-property-value title=concept-property-value>values</a>. Each <a href=#concept-property-value title=concept-property-value>value</a> is either a string or
+ Each <a href=#concept-item title=concept-item>item</a> can have <a href=#item-types>item
+ types</a>, a <a href=#global-identifier>global identifier</a> (if the vocabulary
+ specified by the <a href=#item-types>item types</a> <a href=#support-global-identifiers-for-items>support global
+ identifiers for items</a>), and a list of name-value pairs. Each
+ name in the name-value pair is known as a <a href=#the-properties-of-an-item title="the
+ properties of an item">property</a>, and each <a href=#the-properties-of-an-item title="the
+ properties of an item">property</a> has one or more <a href=#concept-property-value title=concept-property-value>values</a>. Each <a href=#concept-property-value title=concept-property-value>value</a> is either a string or
itself a group of name-value pairs (an <a href=#concept-item title=concept-item>item</a>). The names are unordered relative
to each other, but if a particular name has multiple values, they do
have a relative order.</p>
<p>An <a href=#concept-item title=concept-item>item</a> is said to be a
- <dfn id=typed-item>typed item</dfn> when either it has an <a href=#item-type>item type</a>,
- or it is the <a href=#concept-property-value title=concept-property-value>value</a> of a <a href=#the-properties-of-an-item title="the properties of an
- 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
+ <dfn id=typed-item>typed item</dfn> when either it has an <a href=#item-types title="item
+ types">item type</a>, or it is the <a href=#concept-property-value title=concept-property-value>value</a> of a <a href=#the-properties-of-an-item title="the
+ properties of an item">property</a> of a <a href=#typed-item>typed item</a>.
+ The <dfn id=relevant-types>relevant types</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-types>item types</a>, if
+ it has one, or else is the <a href=#relevant-types>relevant types</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>.</p>
@@ -57824,35 +57832,40 @@
<hr><p>Elements with an <code title=attr-itemscope><a href=#attr-itemscope>itemscope</a></code>
attribute may have an <dfn id=attr-itemtype title=attr-itemtype><code>itemtype</code></dfn> attribute
- specified, to give the <a href=#item-type>item type</a> of the <a href=#concept-item title=concept-item>item</a>.</p>
+ specified, to give the <a href=#item-types>item types</a> of the <a href=#concept-item title=concept-item>item</a>.</p>
<p>The <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> attribute, if
- specified, must have a value that is a <a href=#valid-url>valid URL</a> that
- is an <a href=#absolute-url>absolute URL</a>.</p>
+ 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> that are
+ <a href=#case-sensitive>case-sensitive</a>, each of which is a <a href=#valid-url>valid
+ URL</a> that is an <a href=#absolute-url>absolute URL</a>, and all of which
+ are defined to use the same vocabulary.</p>
- <p>The <dfn id=item-type>item type</dfn> of an <a href=#concept-item title=concept-item>item</a> is the value of its element's <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> attribute, if it has one and
- its value is not the empty string. If the <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> attribute is missing or its
- value is the empty string, the <a href=#concept-item title=concept-item>item</a> is said to have no <a href=#item-type>item
- type</a>.</p>
+ <p>The <dfn id=item-types>item types</dfn> of an <a href=#concept-item title=concept-item>item</a> are the <a href=#absolute-url title="absolute
+ URL">absolute URLs</a> obtained by <a href=#split-a-string-on-spaces title="split a string on
+ spaces">splitting the element's <code title=attr-itemtype>itemtype</code> attribute's value on
+ spaces</a>. If the <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code>
+ attribute is missing or parsing it in this way finds no tokens that
+ are <a href=#absolute-url title="absolute URL">absolute URLs</a>, the <a href=#concept-item title=concept-item>item</a> is said to have no <a href=#item-types>item
+ types</a>.</p>
- <p>The <a href=#item-type>item type</a> must be a type defined in an <a href=#other-applicable-specifications title="other applicable specifications">applicable
- specification</a>.</p>
+ <p>The <a href=#item-types>item types</a> must all be types defined in <a href=#other-applicable-specifications title="other applicable specifications">applicable
+ specifications</a> and must all be defined to use the same
+ vocabulary.</p>
<div class=impl>
- <p>Except if otherwise specified by that specification, the
- <a href=#url>URL</a> given as the <a href=#item-type>item type</a> should not be
- automatically dereferenced.</p>
+ <p>Except if otherwise specified by that specification, the <a href=#url title=URL>URLs</a> given as the <a href=#item-types>item types</a> should
+ not be automatically dereferenced.</p>
- <p class=note>A specification could define that its <a href=#item-type>item
- type</a> can be derefenced to provide the user with help
- information, for example. In fact, vocabulary authors are
- encouraged to provide useful information at the given
+ <p class=note>A specification could define that its <a href=#item-types title="item types">item type</a> can be derefenced to provide
+ the user with help information, for example. In fact, vocabulary
+ authors are encouraged to provide useful information at the given
<a href=#url>URL</a>.</p>
- <p><a href=#item-type title="item type">Item types</a> are opaque
- identifiers, and user agents must not dereference unknown <a href=#item-type title="item type">item types</a>, or otherwise deconstruct them,
- in order to determine how to process <a href=#concept-item title=concept-item>items</a> that use them.</p>
+ <p><a href=#item-types>Item types</a> are opaque identifiers, and user agents
+ must not dereference unknown <a href=#item-types>item types</a>, or otherwise
+ deconstruct them, in order to determine how to process <a href=#concept-item title=concept-item>items</a> that use them.</p>
</div>
@@ -57935,7 +57948,7 @@
<li>If the item is a <a href=#typed-item>typed item</a>: a <dfn id=defined-property-name>defined
property name</dfn> allowed in this situation according to the
- specification that defines the <a href=#relevant-type>relevant type</a> for the
+ specification that defines the <a href=#relevant-types>relevant types</a> for the
item, or</li>
<li>If the item is not a <a href=#typed-item>typed item</a>: a string that
@@ -58294,27 +58307,31 @@
representing types. When called, the method must return a
<a href=#live>live</a> <code><a href=#nodelist>NodeList</a></code> object containing all the
elements in the document, in <a href=#tree-order>tree order</a>, that are each
- <a href=#top-level-microdata-items>top-level microdata items</a> with a <a href=#item-type title="item
- type">type</a> equal to one of the types specified in that
- argument, having obtained the types by <a href=#split-a-string-on-spaces title="split a string
- on spaces">splitting the string on spaces</a>. If there are no
- tokens specified in the argument, or if the argument is missing,
- then the method must return a <code><a href=#nodelist>NodeList</a></code> containing all
- the <a href=#top-level-microdata-items>top-level microdata items</a> in the document. When the
- method is invoked on a <code><a href=#document>Document</a></code> object again with the
- same argument, the user agent may return the same object as the
- object returned by the earlier call. In other cases, a new
- <code><a href=#nodelist>NodeList</a></code> object must be returned.</p>
+ <a href=#top-level-microdata-items>top-level microdata items</a> with one of their <a href=#item-types title="item types">types</a> equal to one of the types specified
+ in that argument, having obtained the types by <a href=#split-a-string-on-spaces title="split a
+ string on spaces">splitting the string on spaces</a>. If there
+ are no tokens specified in the argument, or if the argument is
+ missing, then the method must return a <code><a href=#nodelist>NodeList</a></code>
+ containing all the <a href=#top-level-microdata-items>top-level microdata items</a> in the
+ document. When the method is invoked on a <code><a href=#document>Document</a></code>
+ object again with the same argument, the user agent may return the
+ same object as the object returned by the earlier call. In other
+ cases, a new <code><a href=#nodelist>NodeList</a></code> object must be returned.</p>
+ <p class=note>Since a token in the <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> attribute that is not an
+ <a href=#absolute-url>absolute URL</a> is not considered to be one of the item's
+ <a href=#item-types>item types</a>, any tokens passed to <code title=dom-document-getItems><a href=#dom-document-getitems>getItems()</a></code> that are not
+ themselves <a href=#absolute-url title="absolute URL">absolute URLs</a> will not
+ find any items.</p>
+
<p>The <dfn id=dom-itemscope title=dom-itemScope><code>itemScope</code></dfn> IDL
attribute on <a href=#html-elements>HTML elements</a> must <a href=#reflect>reflect</a>
the <code title=attr-itemscope><a href=#attr-itemscope>itemscope</a></code> content attribute.
The <dfn id=dom-itemtype title=dom-itemType><code>itemType</code></dfn> IDL
attribute on <a href=#html-elements>HTML elements</a> must <a href=#reflect>reflect</a>
- the <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> content attribute,
- as if it was a regular string attribute, not a <a href=#url>URL</a>
- string attribute. The <dfn id=dom-itemid title=dom-itemId><code>itemId</code></dfn> IDL attribute on
- <a href=#html-elements>HTML elements</a> must <a href=#reflect>reflect</a> the <code title=attr-itemid><a href=#attr-itemid>itemid</a></code> content attribute. The <dfn id=dom-itemprop title=dom-itemProp><code>itemProp</code></dfn> IDL attribute on
+ the <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> content attribute.
+ The <dfn id=dom-itemid title=dom-itemId><code>itemId</code></dfn> IDL attribute
+ on <a href=#html-elements>HTML elements</a> must <a href=#reflect>reflect</a> the <code title=attr-itemid><a href=#attr-itemid>itemid</a></code> content attribute. The <dfn id=dom-itemprop title=dom-itemProp><code>itemProp</code></dfn> IDL attribute on
<a href=#html-elements>HTML elements</a> must <a href=#reflect>reflect</a> the <code title=attr-itemprop><a href=#names:-the-itemprop-attribute>itemprop</a></code> content attribute. The <dfn id=dom-itemref title=dom-itemRef><code>itemRef</code></dfn> IDL attribute on
<a href=#html-elements>HTML elements</a> must <a href=#reflect>reflect</a> the <code title=attr-itemref><a href=#attr-itemref>itemref</a></code> content attribute.</p>
@@ -58420,7 +58437,7 @@
- <p>An item with the <a href=#item-type>item type</a> <dfn id=md-vcard title=md-vcard><code>http://microformats.org/profile/hcard</code></dfn>
+ <p>An item with the <a href=#item-types title="item types">item type</a> <dfn id=md-vcard title=md-vcard><code>http://microformats.org/profile/hcard</code></dfn>
represents a person's or organization's contact information.</p>
<p>This vocabulary <a href=#support-global-identifiers-for-items title="support global identifiers for
@@ -59509,12 +59526,12 @@
represented by those nodes</dfn> (only the first vCard is
returned):</p>
- <ol><li><p>If none of the nodes in <var title="">nodes</var> are <a href=#concept-item title=concept-item>items</a> with the <a href=#item-type>item type</a>
- <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code>, then
+ <ol><li><p>If none of the nodes in <var title="">nodes</var> are <a href=#concept-item title=concept-item>items</a> with the <a href=#item-types title="item
+ types">item type</a> <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code>, then
there is no vCard. Abort the algorithm, returning nothing.</li>
- <li><p>Let <var title="">node</var> be the first node in <var title="">nodes</var> that is an <a href=#concept-item title=concept-item>item</a> with the <a href=#item-type>item type</a>
- <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code>.</li>
+ <li><p>Let <var title="">node</var> be the first node in <var title="">nodes</var> that is an <a href=#concept-item title=concept-item>item</a> with the <a href=#item-types title="item
+ types">item type</a> <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code>.</li>
<li><p>Let <var title="">output</var> be an empty string.</li>
@@ -59692,7 +59709,7 @@
</ol></dd>
<dt>If the property's <a href=#concept-property-value title=concept-property-value>value</a> is an <a href=#concept-item title=concept-item>item</a> <var title="">subitem</var>
- with the <a href=#item-type>item type</a> <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code>
+ with the <a href=#item-types title="item types">item type</a> <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code>
and <var title="">name</var> is <code title=md-vcard-agent><a href=#md-vcard-agent>agent</a></code></dt>
<dd>
@@ -59918,10 +59935,10 @@
<li><p>Return the mutated <var title="">value</var>.</li>
</ol><p class=note>This algorithm can generate invalid vCard output, if
- the input does not conform to the rules described for the <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code>
- <a href=#item-type>item type</a> and <a href=#defined-property-name title="defined property
- name">defined property names</a>.</p> <!-- of course since vcard
- doesn't define error handling, this is somewhat problematic. -->
+ the input does not conform to the rules described for the <code title=md-vcard><a href=#md-vcard>http://microformats.org/profile/hcard</a></code> <a href=#item-types title="item types">item type</a> and <a href=#defined-property-name title="defined
+ property name">defined property names</a>.</p> <!-- of course
+ since vcard doesn't define error handling, this is somewhat
+ problematic. -->
@@ -60048,7 +60065,7 @@
- <p>An item with the <a href=#item-type>item type</a> <dfn id=md-vevent title=md-vevent><code>http://microformats.org/profile/hcalendar#vevent</code></dfn>
+ <p>An item with the <a href=#item-types title="item types">item type</a> <dfn id=md-vevent title=md-vevent><code>http://microformats.org/profile/hcalendar#vevent</code></dfn>
represents an event.</p>
<p>This vocabulary <a href=#support-global-identifiers-for-items title="support global identifiers for
@@ -60747,7 +60764,7 @@
</ol><p class=note>This algorithm can generate invalid iCalendar
output, if the input does not conform to the rules described for the
<code title=md-vevent><a href=#md-vevent>http://microformats.org/profile/hcalendar#vevent</a></code>
- <a href=#item-type>item type</a> and <a href=#defined-property-name title="defined property
+ <a href=#item-types title="item types">item type</a> and <a href=#defined-property-name title="defined property
name">defined property names</a>.</p> <!-- of course since
iCalendar doesn't define error handling, this is somewhat
problematic. -->
@@ -60789,7 +60806,7 @@
<pre>function getCalendar(node) {
// This function assumes the content is valid.
// It is not a compliant implementation of the algorithm for <a href=#extracting-vevent-data>extracting vEvent data</a>.
- while (node && (!node.itemScope || !node.itemType == 'http://microformats.org/profile/hcalendar#vevent'))
+ while (node && (!node.itemScope || !node.itemType.contains('http://microformats.org/profile/hcalendar#vevent')))
node = node.parentNode;
if (!node) {
alert('No event data found.');
@@ -60849,7 +60866,7 @@
- <p>An item with the <a href=#item-type>item type</a> <dfn id=md-work title=md-work><code>http://n.whatwg.org/work</code></dfn>
+ <p>An item with the <a href=#item-types title="item types">item type</a> <dfn id=md-work title=md-work><code>http://n.whatwg.org/work</code></dfn>
represents a work (e.g. an article, an image, a video, a song,
etc). This type is primarily intended to allow authors to include
licensing information for works.</p>
@@ -60988,11 +61005,17 @@
<li><p>Add <var title="">item</var> to <var title="">memory</var>.</li>
- <li><p>If the <var title="">item</var> has an <a href=#item-type>item
- type</a>, add an entry to <var title="">result</var> called
- "<code title="">type</code>" whose value is the <a href=#item-type>item
- type</a> of <var title="">item</var>.</li>
+ <li><p>If the <var title="">item</var> has any <a href=#item-types>item
+ types</a>, add an entry to <var title="">result</var> called
+ "<code title="">type</code>" whose value is an array listing the
+ <a href=#item-types>item types</a> of <var title="">item</var>, in the order
+ they were specified on the <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> attribute.</p>
+ <p class=note>Since only <a href=#absolute-url title="absolute URL">absolute
+ URLs</a> can be <a href=#item-types>item types</a>, any tokens in the <code title=attr-itemtype><a href=#attr-itemtype>itemtype</a></code> attribute that are not <a href=#absolute-url title="absolute URL">absolute URLs</a> are dropped.</li> <!--
+ the array is never empty, though, since if they were all dropped
+ then there would be no item types either -->
+
<li><p>If the <var title="">item</var> has a <a href=#global-identifier>global
identifier</a>, add an entry to <var title="">result</var>
called "<code title="">id</code>" whose value is the <a href=#global-identifier>global
@@ -100007,8 +100030,8 @@
<td> <a href=#boolean-attribute>Boolean attribute</a>
<tr><th> <code title="">itemtype</code>
<td> <a href=#attr-itemtype title=attr-itemtype>HTML elements</a>
- <td> <a href=#item-type>Item type</a> of a microdata item
- <td> <a href=#absolute-url title="absolute URL">Valid absolute URL</a>*
+ <td> <a href=#item-types>Item types</a> of a microdata item
+ <td> <a href=#unordered-set-of-unique-space-separated-tokens>Unordered set of unique space-separated tokens</a>, <a href=#case-sensitive>case-sensitive</a>, consisting of <a href=#absolute-url title="absolute URL">valid absolute URL</a>*
<!--MD-->
<tr><th> <code title="">keytype</code>
<td> <code title=attr-keygen-keytype><a href=#attr-keygen-keytype>keygen</a></code>
Modified: source
===================================================================
--- source 2011-10-11 23:47:06 UTC (rev 6667)
+++ source 2011-10-12 00:13:17 UTC (rev 6668)
@@ -10478,7 +10478,7 @@
<!--END w3c-html--><!--MD--> // <span>microdata</span> <!--WARNING: ALSO DUPLICATED IN MICRODATA SECTION-->
attribute boolean <span title="dom-itemScope">itemScope</span>;
- attribute DOMString <span title="dom-itemType">itemType</span>;
+ [PutForwards=<span title="dom-DOMSettableTokenList-value">value</span>] readonly attribute <span>DOMSettableTokenList</span> <span title="dom-itemType">itemType</span>;
attribute DOMString <span title="dom-itemId">itemId</span>;
[PutForwards=<span title="dom-DOMSettableTokenList-value">value</span>] readonly attribute <span>DOMSettableTokenList</span> <span title="dom-itemRef">itemRef</span>;
[PutForwards=<span title="dom-DOMSettableTokenList-value">value</span>] readonly attribute <span>DOMSettableTokenList</span> <span title="dom-itemProp">itemProp</span>;
@@ -64845,12 +64845,23 @@
</div>
- <p>An item can only have one type. The type gives the context for
- the properties, thus defining a vocabulary: a property named "class"
- 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.</p>
+ <p>The type gives the context for the properties, thus defining a
+ vocabulary: a property named "class" 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. Several types can share a
+ vocabulary. For example, the types "<code
+ title="">http://example.org/people/teacher</code>" and "<code
+ title="">http://example.org/people/engineer</code>" could be defined
+ to use the same vocabulary (though maybe some properties would not
+ be especially useful in both cases, e.g. maybe the "<code
+ title="">http://example.org/people/engineer</code>" type might not
+ typically be used with the "<code title="">classroom</code>"
+ property). Multiple types defined to use the same vocabulary can be
+ given for a single item by listing the URLs as a space-separated
+ list in the attribute' value. An item cannot be given two types if
+ they do not use the same vocabulary, however.</p>
<h4>Global identifiers for items</h4>
@@ -65018,7 +65029,7 @@
title="dom-itemScope">element.itemScope</code> IDL attribute set to
true.</p>
- <p>The type of <span title="concept-item">items</span> can be
+ <p>The type(s) of <span title="concept-item">items</span> can be
obtained using the <code
title="dom-itemType">element.itemType</code> IDL attribute on the
element with the <code title="attr-itemscope">itemscope</code>
@@ -65028,8 +65039,8 @@
<p>This sample shows how the <code
title="dom-document-getItems">getItems()</code> method can be used
- to obtain a list of all the top-level microdata items of one type
- given in the document:</p>
+ to obtain a list of all the top-level microdata items of a
+ particular type given in the document:</p>
<pre>var cats = document.getItems("http://example.com/feline");</pre>
@@ -65170,14 +65181,14 @@
as <span title="concept-item">items</span>.</p>
<p>Each group is known as an <span title="concept-item">item</span>.
- Each <span title="concept-item">item</span> can have an <span>item
- type</span>, a <span>global identifier</span> (if the <span>item
- type</span> <span title="support global identifiers for
- items">supports global identifiers for its items</span>), and a list
- of name-value pairs. Each name in the name-value pair is known as a
- <span title="the properties of an item">property</span>, and each
- <span title="the properties of an item">property</span> has one or
- more <span title="concept-property-value">values</span>. Each <span
+ Each <span title="concept-item">item</span> can have <span>item
+ types</span>, a <span>global identifier</span> (if the vocabulary
+ specified by the <span>item types</span> <span>support global
+ identifiers for items</span>), and a list of name-value pairs. Each
+ name in the name-value pair is known as a <span title="the
+ properties of an item">property</span>, and each <span title="the
+ properties of an item">property</span> has one or more <span
+ title="concept-property-value">values</span>. Each <span
title="concept-property-value">value</span> is either a string or
itself a group of name-value pairs (an <span
title="concept-item">item</span>). The names are unordered relative
@@ -65185,14 +65196,16 @@
have a relative order.</p>
<p>An <span title="concept-item">item</span> is said to be a
- <dfn>typed item</dfn> when either it has an <span>item type</span>,
- or it is the <span title="concept-property-value">value</span> of a <span title="the properties of an
- item">property</span> of a <span>typed item</span>. The
- <dfn>relevant type</dfn> for a <span>typed item</span> is the <span
- title="concept-item">item</span>'s <span>item type</span>, if it has
- one, or else is the <span>relevant type</span> of the <span
+ <dfn>typed item</dfn> when either it has an <span title="item
+ types">item type</span>, or it is the <span
+ title="concept-property-value">value</span> of a <span title="the
+ properties of an item">property</span> of a <span>typed item</span>.
+ The <dfn>relevant types</dfn> for a <span>typed item</span> is the
+ <span title="concept-item">item</span>'s <span>item types</span>, if
+ it has one, or else is the <span>relevant types</span> of the <span
title="concept-item">item</span> for which it is a <span title="the
- properties of an item">property</span>'s <span title="concept-property-value">value</span>.</p>
+ properties of an item">property</span>'s <span
+ title="concept-property-value">value</span>.</p>
@@ -65212,42 +65225,47 @@
<p>Elements with an <code title="attr-itemscope">itemscope</code>
attribute may have an <dfn
title="attr-itemtype"><code>itemtype</code></dfn> attribute
- specified, to give the <span>item type</span> of the <span
+ specified, to give the <span>item types</span> of the <span
title="concept-item">item</span>.</p>
<p>The <code title="attr-itemtype">itemtype</code> attribute, if
- specified, must have a value that is a <span>valid URL</span> that
- is an <span>absolute URL</span>.</p>
+ specified, must have a value that is an <span>unordered set of
+ unique space-separated tokens</span> that are
+ <span>case-sensitive</span>, each of which is a <span>valid
+ URL</span> that is an <span>absolute URL</span>, and all of which
+ are defined to use the same vocabulary.</p>
- <p>The <dfn>item type</dfn> of an <span
- title="concept-item">item</span> is the value of its element's <code
- title="attr-itemtype">itemtype</code> attribute, if it has one and
- its value is not the empty string. If the <code
- title="attr-itemtype">itemtype</code> attribute is missing or its
- value is the empty string, the <span
+ <p>The <dfn>item types</dfn> of an <span
+ title="concept-item">item</span> are the <span title="absolute
+ URL">absolute URLs</span> obtained by <span title="split a string on
+ spaces">splitting the element's <code
+ title="attr-itemtype">itemtype</code> attribute's value on
+ spaces</span>. If the <code title="attr-itemtype">itemtype</code>
+ attribute is missing or parsing it in this way finds no tokens that
+ are <span title="absolute URL">absolute URLs</span>, the <span
title="concept-item">item</span> is said to have no <span>item
- type</span>.</p>
+ types</span>.</p>
- <p>The <span>item type</span> must be a type defined in an <span
+ <p>The <span>item types</span> must all be types defined in <span
title="other applicable specifications">applicable
- specification</span>.</p>
+ specifications</span> and must all be defined to use the same
+ vocabulary.</p>
<div class="impl">
- <p>Except if otherwise specified by that specification, the
- <span>URL</span> given as the <span>item type</span> should not be
- automatically dereferenced.</p>
+ <p>Except if otherwise specified by that specification, the <span
+ title="URL">URLs</span> given as the <span>item types</span> should
+ not be automatically dereferenced.</p>
- <p class="note">A specification could define that its <span>item
- type</span> can be derefenced to provide the user with help
- information, for example. In fact, vocabulary authors are
- encouraged to provide useful information at the given
+ <p class="note">A specification could define that its <span
+ title="item types">item type</span> can be derefenced to provide
+ the user with help information, for example. In fact, vocabulary
+ authors are encouraged to provide useful information at the given
<span>URL</span>.</p>
- <p><span title="item type">Item types</span> are opaque
- identifiers, and user agents must not dereference unknown <span
- title="item type">item types</span>, or otherwise deconstruct them,
- in order to determine how to process <span
+ <p><span>Item types</span> are opaque identifiers, and user agents
+ must not dereference unknown <span>item types</span>, or otherwise
+ deconstruct them, in order to determine how to process <span
title="concept-item">items</span> that use them.</p>
</div>
@@ -65352,7 +65370,7 @@
<li>If the item is a <span>typed item</span>: a <dfn>defined
property name</dfn> allowed in this situation according to the
- specification that defines the <span>relevant type</span> for the
+ specification that defines the <span>relevant types</span> for the
item, or</li>
<li>If the item is not a <span>typed item</span>: a string that
@@ -65721,7 +65739,7 @@
partial interface <span>HTMLElement</span> {
// <span>microdata</span> <!--WARNING: ALSO DUPLICATED IN HTMLElement SECTION-->
attribute boolean <span title="dom-itemScope">itemScope</span>;
- attribute DOMString <span title="dom-itemType">itemType</span>;
+ [PutForwards=<span title="dom-DOMSettableTokenList-value">value</span>] readonly attribute <span>DOMSettableTokenList</span> <span title="dom-itemType">itemType</span>;
attribute DOMString <span title="dom-itemId">itemId</span>;
[PutForwards=<span title="dom-DOMSettableTokenList-value">value</span>] readonly attribute <span>DOMSettableTokenList</span> <span title="dom-itemRef">itemRef</span>;
[PutForwards=<span title="dom-DOMSettableTokenList-value">value</span>] readonly attribute <span>DOMSettableTokenList</span> <span title="dom-itemProp">itemProp</span>;
@@ -65782,28 +65800,34 @@
representing types. When called, the method must return a
<span>live</span> <code>NodeList</code> object containing all the
elements in the document, in <span>tree order</span>, that are each
- <span>top-level microdata items</span> with a <span title="item
- type">type</span> equal to one of the types specified in that
- argument, having obtained the types by <span title="split a string
- on spaces">splitting the string on spaces</span>. If there are no
- tokens specified in the argument, or if the argument is missing,
- then the method must return a <code>NodeList</code> containing all
- the <span>top-level microdata items</span> in the document. When the
- method is invoked on a <code>Document</code> object again with the
- same argument, the user agent may return the same object as the
- object returned by the earlier call. In other cases, a new
- <code>NodeList</code> object must be returned.</p>
+ <span>top-level microdata items</span> with one of their <span
+ title="item types">types</span> equal to one of the types specified
+ in that argument, having obtained the types by <span title="split a
+ string on spaces">splitting the string on spaces</span>. If there
+ are no tokens specified in the argument, or if the argument is
+ missing, then the method must return a <code>NodeList</code>
+ containing all the <span>top-level microdata items</span> in the
+ document. When the method is invoked on a <code>Document</code>
+ object again with the same argument, the user agent may return the
+ same object as the object returned by the earlier call. In other
+ cases, a new <code>NodeList</code> object must be returned.</p>
+ <p class="note">Since a token in the <code
+ title="attr-itemtype">itemtype</code> attribute that is not an
+ <span>absolute URL</span> is not considered to be one of the item's
+ <span>item types</span>, any tokens passed to <code
+ title="dom-document-getItems">getItems()</code> that are not
+ themselves <span title="absolute URL">absolute URLs</span> will not
+ find any items.</p>
+
<p>The <dfn title="dom-itemScope"><code>itemScope</code></dfn> IDL
attribute on <span>HTML elements</span> must <span>reflect</span>
the <code title="attr-itemscope">itemscope</code> content attribute.
The <dfn title="dom-itemType"><code>itemType</code></dfn> IDL
attribute on <span>HTML elements</span> must <span>reflect</span>
- the <code title="attr-itemtype">itemtype</code> content attribute,
- as if it was a regular string attribute, not a <span>URL</span>
- string attribute. The <dfn
- title="dom-itemId"><code>itemId</code></dfn> IDL attribute on
- <span>HTML elements</span> must <span>reflect</span> the <code
+ the <code title="attr-itemtype">itemtype</code> content attribute.
+ The <dfn title="dom-itemId"><code>itemId</code></dfn> IDL attribute
+ on <span>HTML elements</span> must <span>reflect</span> the <code
title="attr-itemid">itemid</code> content attribute. The <dfn
title="dom-itemProp"><code>itemProp</code></dfn> IDL attribute on
<span>HTML elements</span> must <span>reflect</span> the <code
@@ -65978,7 +66002,7 @@
<!--START vCard-->
- <p>An item with the <span>item type</span> <dfn
+ <p>An item with the <span title="item types">item type</span> <dfn
title="md-vcard"><code>http://microformats.org/profile/hcard</code></dfn>
represents a person's or organization's contact information.</p>
@@ -67323,15 +67347,15 @@
<ol>
<li><p>If none of the nodes in <var title="">nodes</var> are <span
- title="concept-item">items</span> with the <span>item type</span>
- <code
+ title="concept-item">items</span> with the <span title="item
+ types">item type</span> <code
title="md-vcard">http://microformats.org/profile/hcard</code>, then
there is no vCard. Abort the algorithm, returning nothing.</p></li>
<li><p>Let <var title="">node</var> be the first node in <var
title="">nodes</var> that is an <span
- title="concept-item">item</span> with the <span>item type</span>
- <code
+ title="concept-item">item</span> with the <span title="item
+ types">item type</span> <code
title="md-vcard">http://microformats.org/profile/hcard</code>.</p></li>
<li><p>Let <var title="">output</var> be an empty string.</p></li>
@@ -67576,7 +67600,7 @@
<dt>If the property's <span
title="concept-property-value">value</span> is an <span
title="concept-item">item</span> <var title="">subitem</var>
- with the <span>item type</span> <code
+ with the <span title="item types">item type</span> <code
title="md-vcard">http://microformats.org/profile/hcard</code>
and <var title="">name</var> is <code
title="md-vcard-agent">agent</code></dt>
@@ -67902,10 +67926,11 @@
<p class="note">This algorithm can generate invalid vCard output, if
the input does not conform to the rules described for the <code
- title="md-vcard">http://microformats.org/profile/hcard</code>
- <span>item type</span> and <span title="defined property
- name">defined property names</span>.</p> <!-- of course since vcard
- doesn't define error handling, this is somewhat problematic. -->
+ title="md-vcard">http://microformats.org/profile/hcard</code> <span
+ title="item types">item type</span> and <span title="defined
+ property name">defined property names</span>.</p> <!-- of course
+ since vcard doesn't define error handling, this is somewhat
+ problematic. -->
@@ -68032,7 +68057,7 @@
<!--START vEvent-->
- <p>An item with the <span>item type</span> <dfn
+ <p>An item with the <span title="item types">item type</span> <dfn
title="md-vevent"><code>http://microformats.org/profile/hcalendar#vevent</code></dfn>
represents an event.</p>
@@ -68900,7 +68925,7 @@
output, if the input does not conform to the rules described for the
<code
title="md-vevent">http://microformats.org/profile/hcalendar#vevent</code>
- <span>item type</span> and <span title="defined property
+ <span title="item types">item type</span> and <span title="defined property
name">defined property names</span>.</p> <!-- of course since
iCalendar doesn't define error handling, this is somewhat
problematic. -->
@@ -68942,7 +68967,7 @@
<pre>function getCalendar(node) {
// This function assumes the content is valid.
// It is not a compliant implementation of the algorithm for <span>extracting vEvent data</span>.
- while (node && (!node.itemScope || !node.itemType == 'http://microformats.org/profile/hcalendar#vevent'))
+ while (node && (!node.itemScope || !node.itemType.contains('http://microformats.org/profile/hcalendar#vevent')))
node = node.parentNode;
if (!node) {
alert('No event data found.');
@@ -69002,7 +69027,7 @@
<!--START work-->
- <p>An item with the <span>item type</span> <dfn
+ <p>An item with the <span title="item types">item type</span> <dfn
title="md-work"><code>http://n.whatwg.org/work</code></dfn>
represents a work (e.g. an article, an image, a video, a song,
etc). This type is primarily intended to allow authors to include
@@ -69173,11 +69198,20 @@
<li><p>Add <var title="">item</var> to <var
title="">memory</var>.</p></li>
- <li><p>If the <var title="">item</var> has an <span>item
- type</span>, add an entry to <var title="">result</var> called
- "<code title="">type</code>" whose value is the <span>item
- type</span> of <var title="">item</var>.</p></li>
+ <li><p>If the <var title="">item</var> has any <span>item
+ types</span>, add an entry to <var title="">result</var> called
+ "<code title="">type</code>" whose value is an array listing the
+ <span>item types</span> of <var title="">item</var>, in the order
+ they were specified on the <code
+ title="attr-itemtype">itemtype</code> attribute.</p>
+ <p class="note">Since only <span title="absolute URL">absolute
+ URLs</span> can be <span>item types</span>, any tokens in the <code
+ title="attr-itemtype">itemtype</code> attribute that are not <span
+ title="absolute URL">absolute URLs</span> are dropped.</li> <!--
+ the array is never empty, though, since if they were all dropped
+ then there would be no item types either -->
+
<li><p>If the <var title="">item</var> has a <span>global
identifier</span>, add an entry to <var title="">result</var>
called "<code title="">id</code>" whose value is the <span>global
@@ -113638,8 +113672,8 @@
<tr>
<th> <code title="">itemtype</code>
<td> <span title="attr-itemtype">HTML elements</span>
- <td> <span>Item type</span> of a microdata item
- <td> <span title="absolute URL">Valid absolute URL</span>*
+ <td> <span>Item types</span> of a microdata item
+ <td> <span>Unordered set of unique space-separated tokens</span>, <span>case-sensitive</span>, consisting of <span title="absolute URL">valid absolute URL</span>*
<!--START w3c-html--><!--MD-->
<tr>
<th> <code title="">keytype</code>
More information about the Commit-Watchers
mailing list