[html5] r3674 - [c] (0) Add extra restrictions on <a name>.
whatwg at whatwg.org
whatwg at whatwg.org
Tue Aug 25 16:46:23 PDT 2009
Author: ianh
Date: 2009-08-25 16:46:21 -0700 (Tue, 25 Aug 2009)
New Revision: 3674
Modified:
index
source
Log:
[c] (0) Add extra restrictions on <a name>.
Modified: index
===================================================================
--- index 2009-08-25 23:25:12 UTC (rev 3673)
+++ index 2009-08-25 23:46:21 UTC (rev 3674)
@@ -5414,9 +5414,9 @@
<dt><var title="">collection</var>[<var title="">name</var>]</dt>
<dt><var title="">collection</var>(<var title="">name</var>)</dt>
<dd>
- <p>Returns the first item with ID or name <var title="">name</var>
+ <p>Returns the first item with <a href=#concept-id title=concept-id>ID</a> or name <var title="">name</var>
from the collection.</p>
- <p>Returns null if no element with that ID or name could be found.</p>
+ <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> or name could be found.</p>
<p>Only <code><a href=#the-a-element>a</a></code>, <code><a href=#the-applet-element>applet</a></code>, <code><a href=#the-area-element>area</a></code>,
<code><a href=#the-embed-element>embed</a></code>, <code><a href=#the-form-element>form</a></code>, <code><a href=#frame>frame</a></code>,
<code><a href=#frameset>frameset</a></code>, <code><a href=#the-iframe-element>iframe</a></code>, <code><a href=#the-img-element>img</a></code>, and
@@ -5463,7 +5463,7 @@
<code><a href=#the-img-element>img</a></code>, or <code><a href=#the-object-element>object</a></code> element with a <code title="">name</code> attribute equal to <var title="">key</var>,
or,</li>
- <li>It is an element with an ID <var title="">key</var>.</li>
+ <li>It is an element with an <a href=#concept-id title=concept-id>ID</a> <var title="">key</var>.</li>
</ul><p>If no such elements are found, then the method must return
null.</p>
@@ -5513,9 +5513,9 @@
<dt><var title="">collection</var>[<var title="">name</var>]</dt>
<dt><var title="">collection</var>(<var title="">name</var>)</dt>
<dd>
- <p>Returns the item with ID or name <var title="">name</var> from the collection.</p>
+ <p>Returns the item with <a href=#concept-id title=concept-id>ID</a> or name <var title="">name</var> from the collection.</p>
<p>If there are multiple matching items, then an <code><a href=#htmlallcollection>HTMLAllCollection</a></code> object containing all those elements is returned.</p>
- <p>Returns null if no element with that ID or name could be found.</p>
+ <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> or name could be found.</p>
<p>Only <code><a href=#the-a-element>a</a></code>, <code><a href=#the-applet-element>applet</a></code>, <code><a href=#the-area-element>area</a></code>,
<code><a href=#the-embed-element>embed</a></code>, <code><a href=#the-form-element>form</a></code>, <code><a href=#frame>frame</a></code>,
<code><a href=#frameset>frameset</a></code>, <code><a href=#the-iframe-element>iframe</a></code>, <code><a href=#the-img-element>img</a></code>, and
@@ -5571,7 +5571,7 @@
<code><a href=#the-object-element>object</a></code> elements with a <code title="">name</code>
attribute equal to <var title="">key</var>, or,</li>
- <li>elements with an ID <var title="">key</var>.</li>
+ <li>elements with an <a href=#concept-id title=concept-id>ID</a> <var title="">key</var>.</li>
</ul></li>
@@ -5631,9 +5631,9 @@
<dt><var title="">collection</var>[<var title="">name</var>]</dt>
<dt><var title="">collection</var>(<var title="">name</var>)</dt>
<dd>
- <p>Returns the item with ID or <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> <var title="">name</var> from the collection.</p>
+ <p>Returns the item with <a href=#concept-id title=concept-id>ID</a> or <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> <var title="">name</var> from the collection.</p>
<p>If there are multiple matching items, then a <code><a href=#radionodelist>RadioNodeList</a></code> object containing all those elements is returned.</p>
- <p>Returns null if no element with that ID or <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> could be found.</p>
+ <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> or <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> could be found.</p>
</dd>
<dt><var title="">radioNodeList</var> . <var title="">value</var> [ = <var title="">value</var> ]</dt>
@@ -5766,9 +5766,9 @@
<dt><var title="">collection</var>[<var title="">name</var>]</dt>
<dt><var title="">collection</var>(<var title="">name</var>)</dt>
<dd>
- <p>Returns the item with ID or <code title=attr-option-name>name</code> <var title="">name</var> from the collection.</p>
+ <p>Returns the item with <a href=#concept-id title=concept-id>ID</a> or <code title=attr-option-name>name</code> <var title="">name</var> from the collection.</p>
<p>If there are multiple matching items, then a <code>NodeList</code> object containing all those elements is returned.</p>
- <p>Returns null if no element with that ID could be found.</p>
+ <p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> could be found.</p>
</dd>
<dt><var title="">collection</var> . <code title=dom-HTMLOptionsCollection-add><a href=#dom-htmloptionscollection-add>add</a></code>(<var title="">element</var> [, <var title="">before</var> ] )</dt>
@@ -7686,18 +7686,20 @@
<h5 id=the-id-attribute><span class=secno>3.2.3.1 </span>The <dfn title=attr-id><code>id</code></dfn> attribute</h5>
<p>The <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute
- <a href=#represents>represents</a> its element's unique identifier. The value
- must be unique in the element's <a href=#home-subtree>home subtree</a> and must
- contain at least one character. The value must not contain any <a href=#space-character title="space character">space characters</a>.</p>
+ <a href=#represents>represents</a> its element's <dfn id=concept-id title=concept-id>unique
+ identifier (ID)</dfn>. The value must be unique amongst all the IDs
+ in the element's <a href=#home-subtree>home subtree</a> and must contain at least
+ one character. The value must not contain any <a href=#space-character title="space
+ character">space characters</a>.</p>
<!-- space characters are disallowed because space-separated lists
of IDs otherwise would not be able to reach all valid IDs -->
- <p class=note>An element's unique identifier can be used for a
- variety of purposes, most notably as a way to link to specific parts
- of a document using fragment identifiers, as a way to target an
- element when scripting, and as a way to style a specific element
- from CSS.</p>
+ <p class=note>An element's <a href=#concept-id title=concept-id>unique
+ identifier</a> can be used for a variety of purposes, most
+ notably as a way to link to specific parts of a document using
+ fragment identifiers, as a way to target an element when scripting,
+ and as a way to style a specific element from CSS.</p>
<div class=impl>
@@ -71539,10 +71541,11 @@
<p>Authors should not specify the <code title=attr-a-name><a href=#attr-a-name>name</a></code> attribute on <code><a href=#the-a-element>a</a></code>
elements. If the attribute is present, its value must not be the
- empty string. In earlier versions of the language, this attribute
- served a similar role as the <code title=attr-id><a href=#the-id-attribute>id</a></code>
- attribute. The <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute should be
- used instead.</p>
+ empty string and must not be equal to the value of any of the <a href=#concept-id title=concept-id>IDs</a> in the element's <a href=#home-subtree>home
+ subtree</a> other than the element's own <a href=#concept-id title=concept-id>ID</a>, if any. If this attribute is present
+ and the element has an <a href=#concept-id title=concept-id>ID</a>, then the
+ attribute's value must be equal to the element's <a href=#concept-id title=concept-id>ID</a>. In earlier versions of the language,
+ this attribute served a similar role as the <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute. The <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute should be used instead.</p>
<p class=note>The <code title=attr-table-summary><a href=#attr-table-summary>summary</a></code>
attribute, defined in the <code><a href=#the-table-element>table</a></code> section, will also
@@ -74300,6 +74303,7 @@
Robin Berjon,
Roland Steiner,
Roman Ivanov,
+ Roy Fielding,
Ryan King,
S. Mike Dierken,
Sam Dutton,
Modified: source
===================================================================
--- source 2009-08-25 23:25:12 UTC (rev 3673)
+++ source 2009-08-25 23:46:21 UTC (rev 3674)
@@ -5153,9 +5153,9 @@
<dt><var title="">collection</var>[<var title="">name</var>]</dt>
<dt><var title="">collection</var>(<var title="">name</var>)</dt>
<dd>
- <p>Returns the first item with ID or name <var title="">name</var>
+ <p>Returns the first item with <span title="concept-id">ID</span> or name <var title="">name</var>
from the collection.</p>
- <p>Returns null if no element with that ID or name could be found.</p>
+ <p>Returns null if no element with that <span title="concept-id">ID</span> or name could be found.</p>
<p>Only <code>a</code>, <code>applet</code>, <code>area</code>,
<code>embed</code>, <code>form</code>, <code>frame</code>,
<code>frameset</code>, <code>iframe</code>, <code>img</code>, and
@@ -5216,7 +5216,7 @@
title="">name</code> attribute equal to <var title="">key</var>,
or,</li>
- <li>It is an element with an ID <var title="">key</var>.</li>
+ <li>It is an element with an <span title="concept-id">ID</span> <var title="">key</var>.</li>
</ul>
@@ -5272,9 +5272,9 @@
<dt><var title="">collection</var>[<var title="">name</var>]</dt>
<dt><var title="">collection</var>(<var title="">name</var>)</dt>
<dd>
- <p>Returns the item with ID or name <var title="">name</var> from the collection.</p>
+ <p>Returns the item with <span title="concept-id">ID</span> or name <var title="">name</var> from the collection.</p>
<p>If there are multiple matching items, then an <code>HTMLAllCollection</code> object containing all those elements is returned.</p>
- <p>Returns null if no element with that ID or name could be found.</p>
+ <p>Returns null if no element with that <span title="concept-id">ID</span> or name could be found.</p>
<p>Only <code>a</code>, <code>applet</code>, <code>area</code>,
<code>embed</code>, <code>form</code>, <code>frame</code>,
<code>frameset</code>, <code>iframe</code>, <code>img</code>, and
@@ -5345,7 +5345,7 @@
<code>object</code> elements with a <code title="">name</code>
attribute equal to <var title="">key</var>, or,</li>
- <li>elements with an ID <var title="">key</var>.</li>
+ <li>elements with an <span title="concept-id">ID</span> <var title="">key</var>.</li>
</ul>
@@ -5414,9 +5414,9 @@
<dt><var title="">collection</var>[<var title="">name</var>]</dt>
<dt><var title="">collection</var>(<var title="">name</var>)</dt>
<dd>
- <p>Returns the item with ID or <code title="attr-fe-name">name</code> <var title="">name</var> from the collection.</p>
+ <p>Returns the item with <span title="concept-id">ID</span> or <code title="attr-fe-name">name</code> <var title="">name</var> from the collection.</p>
<p>If there are multiple matching items, then a <code>RadioNodeList</code> object containing all those elements is returned.</p>
- <p>Returns null if no element with that ID or <code title="attr-fe-name">name</code> could be found.</p>
+ <p>Returns null if no element with that <span title="concept-id">ID</span> or <code title="attr-fe-name">name</code> could be found.</p>
</dd>
<dt><var title="">radioNodeList</var> . <var title="">value</var> [ = <var title="">value</var> ]</dt>
@@ -5586,9 +5586,9 @@
<dt><var title="">collection</var>[<var title="">name</var>]</dt>
<dt><var title="">collection</var>(<var title="">name</var>)</dt>
<dd>
- <p>Returns the item with ID or <code title="attr-option-name">name</code> <var title="">name</var> from the collection.</p>
+ <p>Returns the item with <span title="concept-id">ID</span> or <code title="attr-option-name">name</code> <var title="">name</var> from the collection.</p>
<p>If there are multiple matching items, then a <code>NodeList</code> object containing all those elements is returned.</p>
- <p>Returns null if no element with that ID could be found.</p>
+ <p>Returns null if no element with that <span title="concept-id">ID</span> could be found.</p>
</dd>
<dt><var title="">collection</var> . <code title="dom-HTMLOptionsCollection-add">add</code>(<var title="">element</var> [, <var title="">before</var> ] )</dt>
@@ -7807,19 +7807,20 @@
<h5>The <dfn title="attr-id"><code>id</code></dfn> attribute</h5>
<p>The <code title="attr-id">id</code> attribute
- <span>represents</span> its element's unique identifier. The value
- must be unique in the element's <span>home subtree</span> and must
- contain at least one character. The value must not contain any <span
- title="space character">space characters</span>.</p>
+ <span>represents</span> its element's <dfn title="concept-id">unique
+ identifier (ID)</dfn>. The value must be unique amongst all the IDs
+ in the element's <span>home subtree</span> and must contain at least
+ one character. The value must not contain any <span title="space
+ character">space characters</span>.</p>
<!-- space characters are disallowed because space-separated lists
of IDs otherwise would not be able to reach all valid IDs -->
- <p class="note">An element's unique identifier can be used for a
- variety of purposes, most notably as a way to link to specific parts
- of a document using fragment identifiers, as a way to target an
- element when scripting, and as a way to style a specific element
- from CSS.</p>
+ <p class="note">An element's <span title="concept-id">unique
+ identifier</span> can be used for a variety of purposes, most
+ notably as a way to link to specific parts of a document using
+ fragment identifiers, as a way to target an element when scripting,
+ and as a way to style a specific element from CSS.</p>
<div class="impl">
@@ -84951,10 +84952,16 @@
<p>Authors should not specify the <code
title="attr-a-name">name</code> attribute on <code>a</code>
elements. If the attribute is present, its value must not be the
- empty string. In earlier versions of the language, this attribute
- served a similar role as the <code title="attr-id">id</code>
- attribute. The <code title="attr-id">id</code> attribute should be
- used instead.</p>
+ empty string and must not be equal to the value of any of the <span
+ title="concept-id">IDs</span> in the element's <span>home
+ subtree</span> other than the element's own <span
+ title="concept-id">ID</span>, if any. If this attribute is present
+ and the element has an <span title="concept-id">ID</span>, then the
+ attribute's value must be equal to the element's <span
+ title="concept-id">ID</span>. In earlier versions of the language,
+ this attribute served a similar role as the <code
+ title="attr-id">id</code> attribute. The <code
+ title="attr-id">id</code> attribute should be used instead.</p>
<p class="note">The <code title="attr-table-summary">summary</code>
attribute, defined in the <code>table</code> section, will also
@@ -88201,6 +88208,7 @@
Robin Berjon,
Roland Steiner,
Roman Ivanov,
+ Roy Fielding,
Ryan King,
S. Mike Dierken,
Sam Dutton,
More information about the Commit-Watchers
mailing list