summaryrefslogtreecommitdiffstats
path: root/testing/web-platform/tests/html-longdesc/README.html
blob: c4779a229b05ccdd2f3f8670fcfb1082c6e4b2e8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<title>Multifunction tests</title>

</head>
<body>
<h1>longdesc-tests</h1>

<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>

<h2>Multifunction tests</h2>

<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>

<p>The same tests are used to provide 3 results:
1 Can the user discover there is an image that has a long description available?
2 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.
3 Is the long description available to system accessibility APIs</p>

<h3>Longdesc value as data:URI</h3>

<ul>
<li><a href="data-uri-image-data-uri-description-manual.html">data:URI image with data:URI description</a></li>
<li><a href="empty-image-data-uri-description-manual.html">Empty image with data:URI description</a></li>
<li><a href="external-image-data-uri-description-girt-by-spaces-manual.html">External image with data:URI description (with extra spaces)</a></li>
<li><a href="external-image-data-uri-description-manual.html">External image with data:URI description</a></li>
</ul>


<h3>Longdesc value as external URI</h3>

<ul>
<li><a href="data-uri-image-external-description-manual.html">data:URI with External description</a></li>
<li><a href="empty-image-external-description-manual.html">Empty image with an External description</a></li>
<li><a href="external-image-external-description-girt-by-spaces-manual.html">External image with External description (with extra spaces)</a></li>
<li><a href="external-image-external-description-manual.html">External image with External description</a></li>
</ul>


<h3>Longdesc value as internal URI (same page link)</h3>

<ul>
<li><a href="data-uri-image-internal-description-manual.html">data:URI with Internal description</a></li>
<li><a href="empty-image-internal-description-manual.html">Empty image with an Internal description</a></li>
<li><a href="external-image-internal-description-girt-by-spaces-manual.html">External image with an Internal description (with extra spaces)</a></li>
<li><a href="external-image-internal-description-manual.html">External image with an Internal description</a></li>
</ul>


<h3>Longdesc value as a fragment in an external resource</h3>

<ul>
<li><a href="data-uri-image-external-description-fragment-manual.html">data:URI with External description fragment</a></li>
<li><a href="empty-image-external-description-fragment-manual.html">Empty image with an External description fragment</a></li>
<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>
<li><a href="external-image-external-description-fragment-manual.html">External image with External description fragment</a></li>
</ul>


<h3>Longdesc value as external URI in presence of <code>&lt;base&gt;</code> element</h3>

<ul>
<li><a href="external-image-with-relative-base-external-description-manual.html">External image with External Description (relative base element set)</a></li>
<li><a href="external-image-with-absolute-base-external-description-manual.html">External image with External Description (absolute base element set)</a></li>
</ul>


<h3>Longdesc for an image within an iframe</h3>

<ul>
<li><a href="iframe-discoverability-manual.html">Image in an <code>&lt;iframe&gt;</code> with External Description</a></li>
</ul>


<h2>Automated tests</h2>

<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>

<h2>Validation / Repair tool tests</h2>

<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>
<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>
<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>

<h2>Test results</h2>

<p>Preliminary <a href="test-results.html">test results</a> are available for some platforms. More results are welcome.</p>

<h2>Supporting files</h2>

<p>The following files are required to make one or more of the tests work:</p>

<ul>
<li><a href="README.html">README.html</a> - this documentation</li>
<li><a href="fail.html">fail.html</a></li>
<li><a href="pass.html">pass.html</a></li>
<li><a href="fail-fragment.html">fail-fragment.html</a></li>
<li><a href="pass-fragment.html">pass-fragment.html</a></li>
<li><a href="picture.png">picture.png</a></li>
<li><a href="rebased/picture2.png">rebased/picture2.png</a>)</li>
<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>
</ul>

</body>
</html>