blob: c4779a229b05ccdd2f3f8670fcfb1082c6e4b2e8 [file] [log] [blame]
Mark Sadecki8f35b802013-10-23 15:36:271
2<!doctype html>
3<html>
4<head>
5<meta charset="utf-8">
6<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
7<title>Multifunction tests</title>
8
9</head>
10<body>
11<h1>longdesc-tests</h1>
12
13<p>Proposed tests for the <a href="http://www.w3.org/TR/html-longdesc">HTML Image Description Extension specification</a>. These tests are © chaals, and available under the <a href="http://www.w3.org/Consortium/Legal/copyright-software">W3C Software license</a></p>
14
15<h2>Multifunction tests</h2>
16
17<p>These 15 tests include descriptions under different combinations of circumstances - images included "normally", as data: URIs, or missing, with the descriptions internal or external to the page, as a data: URI, or in a location only reachable by taking into account the base element.</p>
18
19<p>The same tests are used to provide 3 results:
201 Can the user discover there is an image that has a long description available?
212 Can the user access the description? To pass, the user should arrive at the "pass page" which has a heading "Pass" followed by a description, or the focus must be on the text "Pass, if the focus is here" which is followed by a description of the image.
223 Is the long description available to system accessibility APIs</p>
23
24<h3>Longdesc value as data:URI</h3>
25
26<ul>
Mark Sadecki318c48e2013-10-23 18:56:0727<li><a href="data-uri-image-data-uri-description-manual.html">data:URI image with data:URI description</a></li>
28<li><a href="empty-image-data-uri-description-manual.html">Empty image with data:URI description</a></li>
29<li><a href="external-image-data-uri-description-girt-by-spaces-manual.html">External image with data:URI description (with extra spaces)</a></li>
30<li><a href="external-image-data-uri-description-manual.html">External image with data:URI description</a></li>
Mark Sadecki8f35b802013-10-23 15:36:2731</ul>
32
33
34<h3>Longdesc value as external URI</h3>
35
36<ul>
Mark Sadecki318c48e2013-10-23 18:56:0737<li><a href="data-uri-image-external-description-manual.html">data:URI with External description</a></li>
38<li><a href="empty-image-external-description-manual.html">Empty image with an External description</a></li>
39<li><a href="external-image-external-description-girt-by-spaces-manual.html">External image with External description (with extra spaces)</a></li>
40<li><a href="external-image-external-description-manual.html">External image with External description</a></li>
Mark Sadecki8f35b802013-10-23 15:36:2741</ul>
42
43
44<h3>Longdesc value as internal URI (same page link)</h3>
45
46<ul>
Mark Sadecki318c48e2013-10-23 18:56:0747<li><a href="data-uri-image-internal-description-manual.html">data:URI with Internal description</a></li>
48<li><a href="empty-image-internal-description-manual.html">Empty image with an Internal description</a></li>
49<li><a href="external-image-internal-description-girt-by-spaces-manual.html">External image with an Internal description (with extra spaces)</a></li>
50<li><a href="external-image-internal-description-manual.html">External image with an Internal description</a></li>
Mark Sadecki8f35b802013-10-23 15:36:2751</ul>
52
53
54<h3>Longdesc value as a fragment in an external resource</h3>
55
56<ul>
Mark Sadecki318c48e2013-10-23 18:56:0757<li><a href="data-uri-image-external-description-fragment-manual.html">data:URI with External description fragment</a></li>
58<li><a href="empty-image-external-description-fragment-manual.html">Empty image with an External description fragment</a></li>
59<li><a href="external-image-external-description-fragment-girt-by-spaces-manual.html">External image with External description fragment (with extra spaces around the URL)</a></li>
60<li><a href="external-image-external-description-fragment-manual.html">External image with External description fragment</a></li>
Mark Sadecki8f35b802013-10-23 15:36:2761</ul>
62
63
64<h3>Longdesc value as external URI in presence of <code>&lt;base&gt;</code> element</h3>
65
66<ul>
Mark Sadecki318c48e2013-10-23 18:56:0767<li><a href="external-image-with-relative-base-external-description-manual.html">External image with External Description (relative base element set)</a></li>
68<li><a href="external-image-with-absolute-base-external-description-manual.html">External image with External Description (absolute base element set)</a></li>
Mark Sadecki8f35b802013-10-23 15:36:2769</ul>
70
71
72<h3>Longdesc for an image within an iframe</h3>
73
74<ul>
Mark Sadecki318c48e2013-10-23 18:56:0775<li><a href="iframe-discoverability-manual.html">Image in an <code>&lt;iframe&gt;</code> with External Description</a></li>
Mark Sadecki8f35b802013-10-23 15:36:2776</ul>
77
78
79<h2>Automated tests</h2>
80
Mark Sadecki318c48e2013-10-23 18:56:0781<p><a href="reflected-changing-longdesc-manual.html">Longdesc value updated by javascript</a> tests that the HTML attribute reflects changes made by javascript. To pass, the browser must redirect to the "Longdesc test Pass Page" which has the word "Pass" as a heading, followed by a description of the image. Displaying the "Longdesc test Fail Page" would indicate a failure of this test.</p>
Mark Sadecki8f35b802013-10-23 15:36:2782
83<h2>Validation / Repair tool tests</h2>
84
Mark Sadecki318c48e2013-10-23 18:56:0785<p><a href="invalid-longdesc-manual.html">Invalid long description (plain text)</a> contains an invalid long description (plain text) and can be used to test User Agent and validation tool handling. <em>NOTE: Handling of invalid longdescs by user agents is currently undefined.</em>
86<a href="empty-longdesc-manual.html">Invalid long description (empty attribute)</a> contains an invalid long description (plain text) and can be used to test User Agent and validation tool handling. <em>NOTE: Handling of invalid longdescs by user agents is currently undefined.</em>
87<a href="fail-fragment-pointer-manual.html">Pointer to an invalid long description (not contained in a well-formed fragment)</a> points to a long description in a <a href="fail-fragment-pointer-manual.html">page fragment whose target is an empty element</a>. Validation tools should at least generate a warning, since an empty element is almost certainly not an adequate description, and is likely instead to reflect not passing the relevant authoring requirement.</p>
Mark Sadecki8f35b802013-10-23 15:36:2788
89<h2>Test results</h2>
90
91<p>Preliminary <a href="test-results.html">test results</a> are available for some platforms. More results are welcome.</p>
92
93<h2>Supporting files</h2>
94
95<p>The following files are required to make one or more of the tests work:</p>
96
97<ul>
98<li><a href="README.html">README.html</a> - this documentation</li>
99<li><a href="fail.html">fail.html</a></li>
100<li><a href="pass.html">pass.html</a></li>
101<li><a href="fail-fragment.html">fail-fragment.html</a></li>
102<li><a href="pass-fragment.html">pass-fragment.html</a></li>
103<li><a href="picture.png">picture.png</a></li>
104<li><a href="rebased/picture2.png">rebased/picture2.png</a>)</li>
105<li><a href="rebased/fail.html">rebased/fail.html</a> (actually a pass page, used to test what happens in the presence of a <code>&lt;base&gt;</code> element)</li>
106</ul>
107
108</body>
109</html>