Concepts and Terms
Basic Concepts
- Rule
- A low-level accessibility conformance requirement with numerous components, the most basic of which are a definition, an evaluation function, and result messages. When a rule is evaluated, it is assigned a rule result value. List of current rules.
- Target resources
- The set of HTML elements to which a particular rule applies. These include familiar elements such as
div
,img
andinput
, as well as a pseudo-element designated aspage
, which is a placeholder for the document element. When a rule is evaluated, each of its target resources is assigned an element result value. - Evaluation
- The application of all evaluation functions of all rules in the selected ruleset to their corresponding target resources in a web page, and the subsequent collection of all evaluation results and messages, at both the rule and element levels, into a dataset.
- Rule result
- The aggregate result of a rule evaluation with respect to its target resources (all of its target elements and/or the entire page).
- Element result
- The result of a rule evaluation with respect to one of its target elements.
- Rule scope
- element: A WCAG requirement for a specific html element or an element with an ARIA role, property or state. For example, an
img
element must have analt
attribute. - page: A WCAG requirement that applies to a feature of a web page. For example, a web page must have a
main
landmark. - website: A WCAG requrement that applied to pages in a website. For example, consistent navigational links in each web page.
Rule and element result values
V
Violation- One or more target elements fail the requirements of a required rule
W
Warning- One or more target elements fail the requirements of a recommended rule
MC
Manual check- Unable to programmatically determine a result – evaluation requires human inspection
P
Pass- All rule requirements were satisfied
N/A
Not applicable- Rule was not applied because there were no relevant target elements
H
Hidden- Target element was not evaluated because it is hidden (either visually or from assistive technologies)
Rule Categories
Rule categories are an alternative to WCAG Guidelines for grouping related rules. The Rule Categories are based on HTML element types to make it easier for web designers and developers to understand WCAG accessibility requirements.
- Landmarks
- Use ARIA landmark roles to structure the content of each page and identify major sections of content, thus making them more findable and navigable.
- The use of landmarks will, in many cases, reflect the visual styling and page layouts that web designers utilize to set apart various sections of content.
- Headings
- Use heading elements (H1-H6) to identify sections and subsections of content in a web page.
- Headings can also be used to provide accessible names for landmarks using the
aria-labelledby
attribute. - Styles/Content
- Use proper HTML markup to identify the semantics and language of text content. Ensure that text is readable by adhering to color contrast requirements, and that information is not conveyed solely by the use of color, shape, location or sound.
- Images
- Provide appropriate text alternatives for static images and graphics.
- Links
- Use link text that properly describes the target of each link. Ensure consistency and uniqueness for links that are usable, predictable and understandable.
- Tables
- Provide table captions or other meta-information as needed. Provide row and column header references for data cells of data tables. Ensure that tables used for layout properly linearize text content.
- Forms
- Provide meaningful labels for form elements and usable and understandable error feedback as needed.
- Widgets/Scripts
- Use appropriate event handlers on elements to support native interactivity using JavaScript.
- Ensure that custom widgets created using JavaScript support keyboard interaction and include ARIA markup to describe their roles, properties and states.
- Audio/Video
- Provide appropriate text transcripts, captions or audio descriptions for elements used in rendering audio and video content.
- Keyboard Support
- Provide logical and sequential keyboard navigation among interactive elements such as links and form controls. Use standard models of keyboard interaction for custom widgets, guidance and examples can be found in the ARIA Authoring Practices.
- Timing
- Eliminate accessibility problems caused by time limits on input and by content that moves, scrolls, flashes or auto-updates.
- Site Navigation
- Ensure the consistent labeling and ordering of recurrent page sections across all pages within a website. Provide a meaningful title for each page within a website.
More about rules, target resources and result values
- A rule tests target resources for specific accessibility features.
- Some rules are fully automated and return pass or fail results and messages.
- Other rules can only identify the need for human judgement to determine whether an accessibility requirement has been met. These return manual check results and messages.
- If target resources are not found on the page, the rule result is designated as not applicable.
- If target resources for a rule are hidden, their element results are designated as hidden. Although hidden elements are not evaluated, they are listed at the element results level to enable developers to consider their accessibility if and when they become available to users.
- Rules also include information on accessibility techniques and links to related resources to help developers understand how to meet the requirements of a rule.