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.
- 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. - Ruleset
- A set of rules that embodies specific standards conformance goals. Each rule within a ruleset is designated as either required or recommended, according to its relationship to the conformance goals of the ruleset.
- 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 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)
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.