[html5] r7479 - [] (3) Precision and some cleanup Fixing https://www.w3.org/Bugs/Public/show_bug [...]
whatwg at whatwg.org
whatwg at whatwg.org
Fri Oct 19 15:35:51 PDT 2012
Author: ianh
Date: 2012-10-19 15:35:50 -0700 (Fri, 19 Oct 2012)
New Revision: 7479
Modified:
complete.html
index
source
Log:
[] (3) Precision and some cleanup
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=18650
Affected topics: DOM APIs, HTML
Modified: complete.html
===================================================================
--- complete.html 2012-10-19 22:32:45 UTC (rev 7478)
+++ complete.html 2012-10-19 22:35:50 UTC (rev 7479)
@@ -21186,39 +21186,30 @@
attribute DOMString <a href=#dom-a-hash title=dom-a-hash>hash</a>;
};</pre>
</dd>
- </dl><!--TOPIC:HTML--><p>If the <code><a href=#the-a-element>a</a></code> element has an <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute, then it
- <a href=#represents>represents</a> a <a href=#hyperlink>hyperlink</a> (a hypertext
- anchor).</p>
+ </dl><!--TOPIC:HTML--><p>If the <code><a href=#the-a-element>a</a></code> element has an <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute,
+ then it <a href=#represents>represents</a> a <a href=#hyperlink>hyperlink</a> (a hypertext anchor) labeled by its
+ contents.</p>
- <!-- v2: Eric Meyer requests the ability to nest links so that a big
- hyperlink, e.g. representing a calendar event, can be clickable,
- while within it there are subareas that represent links to distinct
- areas, e.g. a link to see photos of the event, or to edit the event,
- or some such. -->
+ <!-- v2: Eric Meyer requests the ability to nest links so that a big hyperlink, e.g. representing
+ a calendar event, can be clickable, while within it there are subareas that represent links to
+ distinct areas, e.g. a link to see photos of the event, or to edit the event, or some such. -->
- <p>If the <code><a href=#the-a-element>a</a></code> element has no <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute, then the element
- <a href=#represents>represents</a> a placeholder for where a link might
- otherwise have been placed, if it had been relevant.</p>
+ <p>If the <code><a href=#the-a-element>a</a></code> element has no <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute,
+ then the element <a href=#represents>represents</a> a placeholder for where a link might otherwise have been
+ placed, if it had been relevant, consisting of just the element's contents.</p>
- <p>The <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>,
-<!--DOWNLOAD--><!--PING-->
- <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code>,
- <code title=attr-hyperlink-ping><a href=#ping>ping</a></code>,
-<!--DOWNLOAD--><!--PING-->
- <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code>, <code title=attr-hyperlink-media><a href=#attr-hyperlink-media>media</a></code>, <code title=attr-hyperlink-hreflang><a href=#attr-hyperlink-hreflang>hreflang</a></code>, and <code title=attr-hyperlink-type><a href=#attr-hyperlink-type>type</a></code> attributes must be omitted
- if the <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute is
- not present.</p>
+ <p>The <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>, <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code>, <code title=attr-hyperlink-ping><a href=#ping>ping</a></code>,
+ <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code>, <code title=attr-hyperlink-media><a href=#attr-hyperlink-media>media</a></code>,
+ <code title=attr-hyperlink-hreflang><a href=#attr-hyperlink-hreflang>hreflang</a></code>, and <code title=attr-hyperlink-type><a href=#attr-hyperlink-type>type</a></code> attributes must be omitted if the <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute is not present.</p>
-<!--MD-->
- <p>If the <code title=attr-itemprop><a href=#names:-the-itemprop-attribute>itemprop</a></code> is specified
- on an <code><a href=#the-a-element>a</a></code> element, then the <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute must also be
- specified.</p>
-<!--MD-->
+ <p>If the <code title=attr-itemprop><a href=#names:-the-itemprop-attribute>itemprop</a></code> is specified on an <code><a href=#the-a-element>a</a></code> element,
+ then the <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute must also be specified.</p>
<div class=example>
- <p>If a site uses a consistent navigation toolbar on every page,
- then the link that would normally link to the page itself could be
- marked up using an <code><a href=#the-a-element>a</a></code> element:</p>
+
+ <p>If a site uses a consistent navigation toolbar on every page, then the link that would
+ normally link to the page itself could be marked up using an <code><a href=#the-a-element>a</a></code> element:</p>
+
<pre><nav>
<ul>
<li> <a href="/">Home</a> </li>
@@ -21227,80 +21218,52 @@
<li> <a href="/legal">Legal</a> </li>
</ul>
</nav></pre>
+
</div>
<div class=impl>
- <p>The <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code>,
- <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>,
-<!--DOWNLOAD--><!--PING-->
- <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code>, and
- <code title=attr-hyperlink-ping><a href=#ping>ping</a></code>
-<!--DOWNLOAD--><!--PING-->
- attributes affect what happens when users <a href=#following-hyperlinks title="following
- hyperlinks">follow hyperlinks</a>
-<!--DOWNLOAD-->
- or <a href=#downloading-hyperlinks title="downloading hyperlinks">download hyperlinks</a>
-<!--DOWNLOAD-->
- created using the <code><a href=#the-a-element>a</a></code> element. The
- <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code>, <code title=attr-hyperlink-media><a href=#attr-hyperlink-media>media</a></code>, <code title=attr-hyperlink-hreflang><a href=#attr-hyperlink-hreflang>hreflang</a></code>, and <code title=attr-hyperlink-type><a href=#attr-hyperlink-type>type</a></code> attributes may be used to
- indicate to the user the likely nature of the target resource before
- the user follows the link.</p>
+ <p>The <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code>, <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>, <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code>, and <code title=attr-hyperlink-ping><a href=#ping>ping</a></code>
+ attributes affect what happens when users <a href=#following-hyperlinks title="following hyperlinks">follow
+ hyperlinks</a> or <a href=#downloading-hyperlinks title="downloading hyperlinks">download hyperlinks</a> created using
+ the <code><a href=#the-a-element>a</a></code> element. The <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code>, <code title=attr-hyperlink-media><a href=#attr-hyperlink-media>media</a></code>, <code title=attr-hyperlink-hreflang><a href=#attr-hyperlink-hreflang>hreflang</a></code>,
+ and <code title=attr-hyperlink-type><a href=#attr-hyperlink-type>type</a></code> attributes may be used to indicate to the user
+ the likely nature of the target resource before the user follows the link.</p>
- <p>The <a href=#activation-behavior>activation behavior</a> of <code><a href=#the-a-element>a</a></code> elements
- that create <a href=#hyperlink title=hyperlink>hyperlinks</a> is to run the
- following steps:</p>
+ <p>The <a href=#activation-behavior>activation behavior</a> of <code><a href=#the-a-element>a</a></code> elements that create <a href=#hyperlink title=hyperlink>hyperlinks</a> is to run the following steps:</p>
- <ol><li><p>If the algorithm is not <a href=#allowed-to-show-a-pop-up>allowed to show a
- pop-up</a> and either the <code><a href=#the-a-element>a</a></code>
-<!--DOWNLOAD-->
- element has a <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute or the
-<!--DOWNLOAD-->
- element's <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>
- attribute is present and applying <a href=#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name>the rules for choosing a
- browsing context given a browsing context name</a>, using the
- value of the <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>
- attribute as the browsing context name, would result in there not
- being a chosen browsing context, then throw an
- <code><a href=#invalidaccesserror>InvalidAccessError</a></code> exception and abort these
- steps.</li>
+ <ol><li><p>If the algorithm is not <a href=#allowed-to-show-a-pop-up>allowed to show a pop-up</a> and either the
+ <code><a href=#the-a-element>a</a></code> element has a <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute or
+ the element's <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code> attribute is present and applying
+ <a href=#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name>the rules for choosing a browsing context given a browsing context name</a>, using the
+ value of the <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code> attribute as the browsing context
+ name, would result in there not being a chosen browsing context, then throw an
+ <code><a href=#invalidaccesserror>InvalidAccessError</a></code> exception and abort these steps.</li>
- <li><p>If the target of the <code title=event-click><a href=#event-click>click</a></code>
- event is an <code><a href=#the-img-element>img</a></code> element with an <code title=attr-img-ismap><a href=#attr-img-ismap>ismap</a></code> attribute specified, then
- server-side image map processing must be performed, as follows:</p>
+ <li><p>If the target of the <code title=event-click><a href=#event-click>click</a></code> event is an <code><a href=#the-img-element>img</a></code>
+ element with an <code title=attr-img-ismap><a href=#attr-img-ismap>ismap</a></code> attribute specified, then server-side
+ image map processing must be performed, as follows:</p>
- <ol><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20html%3E%0A...%3Ca%20href%3D%22%23%22%3E%3Cimg%20ismap%20usemap%3D%22%23a%22%20src%3D/resources/images/smallcats%3E%3C/a%3E%0A%3Cmap%20name%3Da%3E%3Carea%20shape%3Drect%20coords%3D0%2C0%2C50%2C50%20href%3Db%3E%3C/map%3E --><li>If the <code title=event-click><a href=#event-click>click</a></code> event was a
- real pointing-device-triggered <code title=event-click><a href=#event-click>click</a></code> event on the <code><a href=#the-img-element>img</a></code>
- element, then let <var title="">x</var> be the distance in CSS
- pixels from the left edge of the image's left border, if it has
- one, or the left edge of the image otherwise, to the location of
- the click, and let <var title="">y</var> be the distance in CSS
- pixels from the top edge of the image's top border, if it has
- one, or the top edge of the image otherwise, to the location of
- the click. Otherwise, let <var title="">x</var> and <var title="">y</var> be zero.</li>
+ <ol><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20html%3E%0A...%3Ca%20href%3D%22%23%22%3E%3Cimg%20ismap%20usemap%3D%22%23a%22%20src%3D/resources/images/smallcats%3E%3C/a%3E%0A%3Cmap%20name%3Da%3E%3Carea%20shape%3Drect%20coords%3D0%2C0%2C50%2C50%20href%3Db%3E%3C/map%3E --><li>If the <code title=event-click><a href=#event-click>click</a></code> event was a real pointing-device-triggered
+ <code title=event-click><a href=#event-click>click</a></code> event on the <code><a href=#the-img-element>img</a></code> element, then let <var title="">x</var> be the distance in CSS pixels from the left edge of the image's left border,
+ if it has one, or the left edge of the image otherwise, to the location of the click, and let
+ <var title="">y</var> be the distance in CSS pixels from the top edge of the image's top
+ border, if it has one, or the top edge of the image otherwise, to the location of the click.
+ Otherwise, let <var title="">x</var> and <var title="">y</var> be zero.</li>
- <li>Let the <dfn id=hyperlink-suffix><var>hyperlink suffix</var></dfn> be a U+003F
- QUESTION MARK character, the value of <var title="">x</var>
- expressed as a base-ten integer using ASCII digits, a U+002C
- COMMA character (,), and the value of <var title="">y</var>
- expressed as a base-ten integer using ASCII digits. ASCII digits
- are the characters in the range U+0030 DIGIT ZERO (0) to U+0039
- DIGIT NINE (9).</li>
+ <li>Let the <dfn id=hyperlink-suffix><var>hyperlink suffix</var></dfn> be a U+003F QUESTION MARK character, the
+ value of <var title="">x</var> expressed as a base-ten integer using ASCII digits, a U+002C
+ COMMA character (,), and the value of <var title="">y</var> expressed as a base-ten integer
+ using ASCII digits. ASCII digits are the characters in the range U+0030 DIGIT ZERO (0) to
+ U+0039 DIGIT NINE (9).</li>
</ol></li>
- <li><p>Finally, the user agent must <a href=#following-hyperlinks title="following
- hyperlinks">follow the hyperlink</a>
-<!--DOWNLOAD-->
- or <a href=#downloading-hyperlinks title="downloading hyperlinks">download the hyperlink</a>
-<!--DOWNLOAD-->
- created by the <code><a href=#the-a-element>a</a></code> element, as determined by
-<!--DOWNLOAD-->
- the <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute and
-<!--DOWNLOAD-->
- any expressed user preference. If the steps above defined a
- <var><a href=#hyperlink-suffix>hyperlink suffix</a></var>, then take that into account when
- following or downloading the hyperlink.</li>
+ <li><p>Finally, the user agent must <a href=#following-hyperlinks title="following hyperlinks">follow the
+ hyperlink</a> or <a href=#downloading-hyperlinks title="downloading hyperlinks">download the hyperlink</a> created by
+ the <code><a href=#the-a-element>a</a></code> element, as determined by the <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute and any expressed user preference. If
+ the steps above defined a <var><a href=#hyperlink-suffix>hyperlink suffix</a></var>, then take that into account when following
+ or downloading the hyperlink.</li>
</ol></div>
@@ -21315,46 +21278,34 @@
</dl><div class=impl>
- <p>The IDL attributes
- <dfn id=dom-a-href title=dom-a-href><code>href</code></dfn>,
-<!--DOWNLOAD--><!--PING-->
- <dfn id=dom-a-download title=dom-a-download><code>download</code></dfn>,
- <dfn id=dom-a-ping title=dom-a-ping><code>ping</code></dfn>,
-<!--DOWNLOAD--><!--PING-->
- <dfn id=dom-a-target title=dom-a-target><code>target</code></dfn>, <dfn id=dom-a-rel title=dom-a-rel><code>rel</code></dfn>, <dfn id=dom-a-media title=dom-a-media><code>media</code></dfn>, <dfn id=dom-a-hreflang title=dom-a-hreflang><code>hreflang</code></dfn>, and <dfn id=dom-a-type title=dom-a-type><code>type</code></dfn>, must
- <a href=#reflect>reflect</a> the respective content attributes of the same
- name.</p>
+ <p>The IDL attributes <dfn id=dom-a-href title=dom-a-href><code>href</code></dfn>, <dfn id=dom-a-download title=dom-a-download><code>download</code></dfn>, <dfn id=dom-a-ping title=dom-a-ping><code>ping</code></dfn>, <dfn id=dom-a-target title=dom-a-target><code>target</code></dfn>,
+ <dfn id=dom-a-rel title=dom-a-rel><code>rel</code></dfn>, <dfn id=dom-a-media title=dom-a-media><code>media</code></dfn>,
+ <dfn id=dom-a-hreflang title=dom-a-hreflang><code>hreflang</code></dfn>, and <dfn id=dom-a-type title=dom-a-type><code>type</code></dfn>, must <a href=#reflect>reflect</a> the respective content
+ attributes of the same name.</p>
<p>The IDL attribute <dfn id=dom-a-rellist title=dom-a-rellist><code>relList</code></dfn> must
- <a href=#reflect>reflect</a> the <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code>
- content attribute.</p>
+ <a href=#reflect>reflect</a> the <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code> content attribute.</p>
- <p>The <dfn id=dom-a-text title=dom-a-text><code>text</code></dfn> IDL
- attribute, on getting, must return the same value as the
- <code><a href=#textcontent>textContent</a></code> IDL attribute on the element, and on
- setting, must act as if the <code><a href=#textcontent>textContent</a></code> IDL attribute
- on the element had been set to the new value.</p>
+ <p>The <dfn id=dom-a-text title=dom-a-text><code>text</code></dfn> IDL attribute, on getting, must return the
+ same value as the <code><a href=#textcontent>textContent</a></code> IDL attribute on the element, and on setting, must act
+ as if the <code><a href=#textcontent>textContent</a></code> IDL attribute on the element had been set to the new value.</p>
- <p>The <code><a href=#the-a-element>a</a></code> element also supports the complement of
- <a href=#url-decomposition-idl-attributes>URL decomposition IDL attributes</a>, <dfn id=dom-a-protocol title=dom-a-protocol><code>protocol</code></dfn>, <dfn id=dom-a-host title=dom-a-host><code>host</code></dfn>, <dfn id=dom-a-port title=dom-a-port><code>port</code></dfn>, <dfn id=dom-a-hostname title=dom-a-hostname><code>hostname</code></dfn>, <dfn id=dom-a-pathname title=dom-a-pathname><code>pathname</code></dfn>, <dfn id=dom-a-search title=dom-a-search><code>search</code></dfn>, and <dfn id=dom-a-hash title=dom-a-hash><code>hash</code></dfn>. These must follow the
- rules given for <a href=#url-decomposition-idl-attributes>URL decomposition IDL attributes</a>, with
- the <a href=#concept-uda-input title=concept-uda-input>input</a> being the result of
- <a href=#resolve-a-url title="resolve a url">resolving</a> the element's <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute relative to the
- element, if there is such an attribute and resolving it is
- successful, or the empty string otherwise; and the <a href=#concept-uda-setter title=concept-uda-setter>common setter action</a> being the
- same as setting the element's <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute to the new output
- value.</p>
+ <p>The <code><a href=#the-a-element>a</a></code> element also supports the complement of <a href=#url-decomposition-idl-attributes>URL decomposition IDL
+ attributes</a>, <dfn id=dom-a-protocol title=dom-a-protocol><code>protocol</code></dfn>, <dfn id=dom-a-host title=dom-a-host><code>host</code></dfn>, <dfn id=dom-a-port title=dom-a-port><code>port</code></dfn>, <dfn id=dom-a-hostname title=dom-a-hostname><code>hostname</code></dfn>, <dfn id=dom-a-pathname title=dom-a-pathname><code>pathname</code></dfn>, <dfn id=dom-a-search title=dom-a-search><code>search</code></dfn>, and <dfn id=dom-a-hash title=dom-a-hash><code>hash</code></dfn>. These must follow the rules given for <a href=#url-decomposition-idl-attributes>URL
+ decomposition IDL attributes</a>, with the <a href=#concept-uda-input title=concept-uda-input>input</a> being
+ the result of <a href=#resolve-a-url title="resolve a url">resolving</a> the element's <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute relative to the element, if there is such an
+ attribute and resolving it is successful, or the empty string otherwise; and the <a href=#concept-uda-setter title=concept-uda-setter>common setter action</a> being the same as setting the element's
+ <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute to the new output value.</p>
</div>
<!--TOPIC:HTML-->
<div class=example>
- <p>The <code><a href=#the-a-element>a</a></code> element may be wrapped around entire
- paragraphs, lists, tables, and so forth, even entire sections, so
- long as there is no interactive content within (e.g. buttons or
- other links). This example shows how this can be used to make an
- entire advertising block into a link:</p>
+ <p>The <code><a href=#the-a-element>a</a></code> element may be wrapped around entire paragraphs, lists, tables, and so
+ forth, even entire sections, so long as there is no interactive content within (e.g. buttons or
+ other links). This example shows how this can be used to make an entire advertising block into a
+ link:</p>
<pre><aside class="advertising">
<h1>Advertising</h1>
Modified: index
===================================================================
--- index 2012-10-19 22:32:45 UTC (rev 7478)
+++ index 2012-10-19 22:35:50 UTC (rev 7479)
@@ -21186,39 +21186,30 @@
attribute DOMString <a href=#dom-a-hash title=dom-a-hash>hash</a>;
};</pre>
</dd>
- </dl><!--TOPIC:HTML--><p>If the <code><a href=#the-a-element>a</a></code> element has an <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute, then it
- <a href=#represents>represents</a> a <a href=#hyperlink>hyperlink</a> (a hypertext
- anchor).</p>
+ </dl><!--TOPIC:HTML--><p>If the <code><a href=#the-a-element>a</a></code> element has an <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute,
+ then it <a href=#represents>represents</a> a <a href=#hyperlink>hyperlink</a> (a hypertext anchor) labeled by its
+ contents.</p>
- <!-- v2: Eric Meyer requests the ability to nest links so that a big
- hyperlink, e.g. representing a calendar event, can be clickable,
- while within it there are subareas that represent links to distinct
- areas, e.g. a link to see photos of the event, or to edit the event,
- or some such. -->
+ <!-- v2: Eric Meyer requests the ability to nest links so that a big hyperlink, e.g. representing
+ a calendar event, can be clickable, while within it there are subareas that represent links to
+ distinct areas, e.g. a link to see photos of the event, or to edit the event, or some such. -->
- <p>If the <code><a href=#the-a-element>a</a></code> element has no <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute, then the element
- <a href=#represents>represents</a> a placeholder for where a link might
- otherwise have been placed, if it had been relevant.</p>
+ <p>If the <code><a href=#the-a-element>a</a></code> element has no <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute,
+ then the element <a href=#represents>represents</a> a placeholder for where a link might otherwise have been
+ placed, if it had been relevant, consisting of just the element's contents.</p>
- <p>The <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>,
-<!--DOWNLOAD--><!--PING-->
- <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code>,
- <code title=attr-hyperlink-ping><a href=#ping>ping</a></code>,
-<!--DOWNLOAD--><!--PING-->
- <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code>, <code title=attr-hyperlink-media><a href=#attr-hyperlink-media>media</a></code>, <code title=attr-hyperlink-hreflang><a href=#attr-hyperlink-hreflang>hreflang</a></code>, and <code title=attr-hyperlink-type><a href=#attr-hyperlink-type>type</a></code> attributes must be omitted
- if the <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute is
- not present.</p>
+ <p>The <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>, <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code>, <code title=attr-hyperlink-ping><a href=#ping>ping</a></code>,
+ <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code>, <code title=attr-hyperlink-media><a href=#attr-hyperlink-media>media</a></code>,
+ <code title=attr-hyperlink-hreflang><a href=#attr-hyperlink-hreflang>hreflang</a></code>, and <code title=attr-hyperlink-type><a href=#attr-hyperlink-type>type</a></code> attributes must be omitted if the <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute is not present.</p>
-<!--MD-->
- <p>If the <code title=attr-itemprop><a href=#names:-the-itemprop-attribute>itemprop</a></code> is specified
- on an <code><a href=#the-a-element>a</a></code> element, then the <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute must also be
- specified.</p>
-<!--MD-->
+ <p>If the <code title=attr-itemprop><a href=#names:-the-itemprop-attribute>itemprop</a></code> is specified on an <code><a href=#the-a-element>a</a></code> element,
+ then the <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute must also be specified.</p>
<div class=example>
- <p>If a site uses a consistent navigation toolbar on every page,
- then the link that would normally link to the page itself could be
- marked up using an <code><a href=#the-a-element>a</a></code> element:</p>
+
+ <p>If a site uses a consistent navigation toolbar on every page, then the link that would
+ normally link to the page itself could be marked up using an <code><a href=#the-a-element>a</a></code> element:</p>
+
<pre><nav>
<ul>
<li> <a href="/">Home</a> </li>
@@ -21227,80 +21218,52 @@
<li> <a href="/legal">Legal</a> </li>
</ul>
</nav></pre>
+
</div>
<div class=impl>
- <p>The <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code>,
- <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>,
-<!--DOWNLOAD--><!--PING-->
- <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code>, and
- <code title=attr-hyperlink-ping><a href=#ping>ping</a></code>
-<!--DOWNLOAD--><!--PING-->
- attributes affect what happens when users <a href=#following-hyperlinks title="following
- hyperlinks">follow hyperlinks</a>
-<!--DOWNLOAD-->
- or <a href=#downloading-hyperlinks title="downloading hyperlinks">download hyperlinks</a>
-<!--DOWNLOAD-->
- created using the <code><a href=#the-a-element>a</a></code> element. The
- <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code>, <code title=attr-hyperlink-media><a href=#attr-hyperlink-media>media</a></code>, <code title=attr-hyperlink-hreflang><a href=#attr-hyperlink-hreflang>hreflang</a></code>, and <code title=attr-hyperlink-type><a href=#attr-hyperlink-type>type</a></code> attributes may be used to
- indicate to the user the likely nature of the target resource before
- the user follows the link.</p>
+ <p>The <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code>, <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>, <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code>, and <code title=attr-hyperlink-ping><a href=#ping>ping</a></code>
+ attributes affect what happens when users <a href=#following-hyperlinks title="following hyperlinks">follow
+ hyperlinks</a> or <a href=#downloading-hyperlinks title="downloading hyperlinks">download hyperlinks</a> created using
+ the <code><a href=#the-a-element>a</a></code> element. The <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code>, <code title=attr-hyperlink-media><a href=#attr-hyperlink-media>media</a></code>, <code title=attr-hyperlink-hreflang><a href=#attr-hyperlink-hreflang>hreflang</a></code>,
+ and <code title=attr-hyperlink-type><a href=#attr-hyperlink-type>type</a></code> attributes may be used to indicate to the user
+ the likely nature of the target resource before the user follows the link.</p>
- <p>The <a href=#activation-behavior>activation behavior</a> of <code><a href=#the-a-element>a</a></code> elements
- that create <a href=#hyperlink title=hyperlink>hyperlinks</a> is to run the
- following steps:</p>
+ <p>The <a href=#activation-behavior>activation behavior</a> of <code><a href=#the-a-element>a</a></code> elements that create <a href=#hyperlink title=hyperlink>hyperlinks</a> is to run the following steps:</p>
- <ol><li><p>If the algorithm is not <a href=#allowed-to-show-a-pop-up>allowed to show a
- pop-up</a> and either the <code><a href=#the-a-element>a</a></code>
-<!--DOWNLOAD-->
- element has a <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute or the
-<!--DOWNLOAD-->
- element's <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>
- attribute is present and applying <a href=#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name>the rules for choosing a
- browsing context given a browsing context name</a>, using the
- value of the <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code>
- attribute as the browsing context name, would result in there not
- being a chosen browsing context, then throw an
- <code><a href=#invalidaccesserror>InvalidAccessError</a></code> exception and abort these
- steps.</li>
+ <ol><li><p>If the algorithm is not <a href=#allowed-to-show-a-pop-up>allowed to show a pop-up</a> and either the
+ <code><a href=#the-a-element>a</a></code> element has a <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute or
+ the element's <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code> attribute is present and applying
+ <a href=#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name>the rules for choosing a browsing context given a browsing context name</a>, using the
+ value of the <code title=attr-hyperlink-target><a href=#attr-hyperlink-target>target</a></code> attribute as the browsing context
+ name, would result in there not being a chosen browsing context, then throw an
+ <code><a href=#invalidaccesserror>InvalidAccessError</a></code> exception and abort these steps.</li>
- <li><p>If the target of the <code title=event-click><a href=#event-click>click</a></code>
- event is an <code><a href=#the-img-element>img</a></code> element with an <code title=attr-img-ismap><a href=#attr-img-ismap>ismap</a></code> attribute specified, then
- server-side image map processing must be performed, as follows:</p>
+ <li><p>If the target of the <code title=event-click><a href=#event-click>click</a></code> event is an <code><a href=#the-img-element>img</a></code>
+ element with an <code title=attr-img-ismap><a href=#attr-img-ismap>ismap</a></code> attribute specified, then server-side
+ image map processing must be performed, as follows:</p>
- <ol><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20html%3E%0A...%3Ca%20href%3D%22%23%22%3E%3Cimg%20ismap%20usemap%3D%22%23a%22%20src%3D/resources/images/smallcats%3E%3C/a%3E%0A%3Cmap%20name%3Da%3E%3Carea%20shape%3Drect%20coords%3D0%2C0%2C50%2C50%20href%3Db%3E%3C/map%3E --><li>If the <code title=event-click><a href=#event-click>click</a></code> event was a
- real pointing-device-triggered <code title=event-click><a href=#event-click>click</a></code> event on the <code><a href=#the-img-element>img</a></code>
- element, then let <var title="">x</var> be the distance in CSS
- pixels from the left edge of the image's left border, if it has
- one, or the left edge of the image otherwise, to the location of
- the click, and let <var title="">y</var> be the distance in CSS
- pixels from the top edge of the image's top border, if it has
- one, or the top edge of the image otherwise, to the location of
- the click. Otherwise, let <var title="">x</var> and <var title="">y</var> be zero.</li>
+ <ol><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20html%3E%0A...%3Ca%20href%3D%22%23%22%3E%3Cimg%20ismap%20usemap%3D%22%23a%22%20src%3D/resources/images/smallcats%3E%3C/a%3E%0A%3Cmap%20name%3Da%3E%3Carea%20shape%3Drect%20coords%3D0%2C0%2C50%2C50%20href%3Db%3E%3C/map%3E --><li>If the <code title=event-click><a href=#event-click>click</a></code> event was a real pointing-device-triggered
+ <code title=event-click><a href=#event-click>click</a></code> event on the <code><a href=#the-img-element>img</a></code> element, then let <var title="">x</var> be the distance in CSS pixels from the left edge of the image's left border,
+ if it has one, or the left edge of the image otherwise, to the location of the click, and let
+ <var title="">y</var> be the distance in CSS pixels from the top edge of the image's top
+ border, if it has one, or the top edge of the image otherwise, to the location of the click.
+ Otherwise, let <var title="">x</var> and <var title="">y</var> be zero.</li>
- <li>Let the <dfn id=hyperlink-suffix><var>hyperlink suffix</var></dfn> be a U+003F
- QUESTION MARK character, the value of <var title="">x</var>
- expressed as a base-ten integer using ASCII digits, a U+002C
- COMMA character (,), and the value of <var title="">y</var>
- expressed as a base-ten integer using ASCII digits. ASCII digits
- are the characters in the range U+0030 DIGIT ZERO (0) to U+0039
- DIGIT NINE (9).</li>
+ <li>Let the <dfn id=hyperlink-suffix><var>hyperlink suffix</var></dfn> be a U+003F QUESTION MARK character, the
+ value of <var title="">x</var> expressed as a base-ten integer using ASCII digits, a U+002C
+ COMMA character (,), and the value of <var title="">y</var> expressed as a base-ten integer
+ using ASCII digits. ASCII digits are the characters in the range U+0030 DIGIT ZERO (0) to
+ U+0039 DIGIT NINE (9).</li>
</ol></li>
- <li><p>Finally, the user agent must <a href=#following-hyperlinks title="following
- hyperlinks">follow the hyperlink</a>
-<!--DOWNLOAD-->
- or <a href=#downloading-hyperlinks title="downloading hyperlinks">download the hyperlink</a>
-<!--DOWNLOAD-->
- created by the <code><a href=#the-a-element>a</a></code> element, as determined by
-<!--DOWNLOAD-->
- the <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute and
-<!--DOWNLOAD-->
- any expressed user preference. If the steps above defined a
- <var><a href=#hyperlink-suffix>hyperlink suffix</a></var>, then take that into account when
- following or downloading the hyperlink.</li>
+ <li><p>Finally, the user agent must <a href=#following-hyperlinks title="following hyperlinks">follow the
+ hyperlink</a> or <a href=#downloading-hyperlinks title="downloading hyperlinks">download the hyperlink</a> created by
+ the <code><a href=#the-a-element>a</a></code> element, as determined by the <code title=attr-hyperlink-download><a href=#attr-hyperlink-download>download</a></code> attribute and any expressed user preference. If
+ the steps above defined a <var><a href=#hyperlink-suffix>hyperlink suffix</a></var>, then take that into account when following
+ or downloading the hyperlink.</li>
</ol></div>
@@ -21315,46 +21278,34 @@
</dl><div class=impl>
- <p>The IDL attributes
- <dfn id=dom-a-href title=dom-a-href><code>href</code></dfn>,
-<!--DOWNLOAD--><!--PING-->
- <dfn id=dom-a-download title=dom-a-download><code>download</code></dfn>,
- <dfn id=dom-a-ping title=dom-a-ping><code>ping</code></dfn>,
-<!--DOWNLOAD--><!--PING-->
- <dfn id=dom-a-target title=dom-a-target><code>target</code></dfn>, <dfn id=dom-a-rel title=dom-a-rel><code>rel</code></dfn>, <dfn id=dom-a-media title=dom-a-media><code>media</code></dfn>, <dfn id=dom-a-hreflang title=dom-a-hreflang><code>hreflang</code></dfn>, and <dfn id=dom-a-type title=dom-a-type><code>type</code></dfn>, must
- <a href=#reflect>reflect</a> the respective content attributes of the same
- name.</p>
+ <p>The IDL attributes <dfn id=dom-a-href title=dom-a-href><code>href</code></dfn>, <dfn id=dom-a-download title=dom-a-download><code>download</code></dfn>, <dfn id=dom-a-ping title=dom-a-ping><code>ping</code></dfn>, <dfn id=dom-a-target title=dom-a-target><code>target</code></dfn>,
+ <dfn id=dom-a-rel title=dom-a-rel><code>rel</code></dfn>, <dfn id=dom-a-media title=dom-a-media><code>media</code></dfn>,
+ <dfn id=dom-a-hreflang title=dom-a-hreflang><code>hreflang</code></dfn>, and <dfn id=dom-a-type title=dom-a-type><code>type</code></dfn>, must <a href=#reflect>reflect</a> the respective content
+ attributes of the same name.</p>
<p>The IDL attribute <dfn id=dom-a-rellist title=dom-a-rellist><code>relList</code></dfn> must
- <a href=#reflect>reflect</a> the <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code>
- content attribute.</p>
+ <a href=#reflect>reflect</a> the <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code> content attribute.</p>
- <p>The <dfn id=dom-a-text title=dom-a-text><code>text</code></dfn> IDL
- attribute, on getting, must return the same value as the
- <code><a href=#textcontent>textContent</a></code> IDL attribute on the element, and on
- setting, must act as if the <code><a href=#textcontent>textContent</a></code> IDL attribute
- on the element had been set to the new value.</p>
+ <p>The <dfn id=dom-a-text title=dom-a-text><code>text</code></dfn> IDL attribute, on getting, must return the
+ same value as the <code><a href=#textcontent>textContent</a></code> IDL attribute on the element, and on setting, must act
+ as if the <code><a href=#textcontent>textContent</a></code> IDL attribute on the element had been set to the new value.</p>
- <p>The <code><a href=#the-a-element>a</a></code> element also supports the complement of
- <a href=#url-decomposition-idl-attributes>URL decomposition IDL attributes</a>, <dfn id=dom-a-protocol title=dom-a-protocol><code>protocol</code></dfn>, <dfn id=dom-a-host title=dom-a-host><code>host</code></dfn>, <dfn id=dom-a-port title=dom-a-port><code>port</code></dfn>, <dfn id=dom-a-hostname title=dom-a-hostname><code>hostname</code></dfn>, <dfn id=dom-a-pathname title=dom-a-pathname><code>pathname</code></dfn>, <dfn id=dom-a-search title=dom-a-search><code>search</code></dfn>, and <dfn id=dom-a-hash title=dom-a-hash><code>hash</code></dfn>. These must follow the
- rules given for <a href=#url-decomposition-idl-attributes>URL decomposition IDL attributes</a>, with
- the <a href=#concept-uda-input title=concept-uda-input>input</a> being the result of
- <a href=#resolve-a-url title="resolve a url">resolving</a> the element's <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute relative to the
- element, if there is such an attribute and resolving it is
- successful, or the empty string otherwise; and the <a href=#concept-uda-setter title=concept-uda-setter>common setter action</a> being the
- same as setting the element's <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute to the new output
- value.</p>
+ <p>The <code><a href=#the-a-element>a</a></code> element also supports the complement of <a href=#url-decomposition-idl-attributes>URL decomposition IDL
+ attributes</a>, <dfn id=dom-a-protocol title=dom-a-protocol><code>protocol</code></dfn>, <dfn id=dom-a-host title=dom-a-host><code>host</code></dfn>, <dfn id=dom-a-port title=dom-a-port><code>port</code></dfn>, <dfn id=dom-a-hostname title=dom-a-hostname><code>hostname</code></dfn>, <dfn id=dom-a-pathname title=dom-a-pathname><code>pathname</code></dfn>, <dfn id=dom-a-search title=dom-a-search><code>search</code></dfn>, and <dfn id=dom-a-hash title=dom-a-hash><code>hash</code></dfn>. These must follow the rules given for <a href=#url-decomposition-idl-attributes>URL
+ decomposition IDL attributes</a>, with the <a href=#concept-uda-input title=concept-uda-input>input</a> being
+ the result of <a href=#resolve-a-url title="resolve a url">resolving</a> the element's <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute relative to the element, if there is such an
+ attribute and resolving it is successful, or the empty string otherwise; and the <a href=#concept-uda-setter title=concept-uda-setter>common setter action</a> being the same as setting the element's
+ <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute to the new output value.</p>
</div>
<!--TOPIC:HTML-->
<div class=example>
- <p>The <code><a href=#the-a-element>a</a></code> element may be wrapped around entire
- paragraphs, lists, tables, and so forth, even entire sections, so
- long as there is no interactive content within (e.g. buttons or
- other links). This example shows how this can be used to make an
- entire advertising block into a link:</p>
+ <p>The <code><a href=#the-a-element>a</a></code> element may be wrapped around entire paragraphs, lists, tables, and so
+ forth, even entire sections, so long as there is no interactive content within (e.g. buttons or
+ other links). This example shows how this can be used to make an entire advertising block into a
+ link:</p>
<pre><aside class="advertising">
<h1>Advertising</h1>
Modified: source
===================================================================
--- source 2012-10-19 22:32:45 UTC (rev 7478)
+++ source 2012-10-19 22:35:50 UTC (rev 7479)
@@ -22718,45 +22718,33 @@
</dd>
</dl><!--TOPIC:HTML-->
- <p>If the <code>a</code> element has an <code
- title="attr-hyperlink-href">href</code> attribute, then it
- <span>represents</span> a <span>hyperlink</span> (a hypertext
- anchor).</p>
+ <p>If the <code>a</code> element has an <code title="attr-hyperlink-href">href</code> attribute,
+ then it <span>represents</span> a <span>hyperlink</span> (a hypertext anchor) labeled by its
+ contents.</p>
- <!-- v2: Eric Meyer requests the ability to nest links so that a big
- hyperlink, e.g. representing a calendar event, can be clickable,
- while within it there are subareas that represent links to distinct
- areas, e.g. a link to see photos of the event, or to edit the event,
- or some such. -->
+ <!-- v2: Eric Meyer requests the ability to nest links so that a big hyperlink, e.g. representing
+ a calendar event, can be clickable, while within it there are subareas that represent links to
+ distinct areas, e.g. a link to see photos of the event, or to edit the event, or some such. -->
- <p>If the <code>a</code> element has no <code
- title="attr-hyperlink-href">href</code> attribute, then the element
- <span>represents</span> a placeholder for where a link might
- otherwise have been placed, if it had been relevant.</p>
+ <p>If the <code>a</code> element has no <code title="attr-hyperlink-href">href</code> attribute,
+ then the element <span>represents</span> a placeholder for where a link might otherwise have been
+ placed, if it had been relevant, consisting of just the element's contents.</p>
- <p>The <code title="attr-hyperlink-target">target</code>,
-<!--END w3c-html--><!--DOWNLOAD--><!--PING-->
- <code title="attr-hyperlink-download">download</code>,
- <code title="attr-hyperlink-ping">ping</code>,
-<!--START w3c-html--><!--DOWNLOAD--><!--PING-->
- <code title="attr-hyperlink-rel">rel</code>, <code
- title="attr-hyperlink-media">media</code>, <code
- title="attr-hyperlink-hreflang">hreflang</code>, and <code
- title="attr-hyperlink-type">type</code> attributes must be omitted
- if the <code title="attr-hyperlink-href">href</code> attribute is
- not present.</p>
+ <p>The <code title="attr-hyperlink-target">target</code>, <code
+ title="attr-hyperlink-download">download</code>, <code title="attr-hyperlink-ping">ping</code>,
+ <code title="attr-hyperlink-rel">rel</code>, <code title="attr-hyperlink-media">media</code>,
+ <code title="attr-hyperlink-hreflang">hreflang</code>, and <code
+ title="attr-hyperlink-type">type</code> attributes must be omitted if the <code
+ title="attr-hyperlink-href">href</code> attribute is not present.</p>
-<!--END w3c-html--><!--MD-->
- <p>If the <code title="attr-itemprop">itemprop</code> is specified
- on an <code>a</code> element, then the <code
- title="attr-hyperlink-href">href</code> attribute must also be
- specified.</p>
-<!--START w3c-html--><!--MD-->
+ <p>If the <code title="attr-itemprop">itemprop</code> is specified on an <code>a</code> element,
+ then the <code title="attr-hyperlink-href">href</code> attribute must also be specified.</p>
<div class="example">
- <p>If a site uses a consistent navigation toolbar on every page,
- then the link that would normally link to the page itself could be
- marked up using an <code>a</code> element:</p>
+
+ <p>If a site uses a consistent navigation toolbar on every page, then the link that would
+ normally link to the page itself could be marked up using an <code>a</code> element:</p>
+
<pre><nav>
<ul>
<li> <a href="/">Home</a> </li>
@@ -22765,94 +22753,66 @@
<li> <a href="/legal">Legal</a> </li>
</ul>
</nav></pre>
+
</div>
<div class="impl">
- <p>The <code title="attr-hyperlink-href">href</code>,
- <code title="attr-hyperlink-target">target</code>,
-<!--END w3c-html--><!--DOWNLOAD--><!--PING-->
- <code title="attr-hyperlink-download">download</code>, and
- <code title="attr-hyperlink-ping">ping</code>
-<!--START w3c-html--><!--DOWNLOAD--><!--PING-->
- attributes affect what happens when users <span title="following
- hyperlinks">follow hyperlinks</span>
-<!--END w3c-html--><!--DOWNLOAD-->
- or <span title="downloading hyperlinks">download hyperlinks</span>
-<!--START w3c-html--><!--DOWNLOAD-->
- created using the <code>a</code> element. The
- <code title="attr-hyperlink-rel">rel</code>, <code
- title="attr-hyperlink-media">media</code>, <code
- title="attr-hyperlink-hreflang">hreflang</code>, and <code
- title="attr-hyperlink-type">type</code> attributes may be used to
- indicate to the user the likely nature of the target resource before
- the user follows the link.</p>
+ <p>The <code title="attr-hyperlink-href">href</code>, <code
+ title="attr-hyperlink-target">target</code>, <code
+ title="attr-hyperlink-download">download</code>, and <code title="attr-hyperlink-ping">ping</code>
+ attributes affect what happens when users <span title="following hyperlinks">follow
+ hyperlinks</span> or <span title="downloading hyperlinks">download hyperlinks</span> created using
+ the <code>a</code> element. The <code title="attr-hyperlink-rel">rel</code>, <code
+ title="attr-hyperlink-media">media</code>, <code title="attr-hyperlink-hreflang">hreflang</code>,
+ and <code title="attr-hyperlink-type">type</code> attributes may be used to indicate to the user
+ the likely nature of the target resource before the user follows the link.</p>
- <p>The <span>activation behavior</span> of <code>a</code> elements
- that create <span title="hyperlink">hyperlinks</span> is to run the
- following steps:</p>
+ <p>The <span>activation behavior</span> of <code>a</code> elements that create <span
+ title="hyperlink">hyperlinks</span> is to run the following steps:</p>
<ol>
- <li><p>If the algorithm is not <span>allowed to show a
- pop-up</span> and either the <code>a</code>
-<!--END w3c-html--><!--DOWNLOAD-->
- element has a <code title="attr-hyperlink-download">download</code> attribute or the
-<!--START w3c-html--><!--DOWNLOAD-->
- element's <code title="attr-hyperlink-target">target</code>
- attribute is present and applying <span>the rules for choosing a
- browsing context given a browsing context name</span>, using the
- value of the <code title="attr-hyperlink-target">target</code>
- attribute as the browsing context name, would result in there not
- being a chosen browsing context, then throw an
- <code>InvalidAccessError</code> exception and abort these
- steps.</p></li>
+ <li><p>If the algorithm is not <span>allowed to show a pop-up</span> and either the
+ <code>a</code> element has a <code title="attr-hyperlink-download">download</code> attribute or
+ the element's <code title="attr-hyperlink-target">target</code> attribute is present and applying
+ <span>the rules for choosing a browsing context given a browsing context name</span>, using the
+ value of the <code title="attr-hyperlink-target">target</code> attribute as the browsing context
+ name, would result in there not being a chosen browsing context, then throw an
+ <code>InvalidAccessError</code> exception and abort these steps.</p></li>
- <li><p>If the target of the <code title="event-click">click</code>
- event is an <code>img</code> element with an <code
- title="attr-img-ismap">ismap</code> attribute specified, then
- server-side image map processing must be performed, as follows:</p>
+ <li><p>If the target of the <code title="event-click">click</code> event is an <code>img</code>
+ element with an <code title="attr-img-ismap">ismap</code> attribute specified, then server-side
+ image map processing must be performed, as follows:</p>
<ol>
<!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20html%3E%0A...%3Ca%20href%3D%22%23%22%3E%3Cimg%20ismap%20usemap%3D%22%23a%22%20src%3D/resources/images/smallcats%3E%3C/a%3E%0A%3Cmap%20name%3Da%3E%3Carea%20shape%3Drect%20coords%3D0%2C0%2C50%2C50%20href%3Db%3E%3C/map%3E -->
- <li>If the <code title="event-click">click</code> event was a
- real pointing-device-triggered <code
- title="event-click">click</code> event on the <code>img</code>
- element, then let <var title="">x</var> be the distance in CSS
- pixels from the left edge of the image's left border, if it has
- one, or the left edge of the image otherwise, to the location of
- the click, and let <var title="">y</var> be the distance in CSS
- pixels from the top edge of the image's top border, if it has
- one, or the top edge of the image otherwise, to the location of
- the click. Otherwise, let <var title="">x</var> and <var
- title="">y</var> be zero.</li>
+ <li>If the <code title="event-click">click</code> event was a real pointing-device-triggered
+ <code title="event-click">click</code> event on the <code>img</code> element, then let <var
+ title="">x</var> be the distance in CSS pixels from the left edge of the image's left border,
+ if it has one, or the left edge of the image otherwise, to the location of the click, and let
+ <var title="">y</var> be the distance in CSS pixels from the top edge of the image's top
+ border, if it has one, or the top edge of the image otherwise, to the location of the click.
+ Otherwise, let <var title="">x</var> and <var title="">y</var> be zero.</li>
- <li>Let the <dfn><var>hyperlink suffix</var></dfn> be a U+003F
- QUESTION MARK character, the value of <var title="">x</var>
- expressed as a base-ten integer using ASCII digits, a U+002C
- COMMA character (,), and the value of <var title="">y</var>
- expressed as a base-ten integer using ASCII digits. ASCII digits
- are the characters in the range U+0030 DIGIT ZERO (0) to U+0039
- DIGIT NINE (9).</li>
+ <li>Let the <dfn><var>hyperlink suffix</var></dfn> be a U+003F QUESTION MARK character, the
+ value of <var title="">x</var> expressed as a base-ten integer using ASCII digits, a U+002C
+ COMMA character (,), and the value of <var title="">y</var> expressed as a base-ten integer
+ using ASCII digits. ASCII digits are the characters in the range U+0030 DIGIT ZERO (0) to
+ U+0039 DIGIT NINE (9).</li>
</ol>
</li>
- <li><p>Finally, the user agent must <span title="following
- hyperlinks">follow the hyperlink</span>
-<!--END w3c-html--><!--DOWNLOAD-->
- or <span title="downloading hyperlinks">download the hyperlink</span>
-<!--START w3c-html--><!--DOWNLOAD-->
- created by the <code>a</code> element, as determined by
-<!--END w3c-html--><!--DOWNLOAD-->
- the <code title="attr-hyperlink-download">download</code> attribute and
-<!--START w3c-html--><!--DOWNLOAD-->
- any expressed user preference. If the steps above defined a
- <var>hyperlink suffix</var>, then take that into account when
- following or downloading the hyperlink.</p></li>
+ <li><p>Finally, the user agent must <span title="following hyperlinks">follow the
+ hyperlink</span> or <span title="downloading hyperlinks">download the hyperlink</span> created by
+ the <code>a</code> element, as determined by the <code
+ title="attr-hyperlink-download">download</code> attribute and any expressed user preference. If
+ the steps above defined a <var>hyperlink suffix</var>, then take that into account when following
+ or downloading the hyperlink.</p></li>
</ol>
@@ -22873,61 +22833,44 @@
<div class="impl">
- <p>The IDL attributes
- <dfn title="dom-a-href"><code>href</code></dfn>,
-<!--END w3c-html--><!--DOWNLOAD--><!--PING-->
- <dfn title="dom-a-download"><code>download</code></dfn>,
- <dfn title="dom-a-ping"><code>ping</code></dfn>,
-<!--START w3c-html--><!--DOWNLOAD--><!--PING-->
- <dfn title="dom-a-target"><code>target</code></dfn>, <dfn
- title="dom-a-rel"><code>rel</code></dfn>, <dfn
- title="dom-a-media"><code>media</code></dfn>, <dfn
- title="dom-a-hreflang"><code>hreflang</code></dfn>, and <dfn
- title="dom-a-type"><code>type</code></dfn>, must
- <span>reflect</span> the respective content attributes of the same
- name.</p>
+ <p>The IDL attributes <dfn title="dom-a-href"><code>href</code></dfn>, <dfn
+ title="dom-a-download"><code>download</code></dfn>, <dfn
+ title="dom-a-ping"><code>ping</code></dfn>, <dfn title="dom-a-target"><code>target</code></dfn>,
+ <dfn title="dom-a-rel"><code>rel</code></dfn>, <dfn title="dom-a-media"><code>media</code></dfn>,
+ <dfn title="dom-a-hreflang"><code>hreflang</code></dfn>, and <dfn
+ title="dom-a-type"><code>type</code></dfn>, must <span>reflect</span> the respective content
+ attributes of the same name.</p>
- <p>The IDL attribute <dfn
- title="dom-a-rellist"><code>relList</code></dfn> must
- <span>reflect</span> the <code title="attr-hyperlink-rel">rel</code>
- content attribute.</p>
+ <p>The IDL attribute <dfn title="dom-a-rellist"><code>relList</code></dfn> must
+ <span>reflect</span> the <code title="attr-hyperlink-rel">rel</code> content attribute.</p>
- <p>The <dfn title="dom-a-text"><code>text</code></dfn> IDL
- attribute, on getting, must return the same value as the
- <code>textContent</code> IDL attribute on the element, and on
- setting, must act as if the <code>textContent</code> IDL attribute
- on the element had been set to the new value.</p>
+ <p>The <dfn title="dom-a-text"><code>text</code></dfn> IDL attribute, on getting, must return the
+ same value as the <code>textContent</code> IDL attribute on the element, and on setting, must act
+ as if the <code>textContent</code> IDL attribute on the element had been set to the new value.</p>
- <p>The <code>a</code> element also supports the complement of
- <span>URL decomposition IDL attributes</span>, <dfn
- title="dom-a-protocol"><code>protocol</code></dfn>, <dfn
- title="dom-a-host"><code>host</code></dfn>, <dfn
- title="dom-a-port"><code>port</code></dfn>, <dfn
+ <p>The <code>a</code> element also supports the complement of <span>URL decomposition IDL
+ attributes</span>, <dfn title="dom-a-protocol"><code>protocol</code></dfn>, <dfn
+ title="dom-a-host"><code>host</code></dfn>, <dfn title="dom-a-port"><code>port</code></dfn>, <dfn
title="dom-a-hostname"><code>hostname</code></dfn>, <dfn
title="dom-a-pathname"><code>pathname</code></dfn>, <dfn
title="dom-a-search"><code>search</code></dfn>, and <dfn
- title="dom-a-hash"><code>hash</code></dfn>. These must follow the
- rules given for <span>URL decomposition IDL attributes</span>, with
- the <span title="concept-uda-input">input</span> being the result of
- <span title="resolve a url">resolving</span> the element's <code
- title="attr-hyperlink-href">href</code> attribute relative to the
- element, if there is such an attribute and resolving it is
- successful, or the empty string otherwise; and the <span
- title="concept-uda-setter">common setter action</span> being the
- same as setting the element's <code
- title="attr-hyperlink-href">href</code> attribute to the new output
- value.</p>
+ title="dom-a-hash"><code>hash</code></dfn>. These must follow the rules given for <span>URL
+ decomposition IDL attributes</span>, with the <span title="concept-uda-input">input</span> being
+ the result of <span title="resolve a url">resolving</span> the element's <code
+ title="attr-hyperlink-href">href</code> attribute relative to the element, if there is such an
+ attribute and resolving it is successful, or the empty string otherwise; and the <span
+ title="concept-uda-setter">common setter action</span> being the same as setting the element's
+ <code title="attr-hyperlink-href">href</code> attribute to the new output value.</p>
</div>
<!--TOPIC:HTML-->
<div class="example">
- <p>The <code>a</code> element may be wrapped around entire
- paragraphs, lists, tables, and so forth, even entire sections, so
- long as there is no interactive content within (e.g. buttons or
- other links). This example shows how this can be used to make an
- entire advertising block into a link:</p>
+ <p>The <code>a</code> element may be wrapped around entire paragraphs, lists, tables, and so
+ forth, even entire sections, so long as there is no interactive content within (e.g. buttons or
+ other links). This example shows how this can be used to make an entire advertising block into a
+ link:</p>
<pre><aside class="advertising">
<h1>Advertising</h1>
More information about the Commit-Watchers
mailing list