- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 26 Aug 2010 18:01:19 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv19520
Modified Files:
Overview.html
Log Message:
Make a number of enumerated IDL attributes be limited to known values, for ease of feature testing. (whatwg r5360)
Index: Overview.html
===================================================================
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 @@
<p>He would play in the morning, he would play in the evening.</p>
</article></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><button name="rgb"><strong><img src="red" alt="sRGB profile"><img src="green" alt=""><img src="blue" alt=""></strong></button>
<button name="cmyk"><strong><img src="cyan" alt="CMYK profile"><img src="magenta" alt=""><img src="yellow" alt=""><img src="black" alt=""></strong></button></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><h1><strong><img src="earthdayheading.png" alt="Earth Day"></strong></h1></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.</p>
<strong><p><img src="rendering-mode-pie-chart.png" alt=""></p></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,<br>
The island of Shalott.</p></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 @@
><img src="1" alt=""><img src="1" alt=""><img src="0" alt=""
><img src="0" alt=""></strong></meter></p></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 @@
><img src="fsm-middle.png" alt=""
><a href="?go=right"><img src="fsm-right.png" alt="Right side."></a></p></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:01:21 UTC