From a0215ed392c889393ab01bd1ead7188d0e8d4dc9 Mon Sep 17 00:00:00 2001
From: Kevin White
Date: Thu, 7 Mar 2024 10:43:13 +0000
Subject: [PATCH 1/8] Fix (#3732)
Co-authored-by: Patrick H. Lauke
Co-authored-by: Mike Gower
---
understanding/21/non-text-contrast.html | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/understanding/21/non-text-contrast.html b/understanding/21/non-text-contrast.html
index 37d1b171a0..7a7d622b25 100644
--- a/understanding/21/non-text-contrast.html
+++ b/understanding/21/non-text-contrast.html
@@ -140,7 +140,7 @@
Relationship with Focus Visible
From 6fc9553f79a184d797bfb8b32e12f52d563517cb Mon Sep 17 00:00:00 2001
From: "Patrick H. Lauke"
Date: Mon, 11 Mar 2024 16:23:36 +0000
Subject: [PATCH 2/8] 2.5.3 - control with label but no accname (understanding
note + new failure technique) (#2057)
Also cleans-up 2.5.3 understanding document markup/structure
- adds new F111 Control with visible label text but no accname
(improperly numbered F109 initially)
- add failure technique in Understanding document
- added notes in Understanding about UI components with visible text and
no name failing both 4.1.2 and 2.5.3
- removed direct reference to WCAG 2.1
- resolved discussion with ACT on where to report some of the failure
examples
Closes #2045
---------
Co-authored-by: Alastair Campbell
Co-authored-by: Mike Gower
Co-authored-by: Scott O'Hara
Co-authored-by: Dan Bjorge
---
techniques/failures/F111.html | 83 ++++++++++++++++++
techniques/failures/F96.html | 1 +
understanding/21/label-in-name.html | 128 +++++++++++++++-------------
3 files changed, 153 insertions(+), 59 deletions(-)
create mode 100644 techniques/failures/F111.html
diff --git a/techniques/failures/F111.html b/techniques/failures/F111.html
new file mode 100644
index 0000000000..d2a73fc8ba
--- /dev/null
+++ b/techniques/failures/F111.html
@@ -0,0 +1,83 @@
+
+
+
+ Failure of Success Criteria 1.3.1, 2.5.3, and 4.1.2 due to a control with visible label text but no accessible name
+
+
+
+
Failure of Success Criteria 1.3.1, 2.5.3, and 4.1.2 due to a control with visible label text but no accessible name
+
+
Metadata
+
+
general
+
failure
+
+
+
+
When to Use
+
All technologies that include interactive controls (such as links or form inputs).
+
+
+
+
Description
+
The objective of this Failure is to describe situations where speech input users cannot reliably speak the name of a control because although it has a visible label, it lacks an accessible name.
+
When speech input users interact with a web page, they usually speak a command followed by the reference to some visible label (like the text in a button or a link, or the text labelling some input). If the control lacks an accessible name, speech users won't be able to activate the control using its visible label.
+
+
+
+
Examples
+
+
+
A text input with a visible label, but without an accessible name
+
The text input is preceded by a visible text label "Enter name", but the text is not marked up as a <label> for the input, and there is no alternative way (e.g., aria-label) to provide the input with an accessible name at all.
+
+ <p>Enter name</p>
+ <input type="text">
+
+
+
+
+
A text input with a visible label and aria-labelledby pointing to a non-existent id
+
The text input is preceded by a visible text label "Enter name". The text's container has an id of nameEntry, but the input has an aria-labelledby referencing a non-existent name-entryid. As a result, the input lacks an accessible name altogether.
For all controls with a visible label (e.g., link text, button text, programmatically linked label, images in links or buttons with text, etc.), check that:
+
+
The control has a visible text label.
+
The control has an accessible name.
+
The accessible name contains the text that appears as the visible label.
+
+
+
+
Expected Results
+
+
If check #1 is false, the Success Criterion does not apply.
+
If check #1 is true, but checks #2 and/or #3 are false, the content fails the Success Criterion.
+
If all checks are true, the content passes the Success Criterion.
Note that where a visible text label does not exist for a component, this Success Criterion does not apply to that component.
Where text labels exist and are properly linked to the user interface components through established authoring practices, the label and name will normally match. When they don't match, speech-input users who attempt to use the visible text label as a means of navigation or selection (e.g., "move to Password") will be unsuccessful. The speech-based navigation fails because the visible label spoken by the users does not match (or is not part of) the accessible name that is enabled as a speech-input command. In addition, when the accessible name is different from the visible label, it may function as a hidden command that can be accidentally activated by speech-input users.
Mismatches between visible labels and programmatic names for controls are even more of an issue for speech-input and text-to-speech users who also have cognitive challenges. Mismatches create an extra cognitive load for speech-input users, who must remember to say a speech command that is different from the visible label they see on a control. It also creates extra cognitive load for a text-to-speech user to absorb and understand speech output that does not match the visible label.
In order for the label text and accessible name to be matched, it is first necessary to determine which text on the screen should be considered a label for any given control. There are often multiple text strings in a user interface that may be relevant to a control. However, there are reasons why it is best to conservatively interpret the label as being only the text in close proximity.
-
Conventionally the label for user interface components is the adjacent text string. The typical positioning for left to right languages is:
-
immediately to the left of comboboxes, dropdown lists, text inputs, and other widgets (or in the absence of left-side labels, immediately above and aligned with the left edge of each input)
-
immediately to the right of checkboxes and radio buttons
-
inside buttons and tabs or immediately below icons serving as buttons
It is important to bias towards treating only the adjacent text as a label because liberal interpretations of what constitutes a text label can jeopardize the value of this Success Criterion (SC) by lessening predictability. Isolating the label to the single string in close proximity to the component makes it easier for developers, testers, and end users to identify the label targeted for evaluation in this SC. Predictable interpretation of labeling allows users of speech recognition technologies to interact with the element via its conventionally positioned label, and allows users of screen reading technologies to enjoy consistency between the nearby visible label and the announced name of the component.
-
Note that placeholder text within an input field is not considered an appropriate means of providing a label. The HTML5 specification states The placeholder attribute should not be used as an alternative to a <label>. However, it is worth noting that "label" in that HTML5 statement is in code brackets and links to the label element. For the purposes of this Label in Name Success Criterion, "label" is not used in such a programmatic sense but is simply referring to a text string in close visual proximity to a component. As such, in the absence of any other nearby text string (as described in the preceding list), if an input contains placeholder text, such text may be a candidate for Label in Name. This is supported both through the accessible name calculation (discussed later) and from the practical sense that where a visible label is not otherwise provided, it is likely that a speech-input user may attempt to use the placeholder text value as a means of interacting with the input.
+
In order for the label text and accessible name to be matched, it is first necessary to determine which text on the screen should be considered a label for any given control. There are often multiple text strings in a user interface that may be relevant to a control. However, there are reasons why it is best to conservatively interpret the label as being only the text in close proximity.
+
Conventionally the label for user interface components is the adjacent text string. The typical positioning for left to right languages is:
+
+
immediately to the left of comboboxes, dropdown lists, text inputs, and other widgets (or in the absence of left-side labels, immediately above and aligned with the left edge of each input)
+
immediately to the right of checkboxes and radio buttons
+
inside buttons and tabs or immediately below icons serving as buttons
It is important to bias towards treating only the adjacent text as a label because liberal interpretations of what constitutes a text label can jeopardize the value of this Success Criterion (SC) by lessening predictability. Isolating the label to the single string in close proximity to the component makes it easier for developers, testers, and end users to identify the label targeted for evaluation in this SC. Predictable interpretation of labeling allows users of speech recognition technologies to interact with the element via its conventionally positioned label, and allows users of screen reading technologies to enjoy consistency between the nearby visible label and the announced name of the component.
+
Note that placeholder text within an input field is not considered an appropriate means of providing a label. The HTML5 specification states The placeholder attribute should not be used as an alternative to a <label>. However, it is worth noting that "label" in that HTML5 statement is in code brackets and links to the label element. For the purposes of this Label in Name Success Criterion, "label" is not used in such a programmatic sense but is simply referring to a text string in close visual proximity to a component. As such, in the absence of any other nearby text string (as described in the preceding list), if an input contains placeholder text, such text may be a candidate for Label in Name. This is supported both through the accessible name calculation (discussed later) and from the practical sense that where a visible label is not otherwise provided, it is likely that a speech-input user may attempt to use the placeholder text value as a means of interacting with the input.
-
Text labels "express something in human language"
+
Text labels "express something in human language"
-
Symbolic text characters
-
For the purposes of this SC, text should not be considered a visible label if it is used in a symbolic manner, rather than directly expressing something in human language as per the definition of text in WCAG. For example, 1.4.5 Images of Text describes considerations for "symbolic text characters." In the images of text example "B", "I", and "ABC" appear on icons in a text editor, where they are meant to symbolize the functions for Bold, Italics, and Spelling, respectively. In such a case, the accessible name should be the function the button serves (e.g., "Spell check" or "Check spelling"), not the visible symbolic characters. A similar text editor is shown in the figure below.
-
-
Likewise, where an author has used a greater-than symbol (">") to mimic the appearance of the right-facing arrow, the text does not convey something in human language. It is a symbol, in this scenario likely meant to mimic the icons used for a "Play" button or a "Next" arrow.
-
Punctuation and capitalization
+
Symbolic text characters
+
For the purposes of this SC, text should not be considered a visible label if it is used in a symbolic manner, rather than directly expressing something in human language as per the definition of text in WCAG. For example, 1.4.5 Images of Text describes considerations for "symbolic text characters." In the images of text example "B", "I", and "ABC" appear on icons in a text editor, where they are meant to symbolize the functions for Bold, Italics, and Spelling, respectively. In such a case, the accessible name should be the function the button serves (e.g., "Spell check" or "Check spelling"), not the visible symbolic characters. A similar text editor is shown in the figure below.
+
+
Likewise, where an author has used a greater-than symbol (>) to mimic the appearance of the right-facing arrow, the text does not convey something in human language. It is a symbol, in this scenario likely meant to mimic the icons used for a "Play" button or a "Next" arrow.
-
The use of punctuation and capitalization in labels may also be considered optional for the same reason. For example, the colon conventionally added at the end of input labels does not express something in human language, and capitals on the first letter of each word in a label do not normally alter the words' meaning. This is particularly relevant in the context of this SC, since it is primarily aimed at users of speech recognition; capitals and most punctuation are frequently ignored when a user speaks a label as a means of interacting with a control.
-
While it is certainly not an error to include the colon and capitalization in the accessible name, a computed name of "First name" should not be considered a failure of "First Name:".
-
-Likewise, "Next…" visibly shown on a button could have "Next" as the accessible name. When in doubt, where a meaningful visible label exists, match the string exactly for the accessible name.
-
+
Punctuation and capitalization
+
The use of punctuation and capitalization in labels may also be considered optional for the same reason. For example, the colon conventionally added at the end of input labels does not express something in human language, and capitals on the first letter of each word in a label do not normally alter the words' meaning. This is particularly relevant in the context of this SC, since it is primarily aimed at users of speech recognition; capitals and most punctuation are frequently ignored when a user speaks a label as a means of interacting with a control.
+
+
While it is certainly not an error to include the colon and capitalization in the accessible name, a computed name of "First name" should not be considered a failure of "First Name:".
Likewise, "Next…" visibly shown on a button could have "Next" as the accessible name. When in doubt, where a meaningful visible label exists, match the string exactly for the accessible name.
+
+
+<input type="submit" value="Next...">
+
+
+
Mathematical expressions and formulae
+
Mathematical expressions are an exception to the previous subsection about symbolic characters. Math symbols can be used as labels; for example 11×3=33 and A>B convey meaning. The label should not be overwritten in the accessible name, and substitutions of words where a formula is used should be avoided since there are multiple ways to express the same equation. For example, making the name "eleven multiplied by three is equivalent to thirty-three" might mean a user who said "eleven times three equals thirty-three" may not match. It is best to leave the formulas as used in the label and count on the user's familiarity with their speech software to achieve a match. Further, converting a mathematical formula label into an accessible name that is a spelled-out equivalent may create issues for translation. The name should match the label's formula text. Note that a consideration for authors is to use the proper symbol in the formula. For instance 11x3 (with a lower or upper case letter X), 11*3 (with the asterisk symbol), and 11×3 (with the × symbol) are all easy for sighted users to interpret as meaning the same formula, but may not all be matched to "11 times 3" by the speech recognition software. The proper operator symbol (in this case the times symbol) should be used.
-
Mathematical expressions and formulae
-
Mathematical expressions are an exception to the previous subsection about symbolic characters. Math symbols can be used as labels; for example "11×3=33" and "A>B" convey meaning. The label should not be overwritten in the accessible name, and substitutions of words where a formula is used should be avoided since there are multiple ways to express the same equation. For example, making the name "eleven multiplied by three is equivalent to thirty-three" might mean a user who said "eleven times three equals thirty-three" may not match. It is best to leave the formulas as used in the label and count on the user's familiarity with their speech software to achieve a match. Further, converting a mathematical formula label into an accessible name that is a spelled-out equivalent may create issues for translation. The name should match the label's formula text. Note that a consideration for authors is to use the proper symbol in the formula. For instance 11x3 (with a lower or upper case letter X), 11*3 (with the asterisk symbol), and 11×3 (with the × symbol) are all easy for sighted users to interpret as meaning the same formula, but may not all be matched to "11 times 3" by the speech recognition software. The proper operator symbol (in this case the times symbol) should be used.
+
Accessible Name and Description Computation specification
-
It is important to understand how the accessible name is derived. The Accessible Name and Description Computation 1.1 and the HTML Accessibility API Mappings 1.0 describe how the accessible name is computed, including which attributes are considered in its calculation, and in what order of preference. If a component has multiple possible attribute values that could be used for its accessible name, only the most preferred of those values will be computed. None of the other, less preferred values will be part of the name. For the most part, existing established programmatic relationships between labels and controls are reinforced by the specification.
-
Other text displayed on the screen that is correctly coded to meet 1.3.1: Info and Relationships is not normally factored into the calculation for the accessible name of a UI component without author intervention (via ARIA labeling techniques). The most common of these are:
-
-
headings and instructions
-
group labels for sets of components (i.e., used with legend/fieldset or with role of group or radiogroup)
-
-
Such textual information may constitute part of the component's description. So from both a programmatic viewpoint, and from the conservative tactic of only considering a label to be "adjacent text," neither headings, instructions, nor group 'labels' should normally be considered labels for the purpose of this Success Criterion.
-
It is important to note that the specification allows authors to override the name calculated through native semantics. Both aria-label and aria-labelledby take precedence in the name calculation, overriding the visible text as the accessible name even when the visible text label is programmatically associated with the control. For this reason, when a visible label already exists, aria-label should be avoided or used carefully, and aria-labelledby should be used as a supplement with care.
-
Finally, aria-describedby is not included in the Accessible Name computation (instead it is part of the Accessible Description computation). By convention, text associated with a control through aria-describedby is announced immediately after the accessible name by screen readers. Therefore, the context of headings, instructions, and group labels can be provided through the accessible description to assist users of screen readers without affecting the experience of those who navigate using speech recognition software.
-
-
-
-
-
-
Benefits
+
Accessible Name and Description Computation specification
+
It is important to understand how the accessible name is derived. The Accessible Name and Description Computation 1.1 and the HTML Accessibility API Mappings 1.0 describe how the accessible name is computed, including which attributes are considered in its calculation, and in what order of preference. If a component has multiple possible attribute values that could be used for its accessible name, only the most preferred of those values will be computed. None of the other, less preferred values will be part of the name. For the most part, existing established programmatic relationships between labels and controls are reinforced by the specification.
+
Other text displayed on the screen that is correctly coded to meet 1.3.1: Info and Relationships is not normally factored into the calculation for the accessible name of a UI component without author intervention (via ARIA labeling techniques). The most common of these are:
-
Speech-input users can directly activate controls on a page with fewer surprising changes of focus.
-
Text-to-speech users will have a better experience because the labels that they hear match the visible text labels that
- they see on the screen.
+
headings and instructions
+
group labels for sets of components (i.e., used with legend/fieldset or with role of group or radiogroup)
+
Such textual information may constitute part of the component's description. So from both a programmatic viewpoint, and from the conservative tactic of only considering a label to be "adjacent text," neither headings, instructions, nor group 'labels' should normally be considered labels for the purpose of this Success Criterion.
+
It is important to note that the specification allows authors to override the name calculated through native semantics. Both aria-label and aria-labelledby take precedence in the name calculation, overriding the visible text as the accessible name even when the visible text label is programmatically associated with the control. For this reason, when a visible label already exists, aria-label should be avoided or used carefully, and aria-labelledby should be used as a supplement with care.
+
Finally, aria-describedby is not included in the Accessible Name computation (instead it is part of the Accessible Description computation). By convention, text associated with a control through aria-describedby is announced immediately after the accessible name by screen readers. Therefore, the context of headings, instructions, and group labels can be provided through the accessible description to assist users of screen readers without affecting the experience of those who navigate using speech recognition software.
+
+
+
+
Benefits
+
+
Speech-input users can directly activate controls on a page with fewer surprising changes of focus.
+
Text-to-speech users will have a better experience because the labels that they hear match the visible text labels that
+ they see on the screen.
+
+
Examples
-
Accessible name matches visible label: The accessible name and visible label of a control match.
-
Accessible name starts with visible label: The accessible name "Search for a value" begins with the text of the visible label, "Search".
+
Accessible name matches visible label: The accessible name and visible label of a control match.
+
Accessible name starts with visible label: The accessible name "Search for a value" begins with the text of the visible label, "Search".
Although not required for conformance, the following additional techniques should
- be considered in order to make content more accessible. Not all techniques can be
- used or would be effective in all situations.
-
+
Although not required for conformance, the following additional techniques should be considered in order to make content more accessible. Not all techniques can be used or would be effective in all situations.
Accessible name contains the visible label text, but the words of the visible label are not in the same order as they are in the visible label text (Potential future technique)
Accessible name contains the visible label text, but one or more other words are interspersed in the label (Potential future technique)
Please share your ideas, suggestions, or comments via e-mail to the publicly-archived list public-agwg-comments@w3.org@w3.org or via GitHub
+
Please share your ideas, suggestions, or comments via e-mail to the publicly-archived list public-agwg-comments@w3.org or via GitHub
E-mail
From a9dbe114c24a1472c9f057cedd1d6c5e22998136 Mon Sep 17 00:00:00 2001
From: "Patrick H. Lauke"
Date: Mon, 11 Mar 2024 16:34:59 +0000
Subject: [PATCH 4/8] Update definition for single pointer (#3536)
The definition for "single pointer" has had issues for a long time, as
it mixes the idea of what a pointer *is* with the action(s) *performed*
using a pointer.
I originally tried to fix this, but there was no appetite for it once
2.1 was released. However, with 2.2 and the new 2.5.7 Dragging Movement
SC, the broken definition is causing actual misunderstandings/illogical
non-sequiturs.
See https://github.com/w3c/wcag/issues/749#issuecomment-494146357 and
the recent https://github.com/w3c/wcag/issues/3535 where this is once
again causing a non-sequitur
Closes https://github.com/w3c/wcag/issues/3535
(this is effectively a follow-up to https://github.com/w3c/wcag/pull/809
which had disambiguated things, but the definition had since been
changed further/again to reintroduce the ambiguous wording we have at
this point which confuses input with action)
This would be applied to WCAG 2.1 and 2.2, unless there is a decision to
only apply it to 2.2.
EDIT: Also closes https://github.com/w3c/wcag/issues/394
***
Preview |
Diff
---------
Co-authored-by: Alastair Campbell
---
guidelines/terms/21/single-pointer.html | 5 ++---
1 file changed, 2 insertions(+), 3 deletions(-)
diff --git a/guidelines/terms/21/single-pointer.html b/guidelines/terms/21/single-pointer.html
index 46ea4f99f9..7f0001968a 100644
--- a/guidelines/terms/21/single-pointer.html
+++ b/guidelines/terms/21/single-pointer.html
@@ -1,7 +1,6 @@
single pointer
-
-
pointer input that operates with one point of contact with the screen, including single taps and clicks, double-taps and clicks, long presses, and path-based gestures
-
+
an input that only targets a single point on the page/screen at a time – such as a mouse, single finger on a touch screen, or stylus.
+
In contrast to single pointer inputs, multipoint interactions involve the use of two or more pointers at the same time – such as two finger interactions on a touchscreen, or the simultaneous use of a mouse and stylus.
From 31b1ad3680bac99540521bb919ee8b8e74ccb570 Mon Sep 17 00:00:00 2001
From: "Patrick H. Lauke"
Date: Mon, 11 Mar 2024 22:28:08 +0000
Subject: [PATCH 5/8] Update general understanding documents (#3588)
* removes the woefully out-of-date (and likely never going to be
maintained) "Change log" from the
https://www.w3.org/WAI/WCAG22/Understanding/about page
* where possible, makes WCAG mentions "versionless" ("WCAG 2" instead of
"WCAG 2.0" / "WCAG 2.1" / "WCAG 2.2")
* where not possible (e.g. links to techniques document), bumps to
2.2 EDIT: made techniques document link versionless as well
* change `success criterion`/`success criteria` to `Success
Criterion`/`Success Criteria` (and correct minor instances where the
latter was used as if it were singular - "is the Success Criteria" >
"are the Success Criteria" or "is the Success Criterion") EDIT: as a
result of discussions that came after this PR was made, reverting this
change, and changing any straggler references that did use uppercase
`Success Criteria` to lowercase `success criteria`
* adds `lang` attributes to all documents
* updates some of the links (most prominent: replace the outdated
https://www.w3.org/WAI/GL/WCAG20/TECHS-SUBMIT/ to instead point to the
github repo)
Closes #3585
Note that this change is based on existing non-normative information
under [Background on WCAG
2](https://www.w3.org/TR/WCAG22/#background-on-wcag-2) in the existing
TR, which reads in part:
>Where this document refers to WCAG 2 it is intended to mean any and all
versions of WCAG that start with 2.
---------
Co-authored-by: Mike Gower
Co-authored-by: David Cox <98318778+dav-idc@users.noreply.github.com>
Co-authored-by: Sebastian <39335537+sebazai@users.noreply.github.com>
---
understanding/about.html | 140 +++++++++---------
understanding/conformance.html | 99 ++++++-------
.../documenting-accessibility-support.html | 6 +-
understanding/intro.html | 48 +++---
understanding/refer-to-wcag.html | 54 +++----
understanding/understanding-act-rules.html | 22 +--
understanding/understanding-metadata.html | 6 +-
understanding/understanding-techniques.html | 52 +++----
understanding/understanding-template.html | 12 +-
9 files changed, 215 insertions(+), 224 deletions(-)
diff --git a/understanding/about.html b/understanding/about.html
index 98cefe490a..e953954844 100644
--- a/understanding/about.html
+++ b/understanding/about.html
@@ -17,94 +17,86 @@
Page Contents
Web Content Accessibility Guidelines (WCAG) provides requirements for making websites, applications, and other digital content accessible to people with disabilities. For an introduction to WCAG, supporting technical documents, and educational material, see WCAG 2 Overview.
-
There are additional resources that help you understand and implement WCAG. These Understanding documents are one type of resource. Others are explained in the WCAG 2 Documents.
-
-
-
About the Understanding Documents
-
WCAG Understanding documents are guides to understanding and implementing WCAG. They provide detailed explanations for
- each guideline and each success criterion to help readers better understand the intent
- of the success criteria. They include background information and technical details. They include techniques that are examples of ways to meet the success criteria. Each technique is linked to more details in a techniques page. Techniques are explained in Understanding Techniques for WCAG Success Criteria.
-
WCAG Understanding documents are not introductory resources. They are for people who want to understand WCAG more thoroughly. The WCAG Overview provides introductory information.
-
-
Structure of the Documents
-
Understanding Guidelinepages include:
-
-
The intent
-
Any advisory techniques that are related
- to the guideline and not specifically related to any of its success criteria
-
-
Understanding Success Criterion pages include:
-
-
The success criterion wording from WCAG
-
Intent of the success criterion
-
Benefits, how it helps people with disabilities
-
Examples
-
Related resources
-
Techniques
+
+
+
About WCAG
+
Web Content Accessibility Guidelines (WCAG) provides requirements for making websites, applications, and other digital content accessible to people with disabilities. For an introduction to WCAG, supporting technical documents, and educational material, see WCAG 2 Overview.
+
There are additional resources that help you understand and implement WCAG. These Understanding documents are one type of resource. Others are explained in the WCAG 2 Documents.
+
+
+
About the Understanding Documents
+
WCAG Understanding documents are guides to understanding and implementing WCAG. They provide detailed explanations for
+ each guideline and each success criterion to help readers better understand the intent
+ of the success criteria. They include background information and technical details. They include techniques that are examples of ways to meet the success criteria. Each technique is linked to more details in a techniques page. Techniques are explained in Understanding Techniques for WCAG Success Criteria.
+
WCAG Understanding documents are not introductory resources. They are for people who want to understand WCAG more thoroughly. The WCAG Overview provides introductory information.
+
+
+
Structure of the Documents
+
Understanding Guidelinepages include:
+
+
The intent
+
Any advisory techniques that are related
+ to the guideline and not specifically related to any of its success criteria
+
+
Understanding Success Criterion pages include:
-
Sufficient techniques
-
Advisory techniques
-
Failures
+
The success criterion wording from WCAG
+
Intent of the success criterion
+
Benefits, how it helps people with disabilities
+
Examples
+
Related resources
+
Techniques
+
+
Sufficient techniques
+
Advisory techniques
+
Failures
+
+
+
Key terms for this success criterion, from the WCAG Glossary
-
-
Key terms for this success criterion, from the WCAG Glossary
-
-
-
-
-
-
-
-
Change Log
-
-
A list of significantly updated Understanding documents since WCAG 2.1 was published: