- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 16 May 2009 02:02:54 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv7551
Modified Files:
Overview.html
Log Message:
Changed HTMLPropertyCollection to always return PropertyNodeLists when accessed by name. Make itemprop=about only work for RDF on the linking elements. vCard output support. Minor tweaks to microdata. Editorial fixes. (whatwg r3105)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2262
retrieving revision 1.2263
diff -u -d -r1.2262 -r1.2263
--- Overview.html 15 May 2009 00:36:53 -0000 1.2262
+++ Overview.html 16 May 2009 02:02:52 -0000 1.2263
@@ -152,7 +152,7 @@
<h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
<!--ZZZ:-->
<!--<h2 class="no-num no-toc">W3C Working Draft 23 April 2009</h2>-->
- <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 15 May 2009</h2>
+ <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 16 May 2009</h2>
<!--:ZZZ-->
<dl><!-- ZZZ: update the month/day (twice), (un)comment out
<dt>This Version:</dt>
@@ -245,7 +245,7 @@
track.
<!--ZZZ:-->
<!--This specification is the 23 April 2009 Working Draft.-->
- This specification is the 15 May 2009 Editor's Draft.
+ This specification is the 16 May 2009 Editor's Draft.
<!--:ZZZ-->
</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href="http://www.whatwg.org/">WHATWG</a>. The two specifications are
identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of)
@@ -1912,6 +1912,11 @@
<p>The <dfn id="white_space" title="White_Space">White_Space characters</dfn> are
those that have the Unicode property "White_Space". <a href="#references">[UNICODE]</a></p>
+ <p>The <dfn id="alphanumeric-ascii-characters">alphanumeric ASCII characters</dfn> are those in the
+ ranges U+0030 DIGIT ZERO .. U+0039 DIGIT NINE, U+0041 LATIN CAPITAL
+ LETTER A .. U+005A LATIN CAPITAL LETTER Z, U+0061 LATIN SMALL LETTER
+ A .. U+007A LATIN SMALL LETTER Z.</p>
+
<p>Some of the micro-parsers described below follow the pattern of
having an <var title="">input</var> variable that holds the string
being parsed, and having a <var title="">position</var> variable
@@ -5909,15 +5914,16 @@
model.<pre class="idl">[Callable=<a href="#dom-htmlpropertycollection-nameditem" title="dom-HTMLPropertyCollection-namedItem">namedItem</a>]
interface <dfn id="htmlpropertycollection-0">HTMLPropertyCollection</dfn> {
readonly attribute unsigned long <a href="#dom-htmlpropertycollection-length" title="dom-HTMLPropertyCollection-length">length</a>;
- readonly attribute <span>DOMStringList</span> <a href="#dom-htmlpropertycollection-names" title="dom-HTMLPropertyCollection-names">names</a>;
[IndexGetter] <a href="#htmlelement">HTMLElement</a> <a href="#dom-htmlpropertycollection-item" title="dom-HTMLPropertyCollection-item">item</a>(in unsigned long index);
- [NameGetter] Object <a href="#dom-htmlpropertycollection-nameditem" title="dom-HTMLPropertyCollection-namedItem">namedItem</a>(in DOMString name);
+
+ readonly attribute <span>DOMStringList</span> <a href="#dom-htmlpropertycollection-names" title="dom-HTMLPropertyCollection-names">names</a>;
+ [NameGetter] <a href="#propertynodelist">PropertyNodeList</a> <a href="#dom-htmlpropertycollection-nameditem" title="dom-HTMLPropertyCollection-namedItem">namedItem</a>(in DOMString name);
};
-typedef sequence<DOMString> <dfn id="domstringarray">DOMStringArray</dfn>;
+typedef sequence<any> <dfn id="propertyvaluearray">PropertyValueArray</dfn>;
interface <dfn id="propertynodelist">PropertyNodeList</dfn> : <span>NodeList</span> {
- attribute <a href="#domstringarray">DOMStringArray</a> <a href="#dom-propertynodelist-content" title="dom-PropertyNodeList-content">content</a>;
+ attribute <a href="#propertyvaluearray">PropertyValueArray</a> <a href="#dom-propertynodelist-content" title="dom-PropertyNodeList-content">content</a>;
};</pre><dl class="domintro"><dt><var title="">collection</var> . <code title="dom-HTMLPropertyCollection-length"><a href="#dom-htmlpropertycollection-length">length</a></code></dt>
<dd>
<p>Returns the number of elements in the collection.</p>
@@ -5940,9 +5946,7 @@
<dt><var title="">collection</var>[<var title="">name</var>]</dt>
<dt><var title="">collection</var>(<var title="">name</var>)</dt>
<dd>
- <p>Returns the element with that adds the property named <var title="">name</var> from the collection.</p>
- <p>If there are multiple matching elements, then a <code><a href="#propertynodelist">PropertyNodeList</a></code> object containing all those elements is returned.</p>
- <p>Returns null if no element adds the property named <var title="">name</var>.</p>
+ <p>Returns a <code><a href="#propertynodelist">PropertyNodeList</a></code> object containing any elements that add a property named <var title="">name</var>.</p>
</dd>
<dt><var title="">propertyNodeList</var> . <var title="">content</var></dt>
@@ -5965,14 +5969,6 @@
attribute must return the number of nodes <a href="#represented-by-the-collection">represented by the
collection</a>.</p>
- <p>The <dfn id="dom-htmlpropertycollection-names" title="dom-HTMLPropertyCollection-names"><code>names</code></dfn>
- attribute must return a live <code>DOMStringList</code> object
- giving the <a href="#property-names">property names</a> of all the elements
- <a href="#represented-by-the-collection">represented by the collection</a>, listed in <a href="#tree-order">tree
- order</a>, but with duplicates removed, leaving only the first
- occurrence of each name. The same object must be returned each
- time.</p>
-
<p>The <dfn id="dom-htmlpropertycollection-item" title="dom-HTMLPropertyCollection-item"><code>item(<var title="">index</var>)</code></dfn> method must return the <var title="">index</var>th node in the collection. If there is no <var title="">index</var>th node in the collection, then the method must
return null.</p>
@@ -5980,32 +5976,31 @@
of the <a href="#property-names">property names</a> of all the elements
<a href="#represented-by-the-collection">represented by the collection</a>.</p>
- <p>The <dfn id="dom-htmlpropertycollection-nameditem" title="dom-HTMLPropertyCollection-namedItem"><code>namedItem(<var title="">name</var>)</code></dfn> method must act according to the
- following algorithm:</p>
-
- <ol><li>If, at the time the method is called, there is exactly one node
- in the collection that has a <a href="#property-names" title="property names">property
- name</a> equal to <var title="">name</var>, then return that
- node and stop the algorithm.</li>
-
- <li>Otherwise, if there are no nodes in the collection that have a
- <a href="#property-names" title="property names">property name</a> equal to <var title="">name</var>, then return null and stop the algorithm.</li>
-
- <li>Otherwise, create a <code><a href="#propertynodelist">PropertyNodeList</a></code> object
- representing a live view of the <code><a href="#htmlpropertycollection-0">HTMLPropertyCollection</a></code>
- object, further filtered so that the only nodes in the
- <code><a href="#radionodelist">RadioNodeList</a></code> object are those that have a <a href="#property-names" title="property names">property name</a> equal to <var title="">name</var>. The nodes in the <code><a href="#propertynodelist">PropertyNodeList</a></code>
- object must be sorted in <a href="#tree-order">tree order</a>.</li>
+ <p>The <dfn id="dom-htmlpropertycollection-names" title="dom-HTMLPropertyCollection-names"><code>names</code></dfn>
+ attribute must return a live <code>DOMStringList</code> object
+ giving the <a href="#property-names">property names</a> of all the elements
+ <a href="#represented-by-the-collection">represented by the collection</a>, listed in <a href="#tree-order">tree
+ order</a>, but with duplicates removed, leaving only the first
+ occurrence of each name. The same object must be returned each
+ time.</p>
- <li>Return that <code><a href="#propertynodelist">PropertyNodeList</a></code> object.</li>
+ <p>The <dfn id="dom-htmlpropertycollection-nameditem" title="dom-HTMLPropertyCollection-namedItem"><code>namedItem(<var title="">name</var>)</code></dfn> method must return a
+ <code><a href="#propertynodelist">PropertyNodeList</a></code> object representing a live view of the
+ <code><a href="#htmlpropertycollection-0">HTMLPropertyCollection</a></code> object, further filtered so that
+ the only nodes in the <code><a href="#radionodelist">RadioNodeList</a></code> object are those
+ that have a <a href="#property-names" title="property names">property name</a> equal
+ to <var title="">name</var>. The nodes in the
+ <code><a href="#propertynodelist">PropertyNodeList</a></code> object must be sorted in <a href="#tree-order">tree
+ order</a>, and the same object must be returned each time a
+ particular <var title="">name</var> is queried.</p>
- </ol><hr><p>A members of the <code><a href="#propertynodelist">PropertyNodeList</a></code> interface
+ <hr><p>A members of the <code><a href="#propertynodelist">PropertyNodeList</a></code> interface
inherited from the <code>NodeList</code> interface must behave as
they would on a <code>NodeList</code> object.</p>
<p>The <dfn id="dom-propertynodelist-content" title="dom-PropertyNodeList-content"><code>content</code></dfn> DOM
attribute on the <code><a href="#propertynodelist">PropertyNodeList</a></code> object, on getting,
- must return a newly constructed <code><a href="#domstringarray">DOMStringArray</a></code> whose
+ must return a newly constructed <code>DOMStringArray</code> whose
values are the values obtained from the <code title="dom-content"><a href="#dom-content">content</a></code> DOM property of each of the
elements represented by the object, in <a href="#tree-order">tree order</a>.</p>
@@ -36495,7 +36490,8 @@
attribute returns an <code><a href="#htmlpropertycollection-0">HTMLPropertyCollection</a></code>, which can
be enumerated to go through each element that adds one or more
properties to the item. It can also be indexed by name, which will
- return the property with that name (if there is just one).<p>Each element that adds a property also has a <code title="dom-content"><a href="#dom-content">content</a></code> DOM attribute that returns its
+ return an object with a list of the elements that add properties
+ with that name.<p>Each element that adds a property also has a <code title="dom-content"><a href="#dom-content">content</a></code> DOM attribute that returns its
value.
<div class="example">
@@ -36505,35 +36501,30 @@
"net.example.name" property from that item.</p>
<pre>var user = getItems('net.example.user')[0];
-alert('Hello ' + user.properties['net.example.name'].content + '!');</pre>
+alert('Hello ' + user.properties['net.example.name'][0].content + '!');</pre>
- </div><p>When an item has multiple properties with the same name, the
- <code><a href="#htmlpropertycollection-0">HTMLPropertyCollection</a></code> returns a
- <code><a href="#propertynodelist">PropertyNodeList</a></code> object with all those properties
- instead of returning just one. The <code><a href="#propertynodelist">PropertyNodeList</a></code>
- object can be used to obtained all the values at once using
- <em>its</em> <code title="dom-PropertyNodeList-content"><a href="#dom-propertynodelist-content">content</a></code> attribute, which
+ </div><p>The <code><a href="#htmlpropertycollection-0">HTMLPropertyCollection</a></code> object, when indexed by
+ name in this way, actually returns a <code><a href="#propertynodelist">PropertyNodeList</a></code>
+ object with all the matching properties. The
+ <code><a href="#propertynodelist">PropertyNodeList</a></code> object can be used to obtained all the
+ values at once using <em>its</em> <code title="dom-PropertyNodeList-content"><a href="#dom-propertynodelist-content">content</a></code> attribute, which
returns an array of all the values.<div class="example">
<p>In an earlier example, a "com.example.feline" item had two
- "com.example.color" values. This script looks up such items and
- then lists all their values. Because it doesn't know ahead of time
- if the item has zero, one, or more colors, it checks whether the
- value returned from the <code><a href="#htmlpropertycollection-0">HTMLPropertyCollection</a></code> is a
- <code><a href="#propertynodelist">PropertyNodeList</a></code> (multiple colors), just a regular
- element (one color), or null (no colors) before using it.</p>
+ "com.example.color" values. This script looks up the first such
+ item and then lists all its values.</p>
<pre>var cat = getItems('com.example.feline')[0];
-var colors = cat.properties['com.example.color'];
+var colors = cat.properties['com.example.color'].content;
var result;
-if (!colors) {
+if (colors.length == 0) {
result = 'Color unknown.';
-} else if (colors instanceof PropertyNodeList) {
- result = 'Colors:';
- for (var i = 0; i < colors.content.length; i += 1)
- result += ' ' + colors.content[i];
+} else if (colors.length == 1) {
+ result = 'Color: ' + colors[0];
} else {
- result = 'Color: ' + colors.content;
+ result = 'Colors:';
+ for (var i = 0; i < colors.length; i += 1)
+ result += ' ' + colors[i];
}</pre>
</div><p>It's also possible to get a list of all the <a href="#property-names">property
@@ -36746,12 +36737,14 @@
<dd><p>The value is the element's
<code><a href="#textcontent">textContent</a></code>.</dd>
- </dl><p>If a property's <a href="#concept-property-value" title="concept-property-value">value</a>
+ </dl><p>The <dfn id="url-property-elements">URL property elements</dfn> are the <code><a href="#the-a-element">a</a></code>,
+ <code><a href="#the-area-element">area</a></code>, <code><a href="#audio">audio</a></code>, <code><a href="#the-embed-element">embed</a></code>,
+ <code><a href="#the-iframe-element">iframe</a></code>, <code><a href="#the-img-element">img</a></code>, <code><a href="#the-link-element">link</a></code>,
+ <code><a href="#the-object-element">object</a></code>, <code><a href="#the-source-element">source</a></code>, and <code><a href="#video">video</a></code>
+ elements.<p>If a property's <a href="#concept-property-value" title="concept-property-value">value</a>
is an <a href="#absolute-url">absolute URL</a>, the property must be specified
- using an <code><a href="#the-a-element">a</a></code>, <code><a href="#the-area-element">area</a></code>, <code><a href="#audio">audio</a></code>,
- <code><a href="#the-embed-element">embed</a></code>, <code><a href="#the-iframe-element">iframe</a></code>, <code><a href="#the-img-element">img</a></code>,
- <code><a href="#the-link-element">link</a></code>, <code><a href="#the-object-element">object</a></code>, <code><a href="#the-source-element">source</a></code>, or
- <code><a href="#video">video</a></code> element.<h3 id="microdata-dom-api"><span class="secno">5.3 </span>Microdata DOM API</h3><dl class="domintro"><dt><var title="">document</var> . <code title="dom-items">items</code></dt>
+ using an <a href="#url-property-elements" title="URL property elements">URL property
+ element</a>.<h3 id="microdata-dom-api"><span class="secno">5.3 </span>Microdata DOM API</h3><dl class="domintro"><dt><var title="">document</var> . <code title="dom-items">items</code></dt>
<dd>
@@ -36925,28 +36918,7 @@
<li>First Last</li>
- </ul><p>User agents must run the following steps to convert the <code title="md-vcard-fn"><a href="#md-vcard-fn">fn</a></code> property's <a href="#concept-property-value" title="concept-property-value">value</a> into an implied
- <code title="md-vcard-n-family-name"><a href="#md-vcard-n-family-name">family-name</a></code>/<code title="md-vcard-n-given-name"><a href="#md-vcard-n-given-name">given-name</a></code> pair:</p>
-
- <ol><li><p>Let <var title="">value</var> be the <code title="md-vcard-fn"><a href="#md-vcard-fn">fn</a></code> property's <a href="#concept-property-value" title="concept-property-value">value</a>.</li>
-
- <li><p><a href="#split-a-string-on-spaces" title="split a string on spaces">Split <var title="">value</var> on spaces</a>, and let <var title="">part one</var> be the first resulting token, and <var title="">part two</var> be the second.</li>
-
- <li><p>If the last character of <var title="">part one</var> is
- a U+002C COMMA character (,), then remove that character from
- <var title="">part one</var> and let the implied <code title="md-vcard-n-family-name"><a href="#md-vcard-n-family-name">family-name</a></code> be <var title="">part one</var> and the implied <code title="md-vcard-n-given-name"><a href="#md-vcard-n-given-name">given-name</a></code> be <var title="">part two</var>.</li>
-
- <li><p>Otherwise, if <var title="">part two</var> is two
- Unicode code-points long and its second character is a U+002E
- FULL STOP character (.), then let the implied <code title="md-vcard-n-family-name"><a href="#md-vcard-n-family-name">family-name</a></code> be <var title="">part one</var> and the implied <code title="md-vcard-n-given-name"><a href="#md-vcard-n-given-name">given-name</a></code> be the first
- character of <var title="">part two</var>.</li>
-
- <li><p>Otherwise, if <var title="">part two</var> is one
- Unicode code-point long, then let the implied <code title="md-vcard-n-family-name"><a href="#md-vcard-n-family-name">family-name</a></code> be <var title="">part one</var> and the implied <code title="md-vcard-n-given-name"><a href="#md-vcard-n-given-name">given-name</a></code> be <var title="">part two</var>.</li>
-
- <li><p>Otherwise, let the implied <code title="md-vcard-n-family-name"><a href="#md-vcard-n-family-name">family-name</a></code> be <var title="">part two</var> and the implied <code title="md-vcard-n-given-name"><a href="#md-vcard-n-given-name">given-name</a></code> be <var title="">part one</var>.</li>
-
- </ol></dd>
+ </ul></dd>
</dl></dd>
@@ -37918,7 +37890,7 @@
(<span itemprop="organization-unit">Los Angeles Division</span>)
</p>
<p>
- <span class="adr" item>
+ <span itempror="adr" item>
<span itemprop="street-address">10201 W. Pico Blvd.</span><br>
<span itemprop="locality">Los Angeles</span>,
<span itemprop="region">CA</span>
@@ -37983,7 +37955,7 @@
vocabulary defined in the iCalendar specification, where more
information on how to interpret the values can be found. <a href="#references">[RFC2445]</a><p class="note">Only the parts of the iCalendar vocabulary relating
to events are used here; this vocabulary cannot express a complete
- iCalendar instance.<dl><dt><dfn id="md-vcevent-attach" title="md-vcevent-attach"><code>attach</code></dfn></dt>
+ iCalendar instance.<dl><dt><dfn id="md-vevent-attach" title="md-vevent-attach"><code>attach</code></dfn></dt>
<dd>
@@ -37992,7 +37964,7 @@
<p>The <a href="#concept-property-value" title="concept-property-value">value</a> must be
an <a href="#absolute-url">absolute URL</a>.</p>
- <p>Any number of properties with the name <code title="md-vcard-attach">attach</code> may be present within each
+ <p>Any number of properties with the name <code title="md-vevent-attach"><a href="#md-vevent-attach">attach</a></code> may be present within each
<a href="#concept-item" title="concept-item">item</a> with the type <code title="md-vevent"><a href="#md-vevent">vevent</a></code>.</p>
</dd>
@@ -38544,9 +38516,8 @@
}
for (var nameIndex = 0; nameIndex < prop.itemprop.length; nameIndex += 1) {
var name = prop.itemprop[nameIndex];
- if (!name.match(':') && !name.match('.')) {
+ if (!name.match(':') && !name.match('.'))
calendar += name.toUpperCase() + parameters + ':' + value + '\r\n';
- }
}
}
calendar += 'END:VEVENT\r\nEND:VCALENDAR\r\n';
@@ -39293,7 +39264,9 @@
</div><h4 id="rdf"><span class="secno">5.4.4 </span>RDF</h4><p>The <dfn id="md-about" title="md-about"><code>about</code></dfn> property can
be used to name an <a href="#concept-item" title="concept-item">item</a> for the
purposes of refering to the data defined in that item from RDF.<p>A single property with the name <code title="md-about"><a href="#md-about">about</a></code> may be present within each <a href="#concept-item" title="concept-item">item</a>. Its <a href="#concept-property-value" title="concept-property-value">value</a> must be an
- <a href="#absolute-url">absolute URL</a>.<h3 id="converting-html-to-other-formats"><span class="secno">5.5 </span>Converting HTML to other formats</h3><h4 id="json"><span class="secno">5.5.1 </span>JSON</h4><p>Given a node <var title="">node</var> in a <code>Document</code>,
+ <a href="#absolute-url">absolute URL</a>.<h3 id="converting-html-to-other-formats"><span class="secno">5.5 </span>Converting HTML to other formats</h3><p>In all these algorithms, unless otherwise stated, operations that
+ iterate over a series of elements (whether items, properties, or
+ otherwise) must do so in <a href="#tree-order">tree order</a>.<h4 id="json"><span class="secno">5.5.1 </span>JSON</h4><p>Given a node <var title="">node</var> in a <code>Document</code>,
a user agent must run the following algorithm to extract that node's
microdata into a JSON form:<ol><li><p>Let <var title="">result</var> be an empty object.</li>
@@ -39497,10 +39470,10 @@
item</dfn> <var title="">item</var>, it must follow the following
steps:<ol><li><p>If of the elements whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding item</a> is
<var title="">item</var>, exactly one has a <a href="#property-names" title="property
- names">property name</a> equal to the string "<code title="">about</code>", and the <a href="#concept-property-value" title="concept-property-value">property value</a> of that
- element is an <a href="#absolute-url">absolute URL</a>, let <var title="">subject</var> be that <a href="#absolute-url">absolute
- URL</a>. Otherwise, let <var title="">subject</var> be a new
- blank node.</li>
+ names">property name</a> equal to the string "<code title="">about</code>", and that element is a <a href="#url-property-elements" title="URL
+ property elements">URL property element</a>, let <var title="">subject</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of that
+ property. Otherwise, let <var title="">subject</var> be a new blank
+ node.</li>
<li>
@@ -39538,14 +39511,10 @@
reserialise it, check if the <time> was valid, check if it had a
.date, a .time, a .timezone, etc. -->
- <li><p>Otherwise, if <var title="">element</var> is not an
- <code><a href="#the-a-element">a</a></code>, <code><a href="#the-area-element">area</a></code>, <code><a href="#audio">audio</a></code>,
- <code><a href="#the-embed-element">embed</a></code>, <code><a href="#the-iframe-element">iframe</a></code>, <code><a href="#the-img-element">img</a></code>,
- <code><a href="#the-link-element">link</a></code>, <code><a href="#the-object-element">object</a></code>, <code><a href="#the-source-element">source</a></code>, or
- <code><a href="#video">video</a></code> element, let <var title="">value</var> be a
- plain literal, with the language information set from the
- <a href="#language">language</a> of the element, if it is not
- unknown.</li>
+ <li><p>Otherwise, if <var title="">element</var> is not one of
+ the <a href="#url-property-elements">URL property elements</a>, let <var title="">value</var> be a plain literal, with the language
+ information set from the <a href="#language">language</a> of the element, if
+ it is not unknown.</li>
<li>
@@ -39574,7 +39543,506 @@
<li><p>Return <var title="">subject</var>.</li>
- </ol><h4 id="vcard-0"><span class="secno">5.5.3 </span>vCard</h4><p class="XXX">...<h4 id="icalendar"><span class="secno">5.5.4 </span>iCalendar</h4><p class="XXX">...</p><!-- prodid and version are required in output --><!-- value datetime vs date for dtstart, dtend, rdate, exdate; must include new dtstamp --><h4 id="bibtex-0"><span class="secno">5.5.5 </span>BibTeX</h4><p class="XXX">...<h2 id="browsers"><span class="secno">6 </span>Web browsers</h2><div class="impl">
+ </ol><h4 id="vcard-0"><span class="secno">5.5.3 </span>vCard</h4><p>Given a node <var title="">node</var> in a <code>Document</code>,
+ a user agent must run the following algorithm to <dfn id="extracting-a-vcard" title="extracting a vCard">extract any <code title="md-vcard">vcard</code> data represented by that
+ node</dfn>:<ol><li>
+
+ <p>If <var title="">node</var> is not an element that is an <a href="#concept-item" title="concept-item">item</a> with the type <code title="md-vcard"><a href="#md-vcard">vcard</a></code>, then run these substeps:</p>
+
+ <ol><li><p>If <var title="">node</var> has no parent, then there is
+ no vCard. Abort the algorithm, returning nothing.</li>
+
+ <li><p>Let <var title="">node</var> be <var title="">node</var>'s
+ parent.</li>
+
+ <li><p>Restart the entire algorithm with the new value of <var title="">node</var>.</li>
+
+ </ol></li>
+
+ <li><p>Let <var title="">output</var> be an empty string.</li>
+
+ <li><p><a href="#add-a-vcard-line">Add a vCard line</a> with the type "<code title="">BEGIN</code>" and the value "<code title="">VCARD</code>"
+ to <var title="">output</var>.</li>
+
+ <li><p><a href="#add-a-vcard-line">Add a vCard line</a> with the type "<code title="">PROFILE</code>" and the value "<code title="">VCARD</code>"
+ to <var title="">output</var>.</li>
+
+ <li><p><a href="#add-a-vcard-line">Add a vCard line</a> with the type "<code title="">VERSION</code>" and the value "<code title="">3.0</code>"
+ to <var title="">output</var>.</li>
+
+ <li><p><a href="#add-a-vcard-line">Add a vCard line</a> with the type "<code title="">SOURCE</code>" and <a href="#the-document-s-current-address">the document's current
+ address</a> as the value to <var title="">output</var>.</li>
+
+ <li><p>If <a href="#the-title-element-0">the <code>title</code> element</a> is not null,
+ <a href="#add-a-vcard-line">add a vCard line</a> with the type "<code title="">NAME</code>" and the <code><a href="#textcontent">textContent</a></code> of <a href="#the-title-element-0">the
+ <code>title</code> element</a> as the value to <var title="">output</var>.</li>
+
+ <li>
+
+ <p>For each element <var title="">element</var> that has one or
+ more <a href="#property-names">property names</a> and whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding item</a> is
+ <var title="">node</var>: for each name <var title="">name</var>
+ in <var title="">element</var>'s <a href="#property-names">property names</a>, run
+ the following substeps:</p>
+
+ <ol><li><p>If <var title="">name</var> is equal to the string
+ "<code title="">about</code>", skip this name.</li>
+
+ <li><p>Let <var title="">parameters</var> be an empty set of
+ name-value pairs.</li>
+
+ <li>
+
+ <p>Run the appropriate set of substeps from the following
+ list. The steps will set a variable <var title="">value</var>,
+ which is used in the next step.</p>
+
+ <dl><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>
+ and <var title="">name</var> is <code title="md-vcard-n"><a href="#md-vcard-n">n</a></code></dt>
+
+ <dd>
+
+ <ol><li><p>Let <var title="">n1</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of the first
+ property named <code title="md-vcard-n-family-name"><a href="#md-vcard-n-family-name">family-name</a></code> in <var title="">subitem</var>, or the empty string if there is no
+ such property or the property's value is itself an <a href="#concept-item" title="concept-item">item</a>.</li>
+
+ <li><p>Let <var title="">n2</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of the first
+ property named <code title="md-vcard-n-given-name"><a href="#md-vcard-n-given-name">given-name</a></code> in <var title="">subitem</var>, or the empty string if there is no
+ such property or the property's value is itself an <a href="#concept-item" title="concept-item">item</a>.</li>
+
+ <li><p>Let <var title="">n3</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of the first
+ property named <code title="md-vcard-n-additional-name"><a href="#md-vcard-n-additional-name">additional-name</a></code> in
+ <var title="">subitem</var>, or the empty string if there is
+ no such property or the property's value is itself an <a href="#concept-item" title="concept-item">item</a>.</li>
+
+ <li><p>Let <var title="">n4</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of the first
+ property named <code title="md-vcard-n-honorific-prefix"><a href="#md-vcard-n-honorific-prefix">honorific-prefix</a></code>
+ in <var title="">subitem</var>, or the empty string if there
+ is no such property or the property's value is itself an
+ <a href="#concept-item" title="concept-item">item</a>.</li>
+
+ <li><p>Let <var title="">n5</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of the first
+ property named <code title="md-vcard-n-honorific-suffix"><a href="#md-vcard-n-honorific-suffix">honorific-suffix</a></code>
+ in <var title="">subitem</var>, or the empty string if there
+ is no such property or the property's value is itself an
+ <a href="#concept-item" title="concept-item">item</a>.</li>
+
+ <li>
+
+ <p>Let <var title="">value</var> be the concatenation of the
+ following, in this order:</p>
+
+ <ol class="brief"><li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">n1</var></li>
+ <li>A U+003B SEMICOLON character (;)</li>
+ <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">n2</var></li>
+ <li>A U+003B SEMICOLON character (;)</li>
+ <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">n3</var></li>
+ <li>A U+003B SEMICOLON character (;)</li>
+ <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">n4</var></li>
+ <li>A U+003B SEMICOLON character (;)</li>
+ <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">n5</var></li>
+ </ol></li>
+
+ </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>
+ and <var title="">name</var> is <code title="md-vcard-adr"><a href="#md-vcard-adr">adr</a></code></dt>
+
+ <dd>
+
+ <ol><li><p>Let <var title="">value</var> be the empty
+ string.</li>
+
+ <li><p>Append to <var title="">value</var> the result of
+ <a href="#collecting-vcard-subproperties">collecting vCard subproperties</a> named <code title="md-vcard-adr-post-office-box"><a href="#md-vcard-adr-post-office-box">post-office-box</a></code>
+ in <var title="">subitem</var>.</p>
+
+ <li>Append a U+003B SEMICOLON character (;) to <var title="">value</var>.</li>
+
+ <li><p>Append to <var title="">value</var> the result of
+ <a href="#collecting-vcard-subproperties">collecting vCard subproperties</a> named <code title="md-vcard-adr-extended-address"><a href="#md-vcard-adr-extended-address">extended-address</a></code>
+ in <var title="">subitem</var>.</p>
+
+ <li>Append a U+003B SEMICOLON character (;) to <var title="">value</var>.</li>
+
+ <li><p>Append to <var title="">value</var> the result of
+ <a href="#collecting-vcard-subproperties">collecting vCard subproperties</a> named <code title="md-vcard-adr-street-address"><a href="#md-vcard-adr-street-address">street-address</a></code> in
+ <var title="">subitem</var>.</p>
+
+ <li>Append a U+003B SEMICOLON character (;) to <var title="">value</var>.</li>
+
+ <li><p>Append to <var title="">value</var> the result of
+ <a href="#collecting-the-first-vcard-subproperty">collecting the first vCard subproperty</a> named
+ <code title="md-vcard-adr-locality"><a href="#md-vcard-adr-locality">locality</a></code> in <var title="">subitem</var>.</p>
+
+ <li>Append a U+003B SEMICOLON character (;) to <var title="">value</var>.</li>
+
+ <li><p>Append to <var title="">value</var> the result of
+ <a href="#collecting-the-first-vcard-subproperty">collecting the first vCard subproperty</a> named
+ <code title="md-vcard-adr-region"><a href="#md-vcard-adr-region">region</a></code> in <var title="">subitem</var>.</p>
+
+ <li>Append a U+003B SEMICOLON character (;) to <var title="">value</var>.</li>
+
+ <li><p>Append to <var title="">value</var> the result of
+ <a href="#collecting-the-first-vcard-subproperty">collecting the first vCard subproperty</a> named
+ <code title="md-vcard-adr-postal-code"><a href="#md-vcard-adr-postal-code">postal-code</a></code> in
+ <var title="">subitem</var>.</p>
+
+ <li>Append a U+003B SEMICOLON character (;) to <var title="">value</var>.</li>
+
+ <li><p>Append to <var title="">value</var> the result of
+ <a href="#collecting-the-first-vcard-subproperty">collecting the first vCard subproperty</a> named
+ <code title="md-vcard-adr-country-name"><a href="#md-vcard-adr-country-name">country-name</a></code>
+ in <var title="">subitem</var>.</p>
+
+ <li><p>If there is a property named <code title="md-vcard-adr-type"><a href="#md-vcard-adr-type">type</a></code> in <var title="">subitem</var>, and the first such property has a
+ <a href="#concept-property-value" title="concept-property-value">value</a> that is not
+ an <a href="#concept-item" title="concept-item">item</a> and whose value
+ consists only of <a href="#alphanumeric-ascii-characters">alphanumeric ASCII characters</a>,
+ then add a parameter named "<code title="">TYPE</code>" whose
+ value is the <a href="#concept-property-value" title="concept-property-value">value</a> of that property
+ to <var title="">parameters</var>.</li>
+
+ </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>
+ and <var title="">name</var> is <code title="md-vcard-org"><a href="#md-vcard-org">org</a></code></dt>
+
+ <dd>
+
+ <ol><li><p>Let <var title="">value</var> be the empty
+ string.</li>
+
+ <li><p>Append to <var title="">value</var> the result of
+ <a href="#collecting-the-first-vcard-subproperty">collecting the first vCard subproperty</a> named
+ <code title="md-vcard-org-organization-name"><a href="#md-vcard-org-organization-name">organization-name</a></code>
+ in <var title="">subitem</var>.</p>
+
+ <li>
+
+ <p>For each property named <code title="md-vcard-org-organization-unit"><a href="#md-vcard-org-organization-unit">organization-unit</a></code>
+ in <var title="">subitem</var>, run the following steps:</p>
+
+ <ol><li><p>If the <a href="#concept-property-value" title="concept-property-value">value</a> of the property
+ is an <a href="#concept-item" title="concept-item">item</a>, then skip
+ this property.</li>
+
+ <li><p>Append a U+003B SEMICOLON character (;) to <var title="">value</var>.</li>
+
+ <li><p>Append the result of <a href="#escaping-the-vcard-text-string">escaping the vCard text
+ string</a> given by the <a href="#concept-property-value" title="concept-property-value">value</a> of the property
+ to <var title="">value</var>.</li>
+
+ </ol></li>
+
+ </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 type <code title="md-vcard"><a href="#md-vcard">vcard</a></code> and <var title="">name</var> is <code title="md-vcard-agent"><a href="#md-vcard-agent">agent</a></code></dt>
+
+ <dd>
+
+ <ol><li><p>Let <var title="">value</var> be the result of
+ <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> obtained from
+ <a href="#extracting-a-vcard">extracting a vCard</a> from the element that
+ represents <var title="">subitem</var>.</li>
+
+ <li><p>Add a parameter named "<code title="">VALUE</code>"
+ whose value is "<code title="">VCARD</code>" to <var title="">parameters</var>.</li>
+
+ </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> and <var title="">name</var>
+ is none of the above</dt>
+
+ <dd>
+
+ <ol><li><p>Let <var title="">value</var> the result of
+ <a href="#collecting-the-first-vcard-subproperty">collecting the first vCard subproperty</a> named
+ <code title="">value</code> in <var title="">subitem</var>.</p>
+
+ <li><p>If there is a property named <code title="">type</code> in <var title="">subitem</var>, and the
+ first such property has a <a href="#concept-property-value" title="concept-property-value">value</a> that is not an
+ <a href="#concept-item" title="concept-item">item</a> and whose value
+ consists only of <a href="#alphanumeric-ascii-characters">alphanumeric ASCII characters</a>,
+ then add a parameter named "<code title="">TYPE</code>" whose
+ value is the <a href="#concept-property-value" title="concept-property-value">value</a> of that property
+ to <var title="">parameters</var>.</li>
+
+ </ol></dd>
+
+ <dt>Otherwise (the property's <a href="#concept-property-value" title="concept-property-value">value</a> is not an <a href="#concept-item" title="concept-item">item</a>)</dt>
+
+ <dd>
+
+ <ol><li><p>Let <var title="">value</var> be the property's <a href="#concept-property-value" title="concept-property-value">value</a>.</li>
+
+ <li><p>If <var title="">element</var> is one of the <a href="#url-property-elements">URL
+ property elements</a>, add a parameter with the name "<code title="">VALUE</code>" and the value "<code title="">URI</code>" to <var title="">parameters</var>.</li>
+
+ <li><p>Otherwise, if <var title="">element</var> is a
+ <code><a href="#the-time-element">time</a></code> element and the <var title="">value</var> is
+ a <a href="#valid-date-string">valid date string</a>, add a parameter with the name
+ "<code title="">VALUE</code>" and the value "<code title="">DATE</code>" to <var title="">parameters</var>.</li>
+
+ <li><p>Otherwise, if <var title="">element</var> is a
+ <code><a href="#the-time-element">time</a></code> element and the <var title="">value</var> is
+ a <a href="#valid-global-date-and-time-string">valid global date and time string</a>, add a
+ parameter with the name "<code title="">VALUE</code>" and the
+ value "<code title="">DATE-TIME</code>" to <var title="">parameters</var>.</li>
+
+ <li><p>Prefix every U+005C REVERSE SOLIDUS character (\) in
+ <var title="">value</var> with another U+005C REVERSE SOLIDUS
+ character (\).</li>
+
+ <li><p>Prefix every U+002C COMMA character (,) in <var title="">value</var> with a U+005C REVERSE SOLIDUS character
+ (\).</li>
+
+ <li><p>Unless <var title="">name</var> is <code title="md-vcard-geo"><a href="#md-vcard-geo">geo</a></code>, prefix every U+003B SEMICOLON
+ character (;) in <var title="">value</var> with a U+005C
+ REVERSE SOLIDUS character (\).</li>
+
+ <li><p>Replace every U+000D CARRIAGE RETURN U+000A LINE FEED
+ character pair (CRLF) in <var title="">value</var> with a U+005C REVERSE
+ SOLIDUS character (\) followed by a U+006E LATIN SMALL LETTER
+ N.</li>
+
+ <li><p>Replace every remaining U+000D CARRIAGE RETURN (CR) or
+ U+000A LINE FEED (LF) character in <var title="">value</var>
+ with a U+005C REVERSE SOLIDUS character (\) followed by a U+006E
+ LATIN SMALL LETTER N.</li>
+
+ </ol></dd>
+
+ </dl></li>
+
+ <li>
+
+ <p><a href="#add-a-vcard-line">Add a vCard line</a> with the type <var title="">name</var>, the parameters <var title="">parameters</var>, and the value <var title="">value</var> to <var title="">output</var>.</p>
+
+ </li>
+
+ </ol></li>
+
+ <li>
+
+ <p>If there is no property named <code title="md-vcard-n"><a href="#md-vcard-n">n</a></code>
+ whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding
+ item</a> is <var title="">node</var>, then run the following
+ substeps:</p>
+
+ <ol><li><p>If there is no property named <code title="md-vcard-fn"><a href="#md-vcard-fn">fn</a></code> whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding item</a> is
+ <var title="">node</var>, then skip the remainder of these
+ substeps.</li>
+
+ <li><p>If the first property named <code title="md-vcard-fn"><a href="#md-vcard-fn">fn</a></code> whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding item</a> is
+ <var title="">node</var> has a <a href="#concept-property-value" title="concept-property-value">value</a> that is an <a href="#concept-item" title="concept-item">item</a>, then skip the remainder of
+ these substeps.</li>
+
+ <li><p>Let <var title="">fn</var> be the <a href="#concept-property-value" title="concept-property-value">value</a> of the first property
+ named <code title="md-vcard-fn"><a href="#md-vcard-fn">fn</a></code> whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding item</a> is
+ <var title="">node</var>.</li>
+
+ <li><p>If there is a property named <code title="md-vcard-org"><a href="#md-vcard-org">org</a></code> whose <a href="#concept-item-corresponding" title="concept-item-corresponding">corresponding item</a> is
+ <var title="">node</var>, and the <a href="#concept-property-value" title="concept-property-value">value</a> of the first such
+ property is equal to <var title="">fn</var> (and is not an <a href="#concept-item" title="concept-item">item</a>), then <a href="#add-a-vcard-line">add a vCard
+ line</a> with the type "<code title="">N</code>" whose value
+ is four U+003B SEMICOLON characters ("<code title="">;;;;</code>") to <var title="">output</var>. Then, skip
+ the remainder of these substeps.</li>
+
+ <li><p>If the <a href="#space-character" title="space character">space
+ characters</a> in <var title="">fn</var>, if any, are not all
+ contiguous, then skip the remainder of these substeps.</li>
+
+ <li><p><a href="#split-a-string-on-spaces" title="split a string on spaces">Split <var title="">fn</var> on spaces</a>, and let <var title="">part
+ one</var> be the first resulting token, and <var title="">part
+ two</var> be the second, if any, or the empty string if there is
+ no second token. (There cannot be three, given the previous
+ step.)</li>
+
+ <li>
+
+ <p>If the last character of <var title="">part one</var> is a
+ U+002C COMMA character (,), then remove that character from <var title="">part one</var> and <a href="#add-a-vcard-line">add a vCard line</a> with
+ the type "<code title="">N</code>" whose value is the
+ concatenation of the following strings:</p>
+
+ <ol class="brief"><li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">part one</var></li>
+ <li>A U+003B SEMICOLON character (;)</li>
+ <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">part two</var></li>
+ <li>Three U+003B SEMICOLON characters (;)</li>
+ </ol><p>Then, skip the remainder of these substeps.</p>
+
+ </li>
+
+ <li>
+
+ <p>If <var title="">part two</var> is two Unicode code-points
+ long and its second character is a U+002E FULL STOP character
+ (.), then <a href="#add-a-vcard-line">add a vCard line</a> with the type "<code title="">N</code>" whose value is the concatenation of the
+ following strings:</p>
+
+ <ol class="brief"><li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">part one</var></li>
+ <li>A U+003B SEMICOLON character (;)</li>
+ <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> consisting of the first character of <var title="">part two</var></li>
+ <li>Three U+003B SEMICOLON characters (;)</li>
+ </ol><p>Then, skip the remainder of these substeps.</p>
+
+ </li>
+
+ <li>
+
+ <p>If <var title="">part two</var> is one Unicode code-point
+ long, then <a href="#add-a-vcard-line">add a vCard line</a> with the type "<code title="">N</code>" whose value is the concatenation of the
+ following strings:</p>
+
+ <ol class="brief"><li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">part one</var></li>
+ <li>A U+003B SEMICOLON character (;)</li>
+ <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">part two</var></li>
+ <li>Three U+003B SEMICOLON characters (;)</li>
+ </ol><p>Then, skip the remainder of these substeps.</p>
+
+ </li>
+
+ <li>
+
+ <p><a href="#add-a-vcard-line">Add a vCard line</a> with the type "<code title="">N</code>" whose value is the concatenation of the
+ following strings:</p>
+
+ <ol class="brief"><li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">part two</var></li>
+ <li>A U+003B SEMICOLON character (;)</li>
+ <li>The result of <a href="#escaping-the-vcard-text-string">escaping the vCard text string</a> <var title="">part one</var></li>
+ <li>Three U+003B SEMICOLON characters (;)</li>
+ </ol></li>
+
+ </ol></li>
+
+ <li><p><a href="#add-a-vcard-line">Add a vCard line</a> with the type "<code title="">END</code>" and the value "<code title="">VCARD</code>"
+ to <var title="">output</var>.</li>
+
+ </ol><p>When the above algorithm says that the user agent is to <dfn id="add-a-vcard-line">add
+ a vCard line</dfn> consisting of a type <var title="">type</var>,
+ optionally some parameters, and a value <var title="">value</var> to
+ a string <var title="">output</var>, it must run the following
+ steps:<ol><li><p>Let <var title="">line</var> be an empty string.
+
+ <li><p>Append <var title="">type</var>, <a href="#converted-to-uppercase">converted to
+ uppercase</a>, to <var title="">line</var>.</li>
+
+ <li>
+
+ <p>If there are any parameters, then for each parameter, in the
+ order that they were added, run these substeps:</p>
+
+ <ol><li><p>Append a U+003B SEMICOLON character (;) to <var title="">line</var>.</li>
+
+ <li><p>Append the parameter's name to <var title="">line</var>.</li>
+
+ <li><p>Append a U+003D EQUALS SIGN character (=) to <var title="">line</var>.</li>
+
+ <li><p>Append the parameter's value to <var title="">line</var>.</li>
+
+ </ol></li>
+
+ <li><p>Append a U+003A COLON character (:) to <var title="">line</var>.</li>
+
+ <li><p>Append <var title="">value</var> to <var title="">line</var>.</li>
+
+ <li><p>Let <var title="">maximum length</var> be 75.</li>
+
+ <li>
+
+ <p>If and while <var title="">line</var> is longer than <var title="">maximum length</var> Unicode code points long, run the
+ following substeps:</p>
+
+ <ol><li><p>Append the first <var title="">maximum length</var>
+ Unicode code points of <var title="">line</var> to <var title="">output</var>.</li>
+
+ <li><p>Remove the first <var title="">maximum length</var>
+ Unicode code points from <var title="">line</var>.</li>
+
+ <li><p>Append a U+000D CARRIAGE RETURN character (CR) to <var title="">output</var>.</li>
+
+ <li><p>Append a U+000A LINE FEED character (LF) to <var title="">output</var>.</li>
+
+ <li><p>Append a U+0020 SPACE character to <var title="">output</var>.</li>
+
+ <li><p>Let <var title="">maximum length</var> be 74.</li>
+
+ </ol></li>
+
+ <li><p>Append (what remains of) <var title="">line</var> to <var title="">output</var>.</li>
+
+ <li><p>Append a U+000D CARRIAGE RETURN character (CR) to <var title="">output</var>.</li>
+
+ <li><p>Append a U+000A LINE FEED character (LF) to <var title="">output</var>.</li>
+
+ </ol><p>When the steps above require the user agent to obtain the result
+ of <dfn id="collecting-vcard-subproperties">collecting vCard subproperties</dfn> named <var title="">subname</var> in <var title="">subitem</var>, the user
+ agent must run the following steps:<ol><li><p>Let <var title="">value</var> be the empty string.</li>
+
+ <li>
+
+ <p>For each property named <var title="">subname</var> in the item
+ <var title="">subitem</var>, run the following substeps:</p>
+
+ <ol><li><p>If the <a href="#concept-property-value" title="concept-property-value">value</a>
+ of the property is itself an <a href="#concept-item" title="concept-item">item</a>, then skip this
+ property.</li>
+
+ <li><p>If this is not the first property named <var title="">subname</var> in <var title="">subitem</var> (ignoring
+ any that were skipped by the previous step), then append a U+002C
+ COMMA character (,) to <var title="">value</var>.</li>
+
+ <li><p>Append the result of <a href="#escaping-the-vcard-text-string">escaping the vCard text
+ string</a> given by the <a href="#concept-property-value" title="concept-property-value">value</a> of the property to
+ <var title="">value</var>.</li>
+
+ </ol></li>
+
+ <li><p>Return <var title="">value</var>.</li>
+
+ </ol><p>When the steps above require the user agent to obtain the result
+ of <dfn id="collecting-the-first-vcard-subproperty">collecting the first vCard subproperty</dfn> named <var title="">subname</var> in <var title="">subitem</var>, the user
+ agent must run the following steps:<ol><li><p>If there are no properties named <var title="">subname</var>
+ in <var title="">subitem</var>, then abort these substeps,
+ returning the empty string.</li>
+
+ <li><p>If the <a href="#concept-property-value" title="concept-property-value">value</a> of
+ the first property named <var title="">subname</var> in <var title="">subitem</var> is an <a href="#concept-item" title="concept-item">item</a>, then abort these substeps,
+ returning the empty string.</li>
+
+ <li><p>Return the result of <a href="#escaping-the-vcard-text-string">escaping the vCard text
+ string</a> given by the <a href="#concept-property-value" title="concept-property-value">value</a> of the first property
+ named <var title="">subname</var> in <var title="">subitem</var>.</li>
+
+ </ol><p>When the above algorithms say the user agent is to <dfn id="escaping-the-vcard-text-string" title="escaping the vCard text string">escape the vCard text
+ string</dfn> <var title="">value</var>, the user agent must use the
+ following steps:<ol><li><p>Prefix every U+005C REVERSE SOLIDUS character (\) in <var title="">value</var> with another U+005C REVERSE SOLIDUS character
+ (\).</li>
+
+ <li><p>Prefix every U+002C COMMA character (,) in <var title="">value</var> with a U+005C REVERSE SOLIDUS character
+ (\).</li>
+
+ <li><p>Prefix every U+003B SEMICOLON character (;) in <var title="">value</var> with a U+005C REVERSE SOLIDUS character
+ (\).</li>
+
+ <li><p>Replace every U+000D CARRIAGE RETURN U+000A LINE FEED
+ character pair (CRLF) in <var title="">value</var> with a U+005C
+ REVERSE SOLIDUS character (\) followed by a U+006E LATIN SMALL
+ LETTER N.</li>
+
+ <li><p>Replace every remaining U+000D CARRIAGE RETURN (CR) or
+ U+000A LINE FEED (LF) character in <var title="">value</var> with a
+ U+005C REVERSE SOLIDUS character (\) followed by a U+006E LATIN
+ SMALL LETTER N.</li>
+
+ <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">vcard</a></code> <a href="#predefined-type">predefined type</a> and <a href="#predefined-property-name" title="predefined property name">predefined property
+ names</a>.</p><!-- of course since vcard doesn't define error
+ handling, this is somewhat problematic. --><h4 id="icalendar"><span class="secno">5.5.4 </span>iCalendar</h4><p class="XXX">...</p><!-- prodid and version are required in output --><!-- value datetime vs date for dtstart, dtend, rdate, exdate; must include new dtstamp --><h4 id="bibtex-0"><span class="secno">5.5.5 </span>BibTeX</h4><p class="XXX">...<h2 id="browsers"><span class="secno">6 </span>Web browsers</h2><div class="impl">
<p>This section describes features that apply most directly to Web
browsers. Having said that, unless specified elsewhere, the
Received on Saturday, 16 May 2009 02:03:06 UTC