HTML Standard Tracker


File a bug

SVNBugCommentTime (UTC)
2478Guidance on writing alt='' text for markup generators.2008-11-29 22:57
@@ -16351,20 +16351,39 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
   supplemental information.</p>
   <p class="note">One way to think of alternative text is to think
   about what how you would read the page containing the image to
   someone over the phone, without mentioning that there is an image
   present. Whatever you say instead of the image is typically a good
   start for writing the alternative text.</p>
+  <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>
   <dl class="element">
    <dd><span>Embedded content</span>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <span>embedded content</span> is expected.</dd>
    <dt>Content model:</dt>