README.html (6448B)
1 <!doctype html> 2 <html> 3 <head> 4 <meta charset="utf-8"> 5 <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes"> 6 <title>Multifunction tests</title> 7 8 </head> 9 <body> 10 <h1>longdesc-tests</h1> 11 12 <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> 13 14 <h2>Multifunction tests</h2> 15 16 <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> 17 18 <p>The same tests are used to provide 3 results: 19 1 Can the user discover there is an image that has a long description available? 20 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. 21 3 Is the long description available to system accessibility APIs</p> 22 23 <h3>Longdesc value as data:URI</h3> 24 25 <ul> 26 <li><a href="data-uri-image-data-uri-description-manual.html">data:URI image with data:URI description</a></li> 27 <li><a href="empty-image-data-uri-description-manual.html">Empty image with data:URI description</a></li> 28 <li><a href="external-image-data-uri-description-girt-by-spaces-manual.html">External image with data:URI description (with extra spaces)</a></li> 29 <li><a href="external-image-data-uri-description-manual.html">External image with data:URI description</a></li> 30 </ul> 31 32 33 <h3>Longdesc value as external URI</h3> 34 35 <ul> 36 <li><a href="data-uri-image-external-description-manual.html">data:URI with External description</a></li> 37 <li><a href="empty-image-external-description-manual.html">Empty image with an External description</a></li> 38 <li><a href="external-image-external-description-girt-by-spaces-manual.html">External image with External description (with extra spaces)</a></li> 39 <li><a href="external-image-external-description-manual.html">External image with External description</a></li> 40 </ul> 41 42 43 <h3>Longdesc value as internal URI (same page link)</h3> 44 45 <ul> 46 <li><a href="data-uri-image-internal-description-manual.html">data:URI with Internal description</a></li> 47 <li><a href="empty-image-internal-description-manual.html">Empty image with an Internal description</a></li> 48 <li><a href="external-image-internal-description-girt-by-spaces-manual.html">External image with an Internal description (with extra spaces)</a></li> 49 <li><a href="external-image-internal-description-manual.html">External image with an Internal description</a></li> 50 </ul> 51 52 53 <h3>Longdesc value as a fragment in an external resource</h3> 54 55 <ul> 56 <li><a href="data-uri-image-external-description-fragment-manual.html">data:URI with External description fragment</a></li> 57 <li><a href="empty-image-external-description-fragment-manual.html">Empty image with an External description fragment</a></li> 58 <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> 59 <li><a href="external-image-external-description-fragment-manual.html">External image with External description fragment</a></li> 60 </ul> 61 62 63 <h3>Longdesc value as external URI in presence of <code><base></code> element</h3> 64 65 <ul> 66 <li><a href="external-image-with-relative-base-external-description-manual.html">External image with External Description (relative base element set)</a></li> 67 <li><a href="external-image-with-absolute-base-external-description-manual.html">External image with External Description (absolute base element set)</a></li> 68 </ul> 69 70 71 <h3>Longdesc for an image within an iframe</h3> 72 73 <ul> 74 <li><a href="iframe-discoverability-manual.html">Image in an <code><iframe></code> with External Description</a></li> 75 </ul> 76 77 78 <h2>Automated tests</h2> 79 80 <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> 81 82 <h2>Validation / Repair tool tests</h2> 83 84 <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> 85 <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> 86 <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> 87 88 <h2>Test results</h2> 89 90 <p>Preliminary <a href="test-results.html">test results</a> are available for some platforms. More results are welcome.</p> 91 92 <h2>Supporting files</h2> 93 94 <p>The following files are required to make one or more of the tests work:</p> 95 96 <ul> 97 <li><a href="README.html">README.html</a> - this documentation</li> 98 <li><a href="fail.html">fail.html</a></li> 99 <li><a href="pass.html">pass.html</a></li> 100 <li><a href="fail-fragment.html">fail-fragment.html</a></li> 101 <li><a href="pass-fragment.html">pass-fragment.html</a></li> 102 <li><a href="picture.png">picture.png</a></li> 103 <li><a href="rebased/picture2.png">rebased/picture2.png</a>)</li> 104 <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><base></code> element)</li> 105 </ul> 106 107 </body> 108 </html>