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 and input, as well as a pseudo-element designated as page, 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.