[html5] r3015 - [giow] (2) Add the URL decomposition attributes to <a> and <area>.

whatwg at whatwg.org whatwg at whatwg.org
Tue Apr 28 17:29:57 PDT 2009


Author: ianh
Date: 2009-04-28 17:29:56 -0700 (Tue, 28 Apr 2009)
New Revision: 3015

Modified:
   index
   source
Log:
[giow] (2) Add the URL decomposition attributes to <a> and <area>.

Modified: index
===================================================================
--- index	2009-04-28 23:17:19 UTC (rev 3014)
+++ index	2009-04-29 00:29:56 UTC (rev 3015)
@@ -4765,9 +4765,9 @@
   requirements.</p>
 
   <p>On getting, if the <a href=#concept-uda-input title=concept-uda-input>input</a>
-  fulfills the condition given in the "getter condition" column
-  corresponding to the attribute in the table below, the user agent
-  must return the part of the <a href=#concept-uda-input title=concept-uda-input>input</a> URL given in the "component"
+  is an <a href=#absolute-url>absolute URL</a> that fulfills the condition given in
+  the "getter condition" column corresponding to the attribute in the
+  table below, the user agent must return the part of the <a href=#concept-uda-input title=concept-uda-input>input</a> URL given in the "component"
   column, with any prefixes specified in the "prefix" column
   appropriately added to the start of the string and any suffixes
   specified in the "suffix" column appropriately added to the end of
@@ -4777,10 +4777,11 @@
   <p>On setting, the new value must first be mutated as described by
   the "setter preprocessor" column, then mutated by %-escaping any
   characters in the new value that are not valid in the relevant
-  component as given by the "component" column. Then, if the resulting
-  new value fulfills the condition given in the "setter condition"
-  column, the user agent must make a new string <var title="">output</var> by replacing the component of the URL given by
-  the "component" column in the <a href=#concept-uda-input title=concept-uda-input>input</a> URL with the new value;
+  component as given by the "component" column. Then, if the <a href=#concept-uda-input title=concept-uda-input>input</a> is an <a href=#absolute-url>absolute
+  URL</a> and the resulting new value fulfills the condition given
+  in the "setter condition" column, the user agent must make a new
+  string <var title="">output</var> by replacing the component of the
+  URL given by the "component" column in the <a href=#concept-uda-input title=concept-uda-input>input</a> URL with the new value;
   otherwise, the user agent must let <var title="">output</var> be
   equal to the <a href=#concept-uda-input title=concept-uda-input>input</a>. Finally,
   the user agent must invoke the <a href=#concept-uda-setter title=concept-uda-setter>common setter action</a> with the
@@ -4819,14 +4820,14 @@
      <td>—
      <td>—
      <td>—
-     <td>—
+     <td>The new value is not the empty string and <a href=#concept-uda-input title=concept-uda-input>input</a> is hierarchical and uses a server-based naming authority
     <tr><td><dfn id=dom-uda-hostname title=dom-uda-hostname><code>hostname</code></dfn>
      <td><a href=#url-host title=url-host><host></a>
      <td><a href=#concept-uda-input title=concept-uda-input>input</a> is hierarchical and uses a server-based naming authority
      <td>—
      <td>—
      <td>Remove all leading U+002F SOLIDUS ("<code title="">/</code>") characters
-     <td>—
+     <td>The new value is not the empty string and <a href=#concept-uda-input title=concept-uda-input>input</a> is hierarchical and uses a server-based naming authority
     <tr><td><dfn id=dom-uda-port title=dom-uda-port><code>port</code></dfn>
      <td><a href=#url-port title=url-port><port></a>
      <td><a href=#concept-uda-input title=concept-uda-input>input</a> is hierarchical, uses a server-based naming authority, and contained a <a href=#url-port title=url-port><port></a> component (possibly an empty one)
@@ -4834,7 +4835,7 @@
      <td>—
      <td>Remove any characters in the new value that are not in the range U+0030 DIGIT ZERO .. U+0039 DIGIT NINE.
          If the resulting string is empty, set it to a single U+0030 DIGIT ZERO character ('0').
-     <td>—
+     <td><a href=#concept-uda-input title=concept-uda-input>input</a> is hierarchical and uses a server-based naming authority
     <tr><td><dfn id=dom-uda-pathname title=dom-uda-pathname><code>pathname</code></dfn>
      <td><a href=#url-path title=url-path><path></a>
      <td><a href=#concept-uda-input title=concept-uda-input>input</a> is hierarchical
@@ -13877,7 +13878,16 @@
            attribute DOMString <a href=#dom-a-media title=dom-a-media>media</a>;
            attribute DOMString <a href=#dom-a-hreflang title=dom-a-hreflang>hreflang</a>;
            attribute DOMString <a href=#dom-a-type title=dom-a-type>type</a>;
-};</pre><!-- XXX also support the URL decomposition attributes -->
+
+  // <a href=#url-decomposition-attributes>URL decomposition attributes</a>
+           attribute DOMString <a href=#dom-a-protocol title=dom-a-protocol>protocol</a>;
+           attribute DOMString <a href=#dom-a-host title=dom-a-host>host</a>;
+           attribute DOMString <a href=#dom-a-hostname title=dom-a-hostname>hostname</a>;
+           attribute DOMString <a href=#dom-a-port title=dom-a-port>port</a>;
+           attribute DOMString <a href=#dom-a-pathname title=dom-a-pathname>pathname</a>;
+           attribute DOMString <a href=#dom-a-search title=dom-a-search>search</a>;
+           attribute DOMString <a href=#dom-a-hash title=dom-a-hash>hash</a>;
+};</pre>
     <p>The <code title=command-ro><a href=#command-ro>Command</a></code> interface must also be implemented by
     this element.</p>
    </dd>
@@ -13969,6 +13979,14 @@
   <a href=#reflect>reflect</a> the <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code>
   content attribute.</p>
 
+  <p>The <code><a href=#the-a-element>a</a></code> element also suports the complement of
+  <a href=#url-decomposition-attributes>URL decomposition 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 URL decomposition attributes, 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-a-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 <a href=#concept-uda-setter title=concept-uda-setter>common setter action</a> being the
+  same as setting the element's <code title=attr-a-href>href</code>
+  attribute to the new output value.</p>
+
   </div>
 
   <div class=example>
@@ -25019,7 +25037,16 @@
            attribute DOMString <a href=#dom-area-media title=dom-area-media>media</a>;
            attribute DOMString <a href=#dom-area-hreflang title=dom-area-hreflang>hreflang</a>;
            attribute DOMString <a href=#dom-area-type title=dom-area-type>type</a>;
-};</pre><!-- XXX also support the URL decomposition attributes -->
+
+  // <a href=#url-decomposition-attributes>URL decomposition attributes</a>
+           attribute DOMString <a href=#dom-area-protocol title=dom-area-protocol>protocol</a>;
+           attribute DOMString <a href=#dom-area-host title=dom-area-host>host</a>;
+           attribute DOMString <a href=#dom-area-hostname title=dom-area-hostname>hostname</a>;
+           attribute DOMString <a href=#dom-area-port title=dom-area-port>port</a>;
+           attribute DOMString <a href=#dom-area-pathname title=dom-area-pathname>pathname</a>;
+           attribute DOMString <a href=#dom-area-search title=dom-area-search>search</a>;
+           attribute DOMString <a href=#dom-area-hash title=dom-area-hash>hash</a>;
+};</pre>
    </dd>
   </dl><p>The <code><a href=#the-area-element>area</a></code> element <a href=#represents>represents</a> either a
   hyperlink with some text and a corresponding area on an <a href=#image-map>image
@@ -25165,6 +25192,14 @@
   <a href=#reflect>reflect</a> the <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code>
   content attribute.</p>
 
+  <p>The <code><a href=#the-area-element>area</a></code> element also suports the complement of
+  <a href=#url-decomposition-attributes>URL decomposition attributes</a>, <dfn id=dom-area-protocol title=dom-area-protocol><code>protocol</code></dfn>, <dfn id=dom-area-host title=dom-area-host><code>host</code></dfn>, <dfn id=dom-area-port title=dom-area-port><code>port</code></dfn>, <dfn id=dom-area-hostname title=dom-area-hostname><code>hostname</code></dfn>, <dfn id=dom-area-pathname title=dom-area-pathname><code>pathname</code></dfn>, <dfn id=dom-area-search title=dom-area-search><code>search</code></dfn>, and <dfn id=dom-area-hash title=dom-area-hash><code>hash</code></dfn>. These must follow the
+  rules given for URL decomposition attributes, 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-area-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 <a href=#concept-uda-setter title=concept-uda-setter>common setter action</a> being the
+  same as setting the element's <code title=attr-area-href>href</code> attribute to the new output
+  value.</p>
+
   </div>
 
 

Modified: source
===================================================================
--- source	2009-04-28 23:17:19 UTC (rev 3014)
+++ source	2009-04-29 00:29:56 UTC (rev 3015)
@@ -4440,9 +4440,9 @@
   requirements.</p>
 
   <p>On getting, if the <span title="concept-uda-input">input</span>
-  fulfills the condition given in the "getter condition" column
-  corresponding to the attribute in the table below, the user agent
-  must return the part of the <span
+  is an <span>absolute URL</span> that fulfills the condition given in
+  the "getter condition" column corresponding to the attribute in the
+  table below, the user agent must return the part of the <span
   title="concept-uda-input">input</span> URL given in the "component"
   column, with any prefixes specified in the "prefix" column
   appropriately added to the start of the string and any suffixes
@@ -4453,11 +4453,12 @@
   <p>On setting, the new value must first be mutated as described by
   the "setter preprocessor" column, then mutated by %-escaping any
   characters in the new value that are not valid in the relevant
-  component as given by the "component" column. Then, if the resulting
-  new value fulfills the condition given in the "setter condition"
-  column, the user agent must make a new string <var
-  title="">output</var> by replacing the component of the URL given by
-  the "component" column in the <span
+  component as given by the "component" column. Then, if the <span
+  title="concept-uda-input">input</span> is an <span>absolute
+  URL</span> and the resulting new value fulfills the condition given
+  in the "setter condition" column, the user agent must make a new
+  string <var title="">output</var> by replacing the component of the
+  URL given by the "component" column in the <span
   title="concept-uda-input">input</span> URL with the new value;
   otherwise, the user agent must let <var title="">output</var> be
   equal to the <span title="concept-uda-input">input</span>. Finally,
@@ -4506,7 +4507,7 @@
      <td>—
      <td>—
      <td>—
-     <td>—
+     <td>The new value is not the empty string and <span title="concept-uda-input">input</span> is hierarchical and uses a server-based naming authority
     <tr>
      <td><dfn title="dom-uda-hostname"><code>hostname</code></dfn>
      <td><span title="url-host"><host></span>
@@ -4514,7 +4515,7 @@
      <td>—
      <td>—
      <td>Remove all leading U+002F SOLIDUS ("<code title="">/</code>") characters
-     <td>—
+     <td>The new value is not the empty string and <span title="concept-uda-input">input</span> is hierarchical and uses a server-based naming authority
     <tr>
      <td><dfn title="dom-uda-port"><code>port</code></dfn>
      <td><span title="url-port"><port></span>
@@ -4523,7 +4524,7 @@
      <td>—
      <td>Remove any characters in the new value that are not in the range U+0030 DIGIT ZERO .. U+0039 DIGIT NINE.
          If the resulting string is empty, set it to a single U+0030 DIGIT ZERO character ('0').
-     <td>—
+     <td><span title="concept-uda-input">input</span> is hierarchical and uses a server-based naming authority
     <tr>
      <td><dfn title="dom-uda-pathname"><code>pathname</code></dfn>
      <td><span title="url-path"><path></span>
@@ -14839,7 +14840,16 @@
            attribute DOMString <span title="dom-a-media">media</span>;
            attribute DOMString <span title="dom-a-hreflang">hreflang</span>;
            attribute DOMString <span title="dom-a-type">type</span>;
-};</pre><!-- XXX also support the URL decomposition attributes -->
+
+  // <span>URL decomposition attributes</span>
+           attribute DOMString <span title="dom-a-protocol">protocol</span>;
+           attribute DOMString <span title="dom-a-host">host</span>;
+           attribute DOMString <span title="dom-a-hostname">hostname</span>;
+           attribute DOMString <span title="dom-a-port">port</span>;
+           attribute DOMString <span title="dom-a-pathname">pathname</span>;
+           attribute DOMString <span title="dom-a-search">search</span>;
+           attribute DOMString <span title="dom-a-hash">hash</span>;
+};</pre>
     <p>The <code title="command-ro">Command</code> interface must also be implemented by
     this element.</p>
    </dd>
@@ -14971,6 +14981,25 @@
   <span>reflect</span> the <code title="attr-hyperlink-rel">rel</code>
   content attribute.</p>
 
+  <p>The <code>a</code> element also suports the complement of
+  <span>URL decomposition 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 URL decomposition attributes, 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-a-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-a-href">href</code>
+  attribute to the new output value.</p>
+
   </div>
 
   <div class="example">
@@ -27584,7 +27613,16 @@
            attribute DOMString <span title="dom-area-media">media</span>;
            attribute DOMString <span title="dom-area-hreflang">hreflang</span>;
            attribute DOMString <span title="dom-area-type">type</span>;
-};</pre><!-- XXX also support the URL decomposition attributes -->
+
+  // <span>URL decomposition attributes</span>
+           attribute DOMString <span title="dom-area-protocol">protocol</span>;
+           attribute DOMString <span title="dom-area-host">host</span>;
+           attribute DOMString <span title="dom-area-hostname">hostname</span>;
+           attribute DOMString <span title="dom-area-port">port</span>;
+           attribute DOMString <span title="dom-area-pathname">pathname</span>;
+           attribute DOMString <span title="dom-area-search">search</span>;
+           attribute DOMString <span title="dom-area-hash">hash</span>;
+};</pre>
    </dd>
   </dl>
 
@@ -27779,6 +27817,26 @@
   <span>reflect</span> the <code title="attr-hyperlink-rel">rel</code>
   content attribute.</p>
 
+  <p>The <code>area</code> element also suports the complement of
+  <span>URL decomposition attributes</span>, <dfn
+  title="dom-area-protocol"><code>protocol</code></dfn>, <dfn
+  title="dom-area-host"><code>host</code></dfn>, <dfn
+  title="dom-area-port"><code>port</code></dfn>, <dfn
+  title="dom-area-hostname"><code>hostname</code></dfn>, <dfn
+  title="dom-area-pathname"><code>pathname</code></dfn>, <dfn
+  title="dom-area-search"><code>search</code></dfn>, and <dfn
+  title="dom-area-hash"><code>hash</code></dfn>. These must follow the
+  rules given for URL decomposition attributes, 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-area-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-area-href">href</code> attribute to the new output
+  value.</p>
+
   </div>
 
 




More information about the Commit-Watchers mailing list