Browse files

[] (0) Guidance on writing alt='' text for markup generators.

git-svn-id: http://svn.whatwg.org/webapps@2478 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
1 parent f2151b0 commit 6ff8350736efe8acc4be5bb8ffbbe41e87b04fbb @Hixie Hixie committed Nov 29, 2008
Showing with 39 additions and 1 deletion.
  1. +20 −1 index
  2. +19 −0 source
View
21 index
@@ -423,7 +423,8 @@
<li><a href=#a-key-part-of-the-content><span class=secno>4.8.2.1.9 </span>A key part of the content</a></li>
<li><a href=#an-image-not-intended-for-the-user><span class=secno>4.8.2.1.10 </span>An image not intended for the user</a></li>
<li><a href=#an-image-in-an-e-mail-or-document-intended-for-a-specific-person-who-is-known-to-be-able-to-view-images><span class=secno>4.8.2.1.11 </span>An image in an e-mail or document intended for a specific person who is known to be able to view images</a></li>
- <li><a href=#general-guidelines><span class=secno>4.8.2.1.12 </span>General guidelines</a></ol></ol></li>
+ <li><a href=#general-guidelines><span class=secno>4.8.2.1.12 </span>General guidelines</a></li>
+ <li><a href=#guidance-for-markup-generators><span class=secno>4.8.2.1.13 </span>Guidance for markup generators</a></ol></ol></li>
<li><a href=#the-iframe-element><span class=secno>4.8.3 </span>The <code>iframe</code> element</a></li>
<li><a href=#the-embed-element><span class=secno>4.8.4 </span>The <code>embed</code> element</a></li>
<li><a href=#the-object-element><span class=secno>4.8.5 </span>The <code>object</code> element</a></li>
@@ -15322,6 +15323,24 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
+ <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>
+
+ <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>
+
+ <p>Markup generators should generally avoid using the image's file
+ name as the alternative text.</p>
+
+
<h4 id=the-iframe-element><span class=secno>4.8.3 </span>The <dfn><code>iframe</code></dfn> element</h4>
View
19 source
@@ -16358,6 +16358,25 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
+ <h6>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>
+
+ <p>As a last resort, implementors should either set the <code
+ title="attr-img-alt">alt</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">alt</code> attribute
+ altogther, under the assumption that the image is a key part of the
+ content.</p>
+
+ <p>Markup generators should generally avoid using the image's file
+ name as the alternative text.</p>
+
+
<h4>The <dfn><code>iframe</code></dfn> element</h4>

0 comments on commit 6ff8350

Please sign in to comment.