hixie: Make a number of enumerated IDL attributes be limited to known values, for ease of feature testing. (whatwg r5360) from poot on 2010-08-26 (public-html-diffs@w3.org from August 2010)

From: poot <cvsmail@w3.org>
Date: Fri, 27 Aug 2010 03:07:29 +0900 (JST)
To: public-html-diffs@w3.org
Message-Id: <20100826180729.48AF833B60@toro.w3.mag.keio.ac.jp>
hixie: Make a number of enumerated IDL attributes be limited to known
values, for ease of feature testing. (whatwg r5360)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.4276&r2=1.4277&f=h
http://html5.org/tools/web-apps-tracker?from=5359&to=5360

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4276
retrieving revision 1.4277
diff -u -d -r1.4276 -r1.4277
--- Overview.html 26 Aug 2010 05:50:30 -0000 1.4276
+++ Overview.html 26 Aug 2010 18:01:15 -0000 1.4277
@@ -17646,11 +17646,11 @@
  &lt;p&gt;He would play in the morning, he would play in the evening.&lt;/p&gt;
 &lt;/article&gt;</pre>
 
-  </div><h5 id="alt"><span class="secno">4.8.1.1 </span>Requirements for providing text to act as an alternative for images</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (missing-alt) blocks progress to Last Call</span><p>Except where otherwise specified, the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute must be specified and its
+  </div><h5 id="alt"><span class="secno">4.8.1.1 </span>Requirements for providing text to act as an alternative for images</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Except where otherwise specified, the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute must be specified and its
   value must not be empty; the value must be an appropriate
   replacement for the image. The specific requirements for the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute depend on what the image
   is intended to represent, as described in the following
-  sections.<h6 id="a-link-or-button-containing-nothing-but-the-image"><span class="secno">4.8.1.1.1 </span>A link or button containing nothing but the image</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>When an <a href="#the-a-element">a</a> element that creates a
+  sections.<h6 id="a-link-or-button-containing-nothing-but-the-image"><span class="secno">4.8.1.1.1 </span>A link or button containing nothing but the image</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>When an <a href="#the-a-element">a</a> element that creates a
   <a href="#hyperlink">hyperlink</a>, or a <code><a href="#the-button-element">button</a></code> element, has no
   textual content but contains one or more images, the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attributes must contain text that
   together convey the purpose of the link or button.<div class="example">
@@ -17689,7 +17689,7 @@
    <pre>&lt;button name="rgb"&gt;<strong>&lt;img src="red" alt="sRGB profile"&gt;&lt;img src="green" alt=""&gt;&lt;img src="blue" alt=""&gt;</strong>&lt;/button&gt;
 &lt;button name="cmyk"&gt;<strong>&lt;img src="cyan" alt="CMYK profile"&gt;&lt;img src="magenta" alt=""&gt;&lt;img src="yellow" alt=""&gt;&lt;img src="black" alt=""&gt;</strong>&lt;/button&gt;</pre>
 
-  </div><h6 id="a-phrase-or-paragraph-with-an-alternative-graphical-representation:-charts-diagrams-graphs-maps-illustrations"><span class="secno">4.8.1.1.2 </span>A phrase or paragraph with an alternative graphical representation: charts, diagrams, graphs, maps, illustrations</h6><p>Sometimes something can be more clearly stated in graphical
+  </div><h6 id="a-phrase-or-paragraph-with-an-alternative-graphical-representation:-charts-diagrams-graphs-maps-illustrations"><span class="secno">4.8.1.1.2 </span>A phrase or paragraph with an alternative graphical representation: charts, diagrams, graphs, maps, illustrations</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Sometimes something can be more clearly stated in graphical
   form, for example as a flowchart, a diagram, a graph, or a simple
   map showing directions. In such cases, an image can be given using
   the <code><a href="#the-img-element">img</a></code> element, but the lesser textual version must
@@ -17751,7 +17751,7 @@
    <code><a href="#the-figcaption-element">figcaption</a></code> element of a <code><a href="#the-figure-element">figure</a></code> with this
    image).</p>
 
-  </div><h6 id="a-short-phrase-or-label-with-an-alternative-graphical-representation:-icons-logos"><span class="secno">4.8.1.1.3 </span>A short phrase or label with an alternative graphical representation: icons, logos</h6><p>A document can contain information in iconic form. The icon is
+  </div><h6 id="a-short-phrase-or-label-with-an-alternative-graphical-representation:-icons-logos"><span class="secno">4.8.1.1.3 </span>A short phrase or label with an alternative graphical representation: icons, logos</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>A document can contain information in iconic form. The icon is
   intended to help users of visual browsers to recognize features at
   a glance.<p>In some cases, the icon is supplemental to a text label
   conveying the same meaning. In those cases, the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute must be present but must
@@ -17857,7 +17857,7 @@
    the text flows seamlessly into the surrounding text, as if the
    image had never been there in the first place.</p>
 
-  </div><h6 id="text-that-has-been-rendered-to-a-graphic-for-typographical-effect"><span class="secno">4.8.1.1.4 </span>Text that has been rendered to a graphic for typographical effect</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>Sometimes, an image just consists of text, and the purpose of the
+  </div><h6 id="text-that-has-been-rendered-to-a-graphic-for-typographical-effect"><span class="secno">4.8.1.1.4 </span>Text that has been rendered to a graphic for typographical effect</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Sometimes, an image just consists of text, and the purpose of the
   image is not to highlight the actual typographic effects used to
   render the text, but just to convey the text itself.<p>In such cases, the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code>
   attribute must be present but must consist of the same text as
@@ -17871,7 +17871,7 @@
 
    <pre>&lt;h1&gt;<strong>&lt;img src="earthdayheading.png" alt="Earth Day"&gt;</strong>&lt;/h1&gt;</pre>
 
-  </div><h6 id="a-graphical-representation-of-some-of-the-surrounding-text"><span class="secno">4.8.1.1.5 </span>A graphical representation of some of the surrounding text</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>In many cases, the image is actually just supplementary, and
+  </div><h6 id="a-graphical-representation-of-some-of-the-surrounding-text"><span class="secno">4.8.1.1.5 </span>A graphical representation of some of the surrounding text</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>In many cases, the image is actually just supplementary, and
   its presence merely reinforces the surrounding text. In these
   cases, the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute must be
   present but its value must be the empty string.<p>In general, an image falls into this category if removing the
@@ -17941,7 +17941,7 @@
 Standards mode, and about 9% triggered the Standards mode.&lt;/p&gt;
 <strong>&lt;p&gt;&lt;img src="rendering-mode-pie-chart.png" alt=""&gt;&lt;/p&gt;</strong></pre>
 
-  </div><h6 id="a-purely-decorative-image-that-doesn-t-add-any-information"><span class="secno">4.8.1.1.6 </span>A purely decorative image that doesn't add any information</h6><p>In general, if an image is decorative but isn't especially
+  </div><h6 id="a-purely-decorative-image-that-doesn-t-add-any-information"><span class="secno">4.8.1.1.6 </span>A purely decorative image that doesn't add any information</h6><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>In general, if an image is decorative but isn't especially
   page-specific, for example an image that forms part of a site-wide
   design scheme, the image should be specified in the site's CSS,
   not in the markup of the document.<p>However, a decorative image that isn't discussed by the
@@ -17969,7 +17969,7 @@
 Round an island there below,&lt;br&gt;
 The island of Shalott.&lt;/p&gt;</pre>
 
-  </div><h6 id="a-group-of-images-that-form-a-single-larger-picture-with-no-links"><span class="secno">4.8.1.1.7 </span>A group of images that form a single larger picture with no links</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>When a picture has been sliced into smaller image files that are
+  </div><h6 id="a-group-of-images-that-form-a-single-larger-picture-with-no-links"><span class="secno">4.8.1.1.7 </span>A group of images that form a single larger picture with no links</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>When a picture has been sliced into smaller image files that are
   then displayed together to form the complete picture again, one of
   the images must have its <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code>
   attribute set as per the relevant rules that would be appropriate
@@ -17998,7 +17998,7 @@
   &gt;&lt;img src="1" alt=""&gt;&lt;img src="1" alt=""&gt;&lt;img src="0" alt=""
   &gt;&lt;img src="0" alt=""&gt;</strong>&lt;/meter&gt;&lt;/p&gt;</pre>
 
-  </div><h6 id="a-group-of-images-that-form-a-single-larger-picture-with-links"><span class="secno">4.8.1.1.8 </span>A group of images that form a single larger picture with links</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>Generally, <a href="#image-map" title="image map">image maps</a> should be
+  </div><h6 id="a-group-of-images-that-form-a-single-larger-picture-with-links"><span class="secno">4.8.1.1.8 </span>A group of images that form a single larger picture with links</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Generally, <a href="#image-map" title="image map">image maps</a> should be
   used instead of slicing an image for links.<p>However, if an image is indeed sliced and any of the components
   of the sliced picture are the sole contents of links, then one image
   per link must have alternative text in its <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute representing the purpose
@@ -18016,7 +18016,7 @@
   &gt;&lt;img src="fsm-middle.png" alt=""
   &gt;&lt;a href="?go=right"&gt;&lt;img src="fsm-right.png" alt="Right side."&gt;&lt;/a&gt;&lt;/p&gt;</strong></pre>
 
-  </div><h6 id="a-key-part-of-the-content"><span class="secno">4.8.1.1.9 </span>A key part of the content</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>In some cases, the image is a critical part of the
+  </div><h6 id="a-key-part-of-the-content"><span class="secno">4.8.1.1.9 </span>A key part of the content</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>In some cases, the image is a critical part of the
   content. This could be the case, for instance, on a page that is
   part of a photo gallery. The image is the whole <em>point</em> of
   the page containing it.<p>How to provide alternative text for an image that is a key part
@@ -18272,13 +18272,13 @@
 
    </dd>
 
-  </dl><h6 id="an-image-not-intended-for-the-user"><span class="secno">4.8.1.1.10 </span>An image not intended for the user</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>Generally authors should avoid using <code><a href="#the-img-element">img</a></code> elements
+  </dl><h6 id="an-image-not-intended-for-the-user"><span class="secno">4.8.1.1.10 </span>An image not intended for the user</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>Generally authors should avoid using <code><a href="#the-img-element">img</a></code> elements
   for purposes other than showing images.<p>If an <code><a href="#the-img-element">img</a></code> element is being used for purposes other
   than showing an image, e.g. as part of a service to count page
   views, then the <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute must
   be the empty string.<p>In such cases, the <code title="attr-dim-width"><a href="#attr-dim-width">width</a></code> and
   <code title="attr-dim-height"><a href="#attr-dim-height">height</a></code> attributes should both
-  be set to zero.<h6 id="an-image-in-an-e-mail-or-private-document-intended-for-a-specific-person-who-is-known-to-be-able-to-view-images"><span class="secno">4.8.1.1.11 </span>An image in an e-mail or private document intended for a specific person who is known to be able to view images</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section does not apply to documents that are publicly
+  be set to zero.<h6 id="an-image-in-an-e-mail-or-private-document-intended-for-a-specific-person-who-is-known-to-be-able-to-view-images"><span class="secno">4.8.1.1.11 </span>An image in an e-mail or private document intended for a specific person who is known to be able to view images</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p><i>This section does not apply to documents that are publicly
   accessible, or whose target audience is not necessarily personally
   known to the author, such as documents on a Web site, e-mails sent
   to public mailing lists, or software documentation.</i><p>When an image is included in a private communication (such as an
@@ -18290,7 +18290,7 @@
   the e-mail is still usable should the user use a mail client that
   does not support images, or should the document be forwarded on to
   other users whose abilities might not include easily seeing
-  images.<h6 id="general-guidelines"><span class="secno">4.8.1.1.12 </span>General guidelines</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The most general rule to consider when writing alternative text
+  images.<h6 id="general-guidelines"><span class="secno">4.8.1.1.12 </span>General guidelines</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/31">ISSUE-31</a> (alt-conformance-requirements) blocks progress to Last Call</span><p>The most general rule to consider when writing alternative text
   is the following: <strong>the intent is that replacing every image
   with the text of its <code title="attr-img-alt"><a href="#attr-img-alt">alt</a></code> attribute
   not change the meaning of the page</strong>.<p>So, in general, alternative text can be written by considering
@@ -21780,7 +21780,7 @@
 
   <p>The <dfn id="dom-media-preload" title="dom-media-preload"><code>preload</code></dfn> IDL
   attribute must <a href="#reflect">reflect</a> the content attribute of the
-  same name.</p>
+  same name, <a href="#limited-to-only-known-values">limited to only known values</a>.</p>
 
   </div><p class="note">The <code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code> attribute can overrride
   the <code title="attr-media-preload"><a href="#attr-media-preload">preload</a></code> attribute (since
@@ -38279,7 +38279,11 @@
   </div>
 --><div class="impl">
 
-  <p>The <dfn id="dom-command-type" title="dom-command-type"><code>type</code></dfn>, <dfn id="dom-command-label" title="dom-command-label"><code>label</code></dfn>, <dfn id="dom-command-icon" title="dom-command-icon"><code>icon</code></dfn>, <dfn id="dom-command-disabled" title="dom-command-disabled"><code>disabled</code></dfn>, <dfn id="dom-command-checked" title="dom-command-checked"><code>checked</code></dfn>, and <dfn id="dom-command-radiogroup" title="dom-command-radiogroup"><code>radiogroup</code></dfn><!--,
+  <p>The <dfn id="dom-command-type" title="dom-command-type"><code>type</code></dfn> IDL
+  attribute must <a href="#reflect">reflect</a> the content attribute of the
+  same name, <a href="#limited-to-only-known-values">limited to only known values</a>.</p>
+
+  <p>The <dfn id="dom-command-label" title="dom-command-label"><code>label</code></dfn>, <dfn id="dom-command-icon" title="dom-command-icon"><code>icon</code></dfn>, <dfn id="dom-command-disabled" title="dom-command-disabled"><code>disabled</code></dfn>, <dfn id="dom-command-checked" title="dom-command-checked"><code>checked</code></dfn>, and <dfn id="dom-command-radiogroup" title="dom-command-radiogroup"><code>radiogroup</code></dfn><!--,
   and <dfn title="dom-command-default"><code>default</code></dfn>-->
   IDL attributes must <a href="#reflect">reflect</a> the respective content
   attributes of the same name.</p>
Received on Thursday, 26 August 2010 18:02:17 UTC