forked from w3c/wcag
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Restore H45 from w3c#2503 and add obsolete front-matter
- Loading branch information
1 parent
42d1ea6
commit 8c3164b
Showing
1 changed file
with
54 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,54 @@ | ||
| --- | ||
| obsoleteMessage: The <code class="att">longdesc</code> attribute is obsolete and not widely supported. | ||
| obsoleteSince: 20 | ||
| --- | ||
| <!DOCTYPE html><html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml"><head><title>Using longdesc</title><link rel="stylesheet" type="text/css" href="../../css/sources.css" class="remove"></link></head><body><h1>Using longdesc</h1><section class="meta"><p class="id">ID: H45</p><p class="technology">Technology: html</p><p class="type">Type: Technique</p></section><section id="applicability"><h2>When to Use</h2> | ||
| <p>HTML documents that include images that cannot be | ||
| described in a short text alternative. </p> | ||
| </section><section id="description"><h2>Description</h2> | ||
| <p> The objective of this technique is to provide information in a file designated by the | ||
| <code class="att">longdesc</code> attribute when a short text alternative does not adequately convey the function | ||
| or information provided in the image. The <code class="att">longdesc</code> attribute is a URI, the target of | ||
| which contains a long description of the non-text content. </p> | ||
| <p>Authors can provide a description for an image by including text in a separate resource or within the text of the page containing the image. An advantage of using a separate resource for the description is that it is easily reusable for multiple instances of the same image, it does not add on-page visual clutter to the original document, and the description's end-point is apparent to the user. An advantage of providing the description within the same page as the image is that all users can access the description. A limitation of the on-page method, as well as in providing multiple descriptions on a single separate page, is that current implementations supporting longdesc do not identify the long description's end-point. Authors can solve this by providing a well-formed description, which identifies the where the description ends.</p> | ||
| </section><section id="examples"><h2>Examples</h2> | ||
| <section class="example"> | ||
| <h3>Using longdesc to refer to a long description contained on a separate resource.</h3> | ||
| <pre xml:space="preserve"><p><img src="chart.gif" alt="a complex chart" longdesc="chartdesc.html"/></p></pre> | ||
| </section> | ||
| <section class="example"> | ||
| <h3>Using longdesc to refer to a long description within the same page.</h3> | ||
| <pre xml:space="preserve"><img longdesc="thispage.html#desc" alt="Line graph of the number of subscribers" src="http://www.company/images/graph.png"> | ||
| <div id="desc"> | ||
| <h3>Long Description: Line graph of the number of subscribers</h3> | ||
| <!-- Full Description of Graph --> | ||
| <p>Long description ends.</p> | ||
| <div></pre> | ||
| </section> | ||
| </section><section id="tests"><h2>Tests</h2> | ||
| <section class="procedure"><h3>Procedure</h3> | ||
| <ol> | ||
| <li>Check that the <code class="el">img</code> element has a longdesc attribute. </li> | ||
| <li>Check that the value of the <code class="att">longdesc</code> attribute is a valid URI of an existing resource.</li> | ||
| <li>Check that the content at the target of that URI contains a long description describing the original non-text content associated with it.</li> | ||
| </ol> | ||
| </section> | ||
| <section class="results"><h3>Expected Results</h3> | ||
| <ul> | ||
| <li> #1 through #3 are all true </li> | ||
| </ul> | ||
| </section> | ||
| </section><section id="related"><h2>Related Techniques</h2><ul> | ||
| <li><a href="../general/G73">G73</a></li> | ||
| <li><a href="../general/G74">G74</a></li> | ||
| <li><a href="../general/G92">G92</a></li> | ||
| <li><a href="../general/G94">G94</a></li> | ||
| </ul></section><section id="resources"><h2>Resources</h2> | ||
|
|
||
| <ul> | ||
| <li> | ||
| <a href="https://www.d.umn.edu/itss/training/online/moodle_downloads/accessibility_104/longdesc_tools.html">University of Minnesota Duluth listing of longdesc Tools</a> | ||
| </li> | ||
| </ul> | ||
|
|
||
| </section></body></html> |