Report and Conversion Options
Accessibility Valet reports are generated internally as a document tree, and can be processed using XSLT to generate a selection of report formats, or a cleaned up HTML or XHTML page. Each report option selects an appropriate XSLT stylesheet to present the required report.
Four HTML and one EARL report options are available:
Originally the default view, this is suitable for most users. Accessibility warnings are shown by inserting an icon alongside the Elements and Attributes to which they apply.
The warning icons serve several purposes:
- The icons indicate the test suite under which the warning is applied.
- A cross through each icon indicates how certain the diagnosis is: bright red indicates a certain diagnosis, fading to grey for a warning of something that is probably not a problem but just FYI.
- Each icon will show the associated warning in brief as a tooltip.
- Each icon is also a link to the guideline which appears to be being violated. Following a link requires you to be online.
This spells out in full messages that appear iconised in the Compact report. You may prefer it if you have images and/or tooltips disabled in your browser. Note that they are less precisely placed than in the Compact report, because insertion of text within tags would be confusing!
This lists the warnings separately. Each warning comprises the same information listed above, together with a list of nodes in the markup to which they apply. Selecting a node will highlight and move to the node in the normalised view.
- DOM Browser
This presents a dynamic report that you browse interactively. As in the Listed format, the warnings and normalised source are presented separately, with each warning showing a list of nodes, which are highlighted in the source when selected. However, the warnings and source are displayed alongside each other, and both are interactively expanded and collapsed as you browse.
The Level 1 EARL report is supported for completeness, although the Level 2 report is probably more suitable for most purposes.
The EARL Level 1 report is presented with an XSLT stylesheet that allows you to browse it like a simplified DOM Browser report.
Level 2 Report Options
To prepare a Level 2 report, you go through warnings and enter your own conclusions. To keep this task manageable, similar warnings are grouped together, so you don't have to enter the identical verdict 10 (or even 100) times! The Listed and DOM Browser views permit this, so we offer both of them.
The Level 2 options differ from their Level 1 counterparts in that they incorporate Form controls for you to prepare and publish your reports.
The cleanup options generate HTML or XHTML. It is normalised by the insertion of implied tags, and bad markup is stripped.
You can select either HTML or XHTML, regardless of the original format of your document. This means you can use it to convert from HTML to XHTML or vice-versa, as well as clean up your markup.
Cleanup options are:
- HTML - Normalise, cleanup, generate HTML
- XHTML - Normalise, cleanup, generate XHTML
- HTML/Legacy - As HTML, but permit deprecated markup
- XHTML/Legacy - As XHTML, but permit deprecated markup
Note that, although many errors are fixed, there is no firm guarantee that the output will be valid where the input is invalid.