- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 29 Nov 2008 23:00:25 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv29181
Modified Files:
Overview.html
Log Message:
Update guidance on writing alt='' text for markup generators to handle image links. (whatwg r2479)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1649
retrieving revision 1.1650
diff -u -d -r1.1649 -r1.1650
--- Overview.html 29 Nov 2008 22:57:18 -0000 1.1649
+++ Overview.html 29 Nov 2008 23:00:22 -0000 1.1650
@@ -12476,13 +12476,16 @@
start for writing the alternative text.<h6 id=guidance-for-markup-generators><span class=secno>4.8.2.1.13 </span>Guidance for markup generators</h6><p>Markup generators (such as WYSIWYG authoring tools) should,
wherever possible, obtain alternative text from their
users. However, it is recognised that in many cases, this will not
- be possible.<p>As a last resort, implementors should either set the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute to the empty string, under
+ be possible.<p>For images that are the sole contents of links, markup generators
+ should examine the link target to determine the title of the target,
+ or the URL of the target, and use information obtained in this
+ manner as the alternative text.<p>As a last resort, implementors should either set the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute to the empty string, under
the assumption that the image is a purely decorative image that
doesn't add any information but is still specific to the surrounding
content, or omit the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute
altogther, under the assumption that the image is a key part of the
- content.<p>Markup generators should generally avoid using the image's file
- name as the alternative text.<h4 id=the-iframe-element><span class=secno>4.8.3 </span>The <dfn><code>iframe</code></dfn> element</h4><dl class=element><dt>Categories</dt>
+ content.<p>Markup generators should generally avoid using the image's own
+ file name as the alternative text.<h4 id=the-iframe-element><span class=secno>4.8.3 </span>The <dfn><code>iframe</code></dfn> element</h4><dl class=element><dt>Categories</dt>
<dd><a href=#embedded-content-1>Embedded content</a>.</dd>
<dt>Contexts in which this element may be used:</dt>
<dd>Where <a href=#embedded-content-1>embedded content</a> is expected.</dd>
Received on Saturday, 29 November 2008 23:00:36 UTC