From 2e0e694f694cf80420d82eeed1102e737c7e3dc1 Mon Sep 17 00:00:00 2001
From: Francis Storr The purpose of this Success Criterion is to ensure there is an accessible, easy-to-use, and secure method to log in, access content, and undertake tasks. This criterion is the same as Accessible Authentication but without the exceptions for objects and user-provided content. The purpose of this Success Criterion is to ensure there is an accessible, easy-to-use, and secure method to log in, access content, and undertake tasks. This criterion is the same as Accessible Authentication (Minimum) but without the exceptions for objects and user-provided content. Any required step of the authentication process: The benefits of this success criterion are the same as Accessible Authentication. The benefits of this success criterion are the same as Accessible Authentication (Minimum). People with cognitive issues relating to memory, reading (for example, dyslexia), numbers (for example, dyscalculia), or perception-processing limitations will be able to authenticate irrespective of the level of their cognitive abilities. The examples of this Success Criterion are the same as the Accessible Authentication examples. The examples of this Success Criterion are the same as the Accessible Authentication (Minimum) examples. WCAG 2.1 guidelines and success criteria are designed to be broadly applicable to current and future web technologies, including dynamic applications, mobile, digital television, etc. They are stable and do not change. Specific guidance for authors and evaluators on meeting the WCAG success criteria is provided in techniques, which include code examples, resources, and tests. W3C's Techniques for WCAG 2.1 document is updated periodically, about twice per year, to cover more current best practices and changes in technologies and tools. The three types of guidance in Techniques for WCAG 2.1 are explained below: WCAG 2.2 guidelines and success criteria are designed to be broadly applicable to current and future web technologies, including dynamic applications, mobile, digital television, etc. They are stable and do not change. Specific guidance for authors and evaluators on meeting the WCAG success criteria is provided in techniques, which include code examples, resources, and tests. W3C's Techniques for WCAG 2.2 document is updated periodically, about twice per year, to cover more current best practices and changes in technologies and tools. The three types of guidance in Techniques for WCAG 2.2 are explained below: Sufficient techniques Advisory techniques Failures Also explained below: General and technology-specific techniques - which can be sufficient or advisory Other techniques - beyond what is in W3C's published document Technique tests User agent and assistive technology support Using the techniques - with important considerations Understanding Conformance provides related information, including on understanding accessibility support. Techniques are informative—that means they are not required. The basis for determining conformance to WCAG 2.1 is the success criteria from the WCAG 2.1 standard—not the techniques. Note 1: W3C cautions against requiring W3C's sufficient techniques. The only thing that should be required is meeting the WCAG 2.1 success criteria. To learn more, see: Techniques are informative—that means they are not required. The basis for determining conformance to WCAG 2.2 is the success criteria from the WCAG 2.2 standard—not the techniques. Note 1: W3C cautions against requiring W3C's sufficient techniques. The only thing that should be required is meeting the WCAG 2.2 success criteria. To learn more, see: What would be the negative consequences of allowing only W3C's published techniques to be used for conformance to WCAG 2.1? in the WCAG 2 FAQ What would be the negative consequences of allowing only W3C's published techniques to be used for conformance to WCAG 2.2? in the WCAG 2 FAQ Note 2: Techniques for WCAG 2.1 uses the words "must" and "should" only to clarify guidance within the techniques, not to convey requirements for WCAG. Note 2: Techniques for WCAG 2.2 uses the words "must" and "should" only to clarify guidance within the techniques, not to convey requirements for WCAG. From an author's perspective: If you use the sufficient techniques for a given criterion correctly and it is accessibility-supported for your users, you can be confident that you met the success criterion. From an evaluator's perspective: If web content implements the sufficient techniques for a given criterion correctly and it is accessibility-supported for the content's users, it conforms to that success criterion. (The converse is not true; if content does not implement these sufficient techniques, it does not necessarily fail the success criteria, as explained in Testing Techniques below.) From an evaluator's perspective: If web content implements the sufficient techniques for a given criterion correctly and it is accessibility-supported for the content's users, it conforms to that success criterion. (The converse is not true; if content does not implement these sufficient techniques, it does not necessarily fail the success criteria, as explained in Testing Techniques below.) There may be other ways to meet success criteria besides the sufficient techniques in W3C's Techniques for WCAG 2.1 document, as explained in Other Techniques below. (See also Techniques are Informative above.) There may be other ways to meet success criteria besides the sufficient techniques in W3C's Techniques for WCAG 2.2 document, as explained in Other Techniques below. (See also Techniques are Informative above.) The W3C-documented sufficient techniques are provided in a numbered list where each list item provides a technique or combination of techniques that can be used to meet the success criterion. Where there are multiple techniques on a numbered list item connected by "AND" then all of the techniques must be used to be sufficient. For example, Sufficient Techniques for 1.3.1 has: "G115: Using semantic elements to mark up structure AND H49: Using semantic markup to mark emphasized or special text (HTML)". Advisory techniques are suggested ways to improve accessibility. They are often very helpful to some users, and may be the only way that some users can access some types of content. Advisory techniques are not designated as sufficient techniques for various reasons such as: they may not be sufficient to meet the full requirements of the success criteria; they may be based on technology that is not yet stable; they may not be accessibility supported in many cases (for example, assistive technologies do not work with them yet); they may not be testable; in some circumstances they may not be applicable or practical, and may even decrease accessibility for some users while increasing it for others; they may not address the success criterion itself, and instead provide related accessibility benefits. Authors are encouraged to apply all of the techniques where appropriate to best address the widest range of users' needs. Failures are things that cause accessibility barriers and fail specific success criteria. The documented failures are useful for: Authors to know what to avoid, Evaluators to use for checking if content does not meet WCAG success criteria. Content that has a failure does not meet WCAG success criteria, unless an alternate version is provided without the failure. If anyone identifies a situation where a documented failure is not correct, please report the situation as a WCAG comment so that it can be corrected or deleted as appropriate. If anyone identifies a situation where a documented failure is not correct, please report the situation as a WCAG comment so that it can be corrected or deleted as appropriate. General techniques describe basic practices that apply to all technologies. Technology-specific techniques apply to a specific technology. Some success criteria do not have technology-specific techniques and are covered only with general techniques. Therefore, both the general techniques and the relevant technology-specific techniques should be considered. Publication of techniques for a specific technology does not imply that the technology can be used in all situations to create content that meets WCAG 2.1 success criteria and conformance requirements. Developers need to be aware of the limitations of specific technologies and provide content in a way that is accessible to people with disabilities. Publication of techniques for a specific technology does not imply that the technology can be used in all situations to create content that meets WCAG 2.2 success criteria and conformance requirements. Developers need to be aware of the limitations of specific technologies and provide content in a way that is accessible to people with disabilities. In addition to the techniques in W3C's Techniques for WCAG 2.1 document, there are other ways to meet WCAG success criteria. W3C's techniques are not comprehensive and may not cover newer technologies and situations. Web content does not have to use W3C's published techniques in order to conform to WCAG 2.1.(See also Techniques are Informative above.) Content authors can develop different techniques. For example, an author could develop a technique for HTML5, WAI-ARIA, or other new technology. Other organizations may develop sets of techniques to meet WCAG 2.1 success criteria. In addition to the techniques in W3C's Techniques for WCAG 2.2 document, there are other ways to meet WCAG success criteria. W3C's techniques are not comprehensive and may not cover newer technologies and situations. Web content does not have to use W3C's published techniques in order to conform to WCAG 2.2. (See also Techniques are Informative above.) Content authors can develop different techniques. For example, an author could develop a technique for HTML, WAI-ARIA, or other new technology. Other organizations may develop sets of techniques to meet WCAG 2.2 success criteria. Any techniques can be sufficient if: they satisfy the success criterion, and all of the WCAG 2.1 conformance requirements are met. The WCAG Working Group encourages people to submit new techniques so that they can be considered for inclusion in updates of the Techniques for WCAG 2.1 document. Please submit techniques for consideration using the Techniques Submission Form. The WCAG Working Group encourages people to submit new techniques so that they can be considered for inclusion in updates of the Techniques for WCAG 2.2 document. Please submit techniques for consideration using the Techniques Submission Form. Each technique has tests that help: Each technique has tests that help: authors verify that they implemented the technique properly, and evaluators determine if web content meets the technique. The tests are only for a technique, they are not tests for conformance to WCAG success criteria. Failing a technique test does not necessarily mean failing WCAG, because the techniques are discrete (that is, they address one specific point) and they are not required. Content can meet WCAG success criteria in different ways other than W3C's published sufficient techniques. Content that passes the sufficient techniques for a specific technology does not necessarily meet all WCAG success criteria. Some success criteria have only general techniques, not technology-specific techniques. The content must be accessibility supported for the content's users. Some sufficient techniques require browser, assistive technology, or other support that some users might not have. Thus while the techniques are useful for evaluating content, evaluations must go beyond just checking the sufficient technique tests in order to evaluate how content conforms to WCAG success criteria. Failures are particularly useful for evaluations because they do indicate non-conformance (unless an alternate version is provided without the failure). Techniques for WCAG 2.1 is not intended to be used as a stand-alone document. Instead, it is expected that content authors will usually use How to Meet WCAG 2.1: A customizable quick reference to read the WCAG success criteria, and follow links from there to specific topics in Understanding WCAG 2.1 and to specific techniques. Techniques for WCAG 2.2 is not intended to be used as a stand-alone document. Instead, it is expected that content authors will usually use How to Meet WCAG 2.2: A customizable quick reference to read the WCAG success criteria, and follow links from there to specific topics in Understanding WCAG 2.2 and to specific techniques. Some techniques describe how to provide alternate ways for users to get content. For example, G73: Providing a long description in another location... mentions a transcript as an alternative for an audio file. Some alternatives must also conform to WCAG. For example, the transcript itself must meet all relevant success criteria. Some techniques describe how to provide alternate ways for users to get content. For example, G73: Providing a long description in another location... mentions a transcript as an alternative for an audio file. Some alternatives must also conform to WCAG. For example, the transcript itself must meet all relevant success criteria. This Success Criterion does not apply if data is provided by the user with a different method, such as uploading a resume in a document format. This Success Criterion does not impact Accessible Authentication, for which allowing auto-filling of passwords is a sufficient technique. In that case the filling is performed by the user's browser. Redundant Entry is asking for the website content to make the previous entry available, but not between sessions or for essential purposes such as asking for a password. This Success Criterion does not impact Accessible Authentication (Minimum) or Accessible Authentication (Enhanced), for which allowing auto-filling of passwords is a sufficient technique. In that case the filling is performed by the user's browser. Redundant Entry is asking for the website content to make the previous entry available, but not between sessions or for essential purposes such as asking for a password. This criterion does not include requirements or exceptions specific to privacy or personally identifiable information (PII), but when implementing techniques such as auto-population, authors should ensure data protection when storing information even temporarily during a process. It is possible to eliminate redundant entry in ways that do not introduce additional privacy risks, but it is also possible that a poor implementation (for meeting this criterion) could leak additional PII. A list of new, removed or significantly updated techniques: For a more detailed view of recent changes to the informative documents see the github updates.
From 96ce02df12e7e3145e87ec6f7da22747593a5af3 Mon Sep 17 00:00:00 2001
From: Francis Storr The It's important to note the Success Criterion Identify Input Purpose and It's important to note the Success Criterion Identify Input Purpose and For the Success Criterion, it is assumed that the Generally applicable. The objective of this technique is enhance the focus indicator in the browser, by creating a highly visible one in the content. This technique is very similar to G195, but with a stronger indicator to meet Focus Appearance (Enhanced). The objective of this technique is enhance the focus indicator in the browser, by creating a highly visible one in the content. This technique is very similar to G195, but with a stronger indicator to meet Focus Appearance. Techniques are informative—that means they are not required. The basis for determining conformance to WCAG 2 is the success criteria from the WCAG 2 standard—not the techniques. W3C cautions against requiring W3C's sufficient techniques. The only thing that should be required is meeting the WCAG 2 success criteria. To learn more, see: What would be the negative consequences of allowing only W3C's published techniques to be used for conformance to WCAG 2? in the WCAG 2 FAQ W3C cautions against requiring W3C's sufficient techniques. The only thing that should be required is meeting the WCAG 2 success criteria. To learn more, see: What would be the negative consequences of allowing only W3C's published techniques to be used for conformance to WCAG 2? in the WCAG 2 FAQ Techniques for WCAG 2 is not intended to be used as a stand-alone document. Instead, it is expected that content authors will usually use How to Meet WCAG 2: A customizable quick reference to read the WCAG success criteria, and follow links from there to specific topics in Understanding WCAG 2 and to specific techniques. Techniques for WCAG 2 is not intended to be used as a stand-alone document. Instead, it is expected that content authors will usually use How to Meet WCAG 2: A customizable quick reference to read the WCAG success criteria, and follow links from there to specific topics in Understanding WCAG 2 and to specific techniques. Technologies that support Accessible Rich Internet Applications. This technique demonstrates how to assign a generic This technique demonstrates how to assign a generic It is important to name regions, because they are generic grouping elements and users will need some way to tell which region they are in. Regions can be named using
- This technique uses the Cognitive function test definition
Intent of Accessible Authentication (Enhanced)
-
@@ -64,7 +64,7 @@
Intent of Accessible Authentication (Enhanced)
Benefits of Accessible Authentication (Enhanced)
- Benefits of Accessible Authentication (Enhanced)
Examples of Accessible Authentication (Enhanced)
-
- Understanding Techniques for WCAG Success Criteria
- Understanding Techniques for WCAG Success Criteria
+
-
-
Techniques are Informative
-
- Sufficient Techniques
@@ -57,10 +41,10 @@ Sufficient Techniques
Numbered Lists, "AND"
Advisory Techniques
-
Advisory Techniques
Failures
-
General and Technology-specific Techniques
+ General and Technology-specific Techniques
Other Techniques
-
-
Submitting Techniques
- Testing Techniques
-
-
-
Support Notes Change Over Time
Using the Techniques
- Alternatives must meet success criteria
- Example Code
From 9ee6aae1c4b44ccf4ca6238ce9606b45ecead32e Mon Sep 17 00:00:00 2001
From: Francis Storr Intent of Redundant Entry
Change Log
-
Description
autocomplete
attribute allows the browser to do a pattern match against a list of values locally stored with the browser, and supplies the appropriate corresponding value when the input is programmatically tagged. This is a user setting that can be turned on or off, or modified by the end user. This reduces typing and reliance on memory because it uses stored values to fill in the fields.autocomplete
attribute only place requirements on input fields collecting information about the user.autocomplete
attribute only place requirements on input fields collecting information about the user.autocomplete
attribute is not used on form fields that do not correspond to an autocomplete field described in the HTML autocomplete
attribute specification. If the autocomplete
field is used to describe a "custom" taxonomy, rather than that described in the specification, this rule may produce incorrect results.Using an author-supplied, highly visible focus indicator
When to Use
Description
- Examples
From a99bba442b478fbf16b33c0b75ca3bec1cdcc326 Mon Sep 17 00:00:00 2001
From: Francis Storr Updated periodically
Techniques are not required
WCAG Quick Reference
- Techniques for specific technologies
From a9b7a177c5f63b2dde7a290efa01e9bc6d69664b Mon Sep 17 00:00:00 2001
From: Francis Storr Using the region role to identify a region of the page
When to Use
Description
-region
role to a section of a page so that user agents and assistive technologies may be able to programmatically identify it. The region
role demarcates a segment of the page that contains content of significance so that it is more readily discoverable and navigable. The generic region should be used when the section cannot be marked up using a standard document landmark role (see ARIA11).region
role to a section of a page so that user agents and assistive technologies may be able to programmatically identify it. The region
role demarcates a segment of the page that contains content of significance so that it is more readily discoverable and navigable. The generic region should be used when the section cannot be marked up using a standard document landmark role (see ARIA11).aria-labelledby
, aria-label
, or another technique. Doing so helps to better expose content and information relationships on the page. The role of region
should be used prudently, because if overused they can make the page overly verbose for screen reader users.Examples
Identifying a portlet with a generic region
Resources
From 81bc21aaf15ac00ce8003285d0c5bce93e71a3dd Mon Sep 17 00:00:00 2001
From: Francis Storr
When to Use
Description
status
role from the ARIA specification to notify Assistive Technologies (AT) when content has been updated with information about the user's or application's status. This is done by adding role="status"
to the element that contains the status message. The aria live region role of status
has an implicit aria-live
value of polite
, which allows a user to be notified via AT (such as a screen reader) when status messages are added. The role of status
also has a default aria-atomic
value of true
, so that updates to the container marked with a role of status
will result in the AT presenting the entire contents of the container to the user, including any author-defined labels (or additional nested elements). Such additional context can be critical where the status message text alone will not provide an equivalent to the visual experience. The content of the aria-live container is automatically read by the AT, without the AT having to focus on the place where the text is displayed. See WAI-ARIA 1.1 status (role) for more details.
-
-status
role from the ARIA specification to notify Assistive Technologies (AT) when content has been updated with information about the user's or application's status. This is done by adding role="status"
to the element that contains the status message. The aria live region role of status
has an implicit aria-live
value of polite
, which allows a user to be notified via AT (such as a screen reader) when status messages are added. The role of status
also has a default aria-atomic
value of true
, so that updates to the container marked with a role of status
will result in the AT presenting the entire contents of the container to the user, including any author-defined labels (or additional nested elements). Such additional context can be critical where the status message text alone will not provide an equivalent to the visual experience. The content of the aria-live container is automatically read by the AT, without the AT having to focus on the place where the text is displayed. See WAI-ARIA status (role) for more details.
For each status message:
+For each status message:
role
attribute with a value of status
before the status message occurs.Some Web pages display scrolling text because there is limited space available. Scrolling the text in a small text window makes the content available for users who can read quickly enough, but causes problems for users who read more slowly or use assistive technology. This technique provides a mechanism to stop the movement and make the entire block of text available statically. The text may be made available in a separate window or in a (larger) section of the page. Users can then read the text at their own speed.
This technique does not apply when the text that is moving can not be displayed all at once on the screen (e.g., a long chat conversation).
This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to C29: Using a style switcher to provide a conforming alternate version and Understanding Conforming Alternate Versions for more information.
+This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to C29: Using a style switcher to provide a conforming alternate version and Understanding Conforming Alternate Versions for more information.
This technique is not a method for hiding complete links, only a section of text within a link. The resources section includes methods for hiding and showing links aimed at screen reader users.
This technique to hide link text has been advocated by some screen reader users and corporate Web authors. It has proved effective on some Web sites. Other screen reader users and accessibility experts don't recommend this as a general technique because the results can be overly chatty and constrain the ability of the experienced screen reader user to control the verbosity. The working group believes the technique can be useful for Web pages that do not have repetitive content in the hidden text areas.
-This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to C29 and Understanding Conforming Alternate Versions for more information.
+This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to C29 and Understanding Conforming Alternate Versions for more information.
This technique can be used to meet Success Criterion 1.4.5 or 1.4.9 if a presentation that does not include images of text is available and as long as the user interface control that is provided to allow users to switch to an alternate presentation meets the relevant criteria. Where possible, authors should deliver the presentation that does not include images of text as the default presentation. In addition, the control used to switch should be located near the beginning of the page.
A variety of "image replacement" techniques have been developed to address a variety of user agent, configuration and compatibility with assistive technology issues (See resources for more information). While there are a variety of approaches authors may use to replace text, it is important to consider compatibility with assistive technology, whether the technique will work correctly if scripting, CSS, images (or combinations of these) are turned off. Since it can be difficult to find a single solution that works in all cases, this technique recommends the use of a control that allows users to switch to a presentation that does not include an image replacement technique.
This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to C29 and Understanding Conforming Alternate Versions for more information.
+This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to C29 and Understanding Conforming Alternate Versions for more information.
HTML and XHTML
+HTML
Forms are frequently designed so that they submit automatically when the user has filled in all the fields, or when focus leaves the last field. There are diff --git a/techniques/failures/F37.html b/techniques/failures/F37.html index 1f40363aa8..0cdeeab5ee 100644 --- a/techniques/failures/F37.html +++ b/techniques/failures/F37.html @@ -1,7 +1,7 @@
HTML and XHTML
+HTML
This document describes a failure that occurs when changing the selection of a radio button, a check box or an item in a select list causes a new window to diff --git a/techniques/failures/F38.html b/techniques/failures/F38.html index d3121bad25..975f700170 100644 --- a/techniques/failures/F38.html +++ b/techniques/failures/F38.html @@ -1,5 +1,5 @@
HTML and XHTML
+HTML
This describes a failure condition for text alternatives for images that should be ignored by AT. If there is no alt attribute at all assistive diff --git a/techniques/failures/F39.html b/techniques/failures/F39.html index 038c860ca0..31645f9e86 100644 --- a/techniques/failures/F39.html +++ b/techniques/failures/F39.html @@ -2,7 +2,7 @@
Applies to HTML and XHTML.
+HTML
This technique describes a failure condition for images that should be ignored by assistive technologies. A text alternative for an image diff --git a/techniques/failures/F41.html b/techniques/failures/F41.html index ac8f21e0e2..8450d4b88c 100644 --- a/techniques/failures/F41.html +++ b/techniques/failures/F41.html @@ -1,5 +1,5 @@
HTML and XHTML
+HTML
meta diff --git a/techniques/failures/F42.html b/techniques/failures/F42.html index 38ada7ca82..e87d28bbb8 100644 --- a/techniques/failures/F42.html +++ b/techniques/failures/F42.html @@ -1,5 +1,5 @@
HTML and XHTML
+HTML
This failure occurs when JavaScript event handlers are attached to elements to emulate links. A link created in this manner cannot be tabbed to from the keyboard and does not gain keyboard focus like other controls and/or links. diff --git a/techniques/failures/F43.html b/techniques/failures/F43.html index 3065159169..14c0c03c58 100644 --- a/techniques/failures/F43.html +++ b/techniques/failures/F43.html @@ -1,7 +1,7 @@
HTML and XHTML
+HTML
The objective of this technique is to describe a failure that occurs when structural markup is used to achieve a presentational effect, but indicates diff --git a/techniques/failures/F44.html b/techniques/failures/F44.html index a33f1d36c0..dda6c738f2 100644 --- a/techniques/failures/F44.html +++ b/techniques/failures/F44.html @@ -1,7 +1,7 @@
HTML and XHTML
+HTML
This document describes a failure that occurs when the tab order does not follow logical relationships and sequences in the content.
diff --git a/techniques/failures/F46.html b/techniques/failures/F46.html index 02bc9a7dc0..c4e71ebdd8 100644 --- a/techniques/failures/F46.html +++ b/techniques/failures/F46.html @@ -3,13 +3,13 @@ layout tablesHTML and XHTML
+HTML
The objective of this technique is to describe a failure that occurs when a table used only for layout includes either th elements, a summary attribute, or a caption element. This is a failure because it uses structural (or semantic) markup only for - presentation. The intent of the HTML and XHTML table elements is to present data.
+ presentation. The intent of the HTML table elements is to present data.Although not commonly used in a layout table, the following structural markup would also be failures of Success Criterion 1.3.1 if used in a layout table:
HTML and XHTML
+HTML
The blink element, while not part of the official HTML or XHTML specification, is supported by many user agents. It causes any text inside diff --git a/techniques/failures/F48.html b/techniques/failures/F48.html index d57758719d..8b94dfe5ef 100644 --- a/techniques/failures/F48.html +++ b/techniques/failures/F48.html @@ -1,7 +1,7 @@
HTML and XHTML
+HTML
This document describes a failure caused by use of the HTML pre element to markup tabular information. The pre element diff --git a/techniques/failures/F49.html b/techniques/failures/F49.html index c626f83cd0..959953d926 100644 --- a/techniques/failures/F49.html +++ b/techniques/failures/F49.html @@ -1,7 +1,7 @@
HTML and XHTML
+HTML
Although WCAG 2 does not prohibit the use of layout tables, CSS-based layouts are recommended in order to retain the defined semantic meaning of the HTML table
elements and to conform to the coding practice of separating presentation from content. If a layout table is used, however, it is important that the content make sense when linearized.
HTML and XHTML
+HTML
This failure demonstrates how using generic HTML elements to create user interface controls can make the controls inaccessible to assistive diff --git a/techniques/failures/F63.html b/techniques/failures/F63.html index ae0d983204..360bd622a7 100644 --- a/techniques/failures/F63.html +++ b/techniques/failures/F63.html @@ -1,5 +1,5 @@
HTML and XHTML
+HTML
This describes a failure condition when the context needed for understanding the purpose of a link is located in content that is not programmatically determined link context. If the context for the link is not provided in one of the following ways:
HTML and XHTML
+HTML
This describes a failure condition for text alternatives on images. If there is no source of text to provide an alternative for the image then assistive technologies are not able to identify the image or to convey its purpose to the user. The alt
attribute continues to be the preferred way to provide alternative text for images. Appropriate WAI-ARIA attributes may be used to provide alternative text, as long as they are accessibility supported. For more information about accessibility support, see Documenting Accessibility Support. The Accessible Name and Description Computation described the method of deriving text alternative from the HTML and WAI-ARIA attributes of an element.
diff --git a/techniques/failures/F84.html b/techniques/failures/F84.html index ee30a67652..4b4a4eb0c5 100644 --- a/techniques/failures/F84.html +++ b/techniques/failures/F84.html @@ -1,5 +1,5 @@
HTML and XHTML
+HTML
This failure describes a common condition where links such as "click here" or "more" are used as anchor elements where you need to have the surrounding text to understand their purpose and where there isn't any mechanism to make the destination clear by itself, such as a button to expand the link text.
Many blind people who use screen readers call up a dialog box that has a list of links from the page. They use this list of links to decide where they will go. But if many of the links in that list simply say "click here" or "more" they will be unable to use this feature in their screen reader, which is a core navigation strategy. That's why it's a failure of 2.4.9 to not provide any way of allowing them to know the destination from the link text alone. It is also true for people who tab through links. If all they hear as they tab through the document is "click here, click here, click here etc." they will become confused.
diff --git a/techniques/failures/F90.html b/techniques/failures/F90.html index 84ff174b75..4de5a6db89 100644 --- a/techniques/failures/F90.html +++ b/techniques/failures/F90.html @@ -1,5 +1,5 @@HTML and XHTML.
+HTML
One way for authors to explicitly associate header cells to data cells is by using the id and headers attributes. These allow the author to associate multiple header cells to a particular data cell, which can be necessary when complex data tables with more than one level of heading are used.
The failure occurs when the relationship between data cells and corresponding header cells cannot be programmatically determined correctly because the association of id
and headers
attributes is faulty. This can happen, for example, when copying code within tables and forgetting to update the code.
HTML and XHTML.
+HTML
This failure occurs when data tables do not use header elements (th
) or other appropriate table mark-up (the scope
attribute, headers
and id
or the ARIA columnheader
and rowheader
) roles to make the headers programmatically determinable from within table content. Making headers programmatically determinable is especially important when data cells are only intelligible together with header information. When screen reader users navigate through the table content horizontally or vertically, the headers that change can be read out to provide the necessary context for the information in the data cells.
HTML and XHTML
+HTML
This failure occurs when a role of presentation is applied to an element whose purpose is to convey information or relationships in the content. Elements such as HTML This describes a failure condition for text alternatives on images. If there is no source of text to provide an alternative for the image then assistive technologies are not able to identify the image or to convey its purpose to the user. The This describes a failure condition for text alternatives on images. If there is no source of text to provide an alternative for the image then assistive technologies are not able to identify the image or to convey its purpose to the user. The
-Some Assistive Technologies attempt to compensate for the missing text alternatives by reading the file name of the image. But it is insufficient to rely simply on the file name for many reasons. For example, file names may not be descriptive (e.g., images/nav01.gif), and technology specifications do not require descriptive file names. And some Assistive Technologies do not read the file name if there is no text alternative provided via HTML attributes.
+Some Assistive Technologies attempt to compensate for the missing text alternatives by reading the file name of the image. But it is insufficient to rely simply on the file name for many reasons. For example, file names may not be descriptive (e.g., Any technology. The objective of this failure is to avoid situations in which synchronized media alternatives provide more information than the text for which they are alternatives, but do not provide their own text alternatives to provide access to the extra information. Synchronized media alternatives provide enhanced access to users for whom synchronized media is a more effective format than text. Since they are alternatives to text, they do not need themselves to have redundant text alternatives in the form of captions, audio descriptions or full text alternatives. However, if they provide more information than the text for which they are an alternative, then they are not just alternatives but are synchronized media content in their own right. In this case they are subject to the full requirements of Success Criterion 1.2.2 to provide captions and to Success Criterion 1.2.3 and 1.2.5. The objective of this failure is to avoid situations in which synchronized media alternatives provide more information than the text for which they are alternatives, but do not provide their own text alternatives to provide access to the extra information. Synchronized media alternatives provide enhanced access to users for whom synchronized media is a more effective format than text. Since they are alternatives to text, they do not need themselves to have redundant text alternatives in the form of captions, audio descriptions or full text alternatives. However, if they provide more information than the text for which they are an alternative, then they are not just alternatives but are synchronized media content in their own right. In this case they are subject to the full requirements of Success Criterion 1.2.2 to provide captions and to Success Criterion 1.2.3 and 1.2.5. Content that contains links. This failure condition occurs when a link contains only non-text content, such as an image, and that link cannot be identified by an accessible name. The accessible name for a link is defined according to the Accessible Name and Description Computation. This also applies when both text and images are used separately on a page to link to the same target. In this case success technique H2: Combining adjacent image and text links for the same resource is the recommended approach to reduce the number of separate links and the undesirable redundancy. This also applies when both text and images are used separately on a page to link to the same target. In this case success technique H2: Combining adjacent image and text links for the same resource is the recommended approach to reduce the number of separate links and the undesirable redundancy. The objective of this technique is to document the failure of text to re-scale when viewport units are used on text. As these units are relative to the viewport, it means they cannot be resized by zooming or adjusting text-size. There are various methods to increase and decrease the size of text and other content, but viewport units applied to text (generally via Some uses of viewport units may not prevent text-size adjustments, but if they are used as the primary method for defining text-size, they are likely to cause a failure of Success Criterion 1.4.4. Some uses of viewport units may not prevent text-size adjustments, but if they are used as the primary method for defining text-size, they are likely to cause a failure of Success Criterion 1.4.4. If media queries were used to adjust the size of text or unit of measure at different screen sizes, it may not be a failure of Resize Text. On-page controls provided by the author are also a way of passing the resize text success criteria. If media queries were used to adjust the size of text or unit of measure at different screen sizes, it may not be a failure of Resize Text. On-page controls provided by the author are also a way of passing the resize text success criteria. General This document describes a failure that occurs when the content in the main viewport viewport is automatically updated, and there is no option for a user to disable this behavior. This document describes a failure that occurs when the content in the main viewport viewport is automatically updated, and there is no option for a user to disable this behavior. Two procedures are presented below to test for the existence of a failure against Success Criterion 3.2.5. Procedure 1 is the preferred procedure and assumes that content authors have access to the code that generates the viewport content. However there may be instances where this may not be possible (eg: in certain content management systems, application environments such as django or ruby-on-rails, or content generated through scripting languages such as AJAX or PHP that are generated by third parties.) To that end, the second procedure is supplied to allow testing in these instances. Note that timeframes are indicative only, and that any change after any amount of time should be treated as a failure if the test otherwise does not pass the other step evaluations. Technologies that support script-controlled blinking of content. Scripts can be used to blink content by toggling the content's visibility on and off at regular intervals. It is a failure for the script not to include a mechanism to stop the blinking at 5 seconds or earlier. See Using scripts to control blinking and stop it in five seconds or less for information about how to modify the technique to stop the blinking. Scripts can be used to blink content by toggling the content's visibility on and off at regular intervals. It is a failure for the script not to include a mechanism to stop the blinking at 5 seconds or earlier. See Using scripts to control blinking and stop it in five seconds or less for information about how to modify the technique to stop the blinking. It is acceptable to use the meta element to create a redirect
when the time-out is set to zero, since the redirect is instant and will not
be perceived as a change of context. However, it is preferable to use
- server-side methods to accomplish this. See Implementing automatic redirects on the server side
+ server-side methods to accomplish this. See Implementing automatic redirects on the server side
instead of on the client side.table
, can convey information about the content contained in them via their semantic markup. The WAI-ARIA role of
presentation
From 3725e547dda7edc5ed10f4ea512884fd5dc09196 Mon Sep 17 00:00:00 2001
From: Francis Storr Failure of Success Criterion 1.1.1 due to omitting the alt attribute or text alternative on img elements, area elements, and input elements of type "image"
When to Use
Description
- alt
attribute continues to be the preferred way to provide alternative text for images. Appropriate WAI-ARIA attributes may be used to provide alternative text, as long as they are accessibility supported. For more information about accessibility support, see Documenting Accessibility Support. The Accessible Name and Description Computation described the method of deriving text alternative from the HTML and WAI-ARIA attributes of an element.alt
attribute continues to be the preferred way to provide alternative text for images. Appropriate WAI-ARIA attributes may be used to provide alternative text, as long as they are accessibility supported. For more information about accessibility support, see Documenting Accessibility Support. The Accessible Name and Description Computation described the method of deriving text alternative from the HTML and WAI-ARIA attributes of an element.images/nav01.gif
), and technology specifications do not require descriptive file names. And some Assistive Technologies do not read the file name if there is no text alternative provided via HTML attributes.
Examples
Failure of Success Criterion 1.2.2 by providing synchronized media without captions when the synchronized media presents more information than is presented on the page
When to Use
Description
- Examples
Tests
Procedure
From 2196c2b356d874c3eef7fe3b8b180a4f9785d2ec Mon Sep 17 00:00:00 2001
From: Francis Storr
Description
Examples
Search Results
From 8f950c9842ed20e6e51c7762a906bdf8f55d6920 Mon Sep 17 00:00:00 2001
From: Francis Storr Metadata
Description
font-size
in CSS) prevent most available methods. Attempts to use browser controls to zoom or adjust text-size will not work. Only methods that completely override the CSS will work, and those could cause other issues such as layouts collapsing or text overlapping.Examples
From 5dd2c90e9fcdf0f0f3026b2833c9c0a2517230f5 Mon Sep 17 00:00:00 2001
From: Francis Storr When to Use
Description
- Examples
From ea6e8846cfc88980d5b6dcc252d6994d64153b42 Mon Sep 17 00:00:00 2001
From: Francis Storr Procedure
When to Use
Description
- Examples
From fbf4eff0cf4a17fdec10fbb7a6d11fb8f59a918f Mon Sep 17 00:00:00 2001
From: Francis Storr Examples
From 680dcdc24cb1f97716768d9d06720c361996fc8c Mon Sep 17 00:00:00 2001
From: Francis Storr
The purpose of this technique is to identify a failure condition where form inputs do not have the correct autocomplete
attribute values for inputs that request information about the user of the form.
Success Criterion 1.3.5 uses a fixed list of tokens in Input Purposes for user interface components (based on the HTML 5.2 autocomplete
attribute's fixed list of token values) because the programmatic association of specified token values (metadata) allows for other machine processing, such as expressing the input label in different modalities.
Success Criterion 1.3.5 uses a fixed list of tokens in Input Purposes for user interface components (based on the HTML 5.2 autocomplete
attribute's fixed list of token values) because the programmatic association of specified token values (metadata) allows for other machine processing, such as expressing the input label in different modalities.
Another important part of this Success Criterion is that the token values are associated with inputs that are scoped directly to the primary end user.
The second step in this failure technique involves examining code. Where dynamic content meets the definition of a status message, its container can be examined for an appropriate WAI-ARIA role or property which allows it to be programmatically determinable as a status message. Currently there are only a small number of techniques available to indicate status messages to assistive technologies. They are:
output
elementThe objective of this Failure is to describe situations where authors have implemented a function that is operated via a path-based gesture, and no alternative ways of operating this function via simple pointer gestures exist.
-If you did not create the content and functionality you can find path-based gestures by exploring the content on a touch screen, or checking the page code for the existence of specific event handlers such as touchstart or touchend. See the Understanding document for Pointer Gestures for more on the path-based gestures.
+If you did not create the content and functionality you can find path-based gestures by exploring the content on a touch screen, or checking the page code for the existence of specific event handlers such as touchstart or touchend. See the Understanding document for Pointer Gestures for more on the path-based gestures.
Note: For functionality implemented with a path-based gesture, the possibility of also operating it via the keyboard is beneficial (and may serve to meet Success Criterion 2.1.1 Keyboard). The point of Success Crtierion 2.5.1, however, is to ensure that pointer users who on many devices will have no keyboard available, have alternative ways of operating the function via simple pointer input.
One way for authors to explicitly associate header cells to data cells is by using the id and headers attributes. These allow the author to associate multiple header cells to a particular data cell, which can be necessary when complex data tables with more than one level of heading are used.
The failure occurs when the relationship between data cells and corresponding header cells cannot be programmatically determined correctly because the association of id
and headers
attributes is faulty. This can happen, for example, when copying code within tables and forgetting to update the code.
Note: The example below is based on the complex data table presented as example 1 of Technique H43: Using id and headers attributes to associate data cells with header cells in data tables. +
Note: The example below is based on the complex data table presented as example 1 of Technique H43: Using id and headers attributes to associate data cells with header cells in data tables.
The objective of this technique is to provide a mechanism to bypass blocks of material that are repeated on multiple Web pages by skipping directly to the main content of the Web page. The first interactive item in the Web page is a link to the beginning of the main content. Activating the link sets focus beyond the other content to the main content. This technique is most useful when a Web page has one main content area, rather than a set of content areas that are equally important, and when there are not multiple navigation sections on the page.
It is preferable for links to be visible at all times, since users navigating via the keyboard include switch users, those using techniques that generate keyboard strokes slowly, screen magnification software users, screen reader users working with sighted colleagues, keyboard only users and those navigating using voice recognition software. However, Success Criterion 2.4.1 does not require that they be visible when they do not have focus, and links that are visible only when they have focus can meet this success criterion.
+It is preferable for links to be visible at all times, since users navigating via the keyboard include switch users, those using techniques that generate keyboard strokes slowly, screen magnification software users, screen reader users working with sighted colleagues, keyboard only users and those navigating using voice recognition software. However, Success Criterion 2.4.1 does not require that they be visible when they do not have focus, and links that are visible only when they have focus can meet this success criterion.
The objective of this technique is to make the definition of a word, phrase, or abbreviation available by providing the definition in a glossary. A glossary is an alphabetical list of words, phrases, and abbreviations with their definitions. Glossaries are most appropriate when the words, phrases, and abbreviations used within the content relate to a specific discipline or technology area. A glossary can also provide the pronunciation of a word or phrase.
The glossary is included at the end of the Web page or the glossary is located via one of the mechanisms for locating content within a set of Web pages. (See - Understanding Success Criterion 2.4.5.)
+ Understanding Success Criterion 2.4.5.)If the glossary contains several definitions for the same word, phrase, or abbreviation, simply providing the glossary is not sufficient to satisfy this Success Criterion. A different technique should be used to find the correct definition. This is especially important if the uses of the word, phrase, or abbreviation are not unique within the Web page, that is, if different occurrences of the item have different definitions.
An annual report discusses multiple factors that influenced the company's performance in the past year. The report also includes charts and graphs that illustrate how these factors interact. Each chart or graph has a text alternative as required by - Success Criterion 1.1.1. Each one also has a number in its caption (e.g., “Figure 7"). These numbers are used in the text to reference the charts or graphs.
+ Success Criterion 1.1.1. Each one also has a number in its caption (e.g., “Figure 7"). These numbers are used in the text to reference the charts or graphs.The objective of this technique is to enable redirects on the client side without confusing the user. Redirects are preferably implemented on the - server side (see Implementing automatic redirects on the server side instead of on the client side), because a server-side + server side (see Implementing automatic redirects on the server side instead of on the client side), because a server-side redirect does not cause new content to be displayed before the server sends the content located at the new URI. However, authors do not always have control over server-side technologies; in that case, they can use a @@ -25,7 +25,7 @@
The objective of this technique is to make section headings within Web content descriptive. Descriptive headings and titles (see Providing descriptive titles for Web pages) work together to give users an overview of the content and its organization. Descriptive headings identify sections of the content in relation both to the Web page as a whole and to other sections of the same Web page.
+The objective of this technique is to make section headings within Web content descriptive. Descriptive headings and titles (see Providing descriptive titles for Web pages) work together to give users an overview of the content and its organization. Descriptive headings identify sections of the content in relation both to the Web page as a whole and to other sections of the same Web page.
Descriptive headings help users find specific content and orient themselves within the Web page.
Authors may also want to consider putting the most important information at the beginning of each heading. This helps users "skim" the headings to locate the specific content they need, and is especially helpful when browsers or assistive technology allow navigation from heading to heading.
Some people with cognitive disabilities require specific color combinations of foreground text and background to help them successfully understand the contents of the Web page. Most popular browsers provide the option to change colors settings globally within the browser. In this case the colors selected by the user override the foreground and background colors specified by the Web author.
In order to meet this success criterion, the Web author would design the page so that it works with browsers that have these controls, and the author does not override these controls.
-Note that overriding the foreground and background colors of all text on a page may hide visual clues to the grouping and organization of the Web page, making it much more difficult to understand and use. This technique may not be appropriate when background colors are used to delineate areas of the page. This technique may be appropriate for technologies and user agents that do not alter border colors when background colors are overridden. If background colors are used to delineate areas of the page, "Specifying text and background colors of secondary content such as banners, features and navigation in CSS while not specifying text and background colors of the main content" may be used to permit the user to control the colors of the main text while retaining the visual structure of the Web page.
+Note that overriding the foreground and background colors of all text on a page may hide visual clues to the grouping and organization of the Web page, making it much more difficult to understand and use. This technique may not be appropriate when background colors are used to delineate areas of the page. This technique may be appropriate for technologies and user agents that do not alter border colors when background colors are overridden. If background colors are used to delineate areas of the page, "Specifying text and background colors of secondary content such as banners, features and navigation in CSS while not specifying text and background colors of the main content" may be used to permit the user to control the colors of the main text while retaining the visual structure of the Web page.
See also - Related Resources for Success Criterion 1.2.6 - Sign Language.
+ Related Resources for Success Criterion 1.2.6 - Sign Language.When a button invokes a function on an input field, has a clear text label, and is rendered adjacent to the input field, the button also acts as a label for the input field. This label helps users understand the purpose of the field without introducing repetitive text on the Web page. Buttons that label single text fields typically follow the input field.
The field must also have a programmatically determined name, per - Success Criterion 4.1.2.
+ Success Criterion 4.1.2.This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to - C29: Using a style switcher to provide a conforming alternate version + C29: Using a style switcher to provide a conforming alternate version and - Understanding Conforming Alternate Versions + Understanding Conforming Alternate Versions for more information.
The objective of this technique is to ensure that users can obtain an accessible version of content where both non-conforming and conforming versions are provided.
-Conformance Requirement 1 allows non-conforming pages to be included within the scope of conformance as long as they have a "conforming alternate version". It is not always possible for authors to include accessibility supported links to conforming content from within non-conforming content. Therefore, authors may need to rely on the use of Server Side Scripting technologies (ex. PHP, ASP, JSP) to ensure that the non-conforming version can only be reached from a conforming page.
+Conformance Requirement 1 allows non-conforming pages to be included within the scope of conformance as long as they have a "conforming alternate version". It is not always possible for authors to include accessibility supported links to conforming content from within non-conforming content. Therefore, authors may need to rely on the use of Server Side Scripting technologies (ex. PHP, ASP, JSP) to ensure that the non-conforming version can only be reached from a conforming page.
This technique describes how to use information provided by the HTTP referer to ensure that non-conforming content can only be reached from a conforming page. The HTTP referer header is set by the user agent and contains the URI of the page (if any) which referred the user agent to the non-conforming page.
To implement this technique, an author identifies the URI for the conforming version of the content, for each non-conforming page. When a request for the non-conforming version of a page is received, the server compares the value of the HTTP referer header against the URI of the conforming version to determine whether the link to the non-conforming version came from the conforming version. The non-conforming version is only served if the HTTP referer matches the URI of the non-conforming version. Otherwise, the user is redirected to the conforming version of the content. Note that when comparing the URI in the HTTP referer header, non-relevant variations in the URI, such as in the query and target, should be taken into account.
The objective of this technique is to notify the user when a field that must be completed has not been completed in a PDF form. Required fields are implemented using the /Ff
entry in the form field's dictionary. This is normally accomplished using a tool for authoring PDFs.
If errors are found, an alert dialog describes the nature of the error in text. This may be accomplished through scripting created by the author (see, for example, SCR18: Providing client-side validation and alert). User agents, such as Adobe Acrobat Pro and LiveCycle, can provide automatic alerts (as described in the examples below).
+If errors are found, an alert dialog describes the nature of the error in text. This may be accomplished through scripting created by the author (see, for example, SCR18: Providing client-side validation and alert). User agents, such as Adobe Acrobat Pro and LiveCycle, can provide automatic alerts (as described in the examples below).
Once the user dismisses the alert dialog, it may be helpful if the script positions the keyboard focus on the field where the error occurred, although some users may expect the focus to remain on the last control focused prior to the alert appearing. Authors should exercise care to ensure that any movement of the focus will be expected. For example, if the alert announces a missing required phone number, positioning the focus on the phone number field when the alert is dismissed can be regarded as helpful and expected. In some cases, however, this may not be possible. If multiple input errors occur on the page, another approach must be taken to error reporting. (See, for example, the Adobe SDK.)
If the required format is not used, an alert dialog describes the nature of the error in text. This may be accomplished through scripting - created by the author (see, for example, SCR18: Providing client-side validation and alert). User agents can provide automatic alerts (as described in the examples below).
+ created by the author (see, for example, SCR18: Providing client-side validation and alert). User agents can provide automatic alerts (as described in the examples below).Once the user dismisses the alert dialog, it may be helpful if the script positions the keyboard focus on the field where the error occurred, although some users may expect the focus to remain on the last control focused prior to the alert appearing. Authors should exercise care to ensure that any movement of the focus will be expected. For example, if the alert announces an error in a phone number format, positioning the focus on the phone number field when the alert is dismissed can be regarded as helpful and expected. In some cases, however, this may not be possible. If multiple input errors occur on the page, an alternative approach to error notification should be implemented.
autocomplete
attributes
All HTML form fields that map to the HTML 5.2 autofill
tokens.
All HTML form fields that map to the HTML 5.2 autofill
tokens.
The autocomplete
attribute allows the browser to do a pattern match against a list of values locally stored with the browser, and supplies the appropriate corresponding value when the input is programmatically tagged. This is a user setting that can be turned on or off, or modified by the end user. This reduces typing and reliance on memory because it uses stored values to fill in the fields.
It's important to note the Success Criterion Identify Input Purpose and autocomplete
attribute only place requirements on input fields collecting information about the user.
It's important to note the Success Criterion Identify Input Purpose and autocomplete
attribute only place requirements on input fields collecting information about the user.
For the Success Criterion, it is assumed that the autocomplete
attribute is not used on form fields that do not correspond to an autocomplete field described in the HTML autocomplete
attribute specification. If the autocomplete
field is used to describe a "custom" taxonomy, rather than that described in the specification, this rule may produce incorrect results.
For each form field that collects information about the user and corresponds to an autocomplete
field described in WCAG 2.1 7. Section 7: Input Purposes for User Interface Components, check the following:
For each form field that collects information about the user and corresponds to an autocomplete
field described in WCAG 2.1 7. Section 7: Input Purposes for User Interface Components, check the following:
autocomplete
attribute and value pair.autocomplete
token on the input.The src
attribute of the track
element is a URL that is the address of the text track data.
The kind
attribute of the track
element indicates the kind of information in the timed text. captions text tracks provide a text version of dialogue and other sounds important to understanding the video. Subtitles contain only the dialogue. If other audio information is important to understanding the video, a subtitle track will not be sufficient to meet the success criterion.
Some regions use the term "subtitle" for any visible text representation of the audio track. An author may mark up a timed text track in the language of the audio track as kind=subtitles, instead of kind=captions, and may include additional relevant audio information. It is not best practice to use subtitles in this situation, since it may confuse users who are trying to find captions, but such a timed text track would meet the requirements of Success Criterion 1.2.2.
+Some regions use the term "subtitle" for any visible text representation of the audio track. An author may mark up a timed text track in the language of the audio track as kind=subtitles, instead of kind=captions, and may include additional relevant audio information. It is not best practice to use subtitles in this situation, since it may confuse users who are trying to find captions, but such a timed text track would meet the requirements of Success Criterion 1.2.2.
For other resources, see G134:
+ For other resources, see G134:
Validating Web pages.
For other resources, see G134: Validating Web pages.
+For other resources, see G134: Validating Web pages.
Refer to the resources section of Validating Web
+ Refer to the resources section of Validating Web
pages.
ASCII art was common on the internet before graphics became widely used. ASCII characters were arranged to form pictures, pictures of text, or graphs. Although ASCII content is not used frequently on the Web anymore, it must be remembered that, when it is used, it can be very confusing to people who are accessing the internet using screen readers. If ASCII art is used, it should also have a text explanation of what the picture is. It is also suggested that, if the ASCII picture isn't marked up as an image using ARIA, that there is a link to skip over the art (although this is not required).
-Leet used to be a fairly-common part of Internet culture and slang, but is now hardly used. Leetspeak uses various combinations of characters, including numerals and special characters, to replace standard characters. Leet is often incomprehensible to people using screen readers, and therefore requires a text alternative in order to conform to Success Criterion 1.1.1 (Non-Text Content).
+Leet used to be a fairly-common part of Internet culture and slang, but is now hardly used. Leetspeak uses various combinations of characters, including numerals and special characters, to replace standard characters. Leet is often incomprehensible to people using screen readers, and therefore requires a text alternative in order to conform to Success Criterion 1.1.1 (Non-Text Content).
The objective of this technique is to enable redirects on the client side without confusing the user. Redirects are preferably implemented on the server side (see Implementing automatic redirects on the server side instead of on the client side), but authors do not always have control over server-side technologies.
+The objective of this technique is to enable redirects on the client side without confusing the user. Redirects are preferably implemented on the server side (see Implementing automatic redirects on the server side instead of on the client side), but authors do not always have control over server-side technologies.
In HTML, one can use the meta
element with the value of the http-equiv
attribute set to refresh
and the value of the content
attribute set to 0
(meaning zero seconds), followed by the URI that the browser should request. It is important that the time-out is set to zero, to avoid that content is displayed before the new page is loaded. The page containing the redirect code should only contain information related to the redirect.
For other resources, see Validating Web
+ For other resources, see Validating Web
pages.
doctype
.
This technique is appropriate when framesets are already used to organize the content of the page; other techniques are preferred for pages that are not already using framesets, because many people using assistive technology have trouble with frames . An - advisory technique about using noframes is available in Success Criterion 1.1.1.
+ advisory technique about using noframes is available in Success Criterion 1.1.1.In HTML5 the frame
element is marked as obsolete.
dfn
element is used to indicate the
defining instance of the enclosed term. In other words, it marks the occurrence of the
term where the term is defined. Note that it encloses the term, not the definition. This
- technique would be used in combination with Using
+ technique would be used in combination with Using
inline definitions to provide the definition.
The objective of this technique is to use the label
element to explicitly associate a form control with a label. A label
is attached to a specific form control through the use of the for
attribute. The value of the for
attribute must be the same as the value of the id
attribute of the form control.
The id
attribute may have the same value as the name
attribute, but both must be provided, and the id
must be unique in the Web page.
This technique is sufficient for Success Criteria 1.1.1 (Non-Text Content), 1.3.1 (Info and Relationships) and 4.1.2 (Name, Role, Value) whether or not the label
element is visible. That is, it may be hidden using CSS. However, for Success Criterion 3.3.2 (Labels or Instructions), the label
element must be visible since it provides assistance to all users who need help understanding the purpose of the field.
This technique is sufficient for Success Criteria 1.1.1 (Non-Text Content), 1.3.1 (Info and Relationships) and 4.1.2 (Name, Role, Value) whether or not the label
element is visible. That is, it may be hidden using CSS. However, for Success Criterion 3.3.2 (Labels or Instructions), the label
element must be visible since it provides assistance to all users who need help understanding the purpose of the field.
An additional benefit of this technique is a larger clickable area for the control, since clicking on the label or the control will activate the control. This can be helpful for users with impaired motor control.
Note that the label
is positioned after input
elements of type="checkbox"
and type="radio"
.
The caption
element is the appropriate markup for such text and it ensures
that the table identifier remains associated with the table, including visually (by default). In addition, using the caption
element allows screen reading software to navigate directly to the caption for a table if one is present.
Although WCAG 2 does not prohibit the use of layout tables, CSS-based layouts are recommended in order to retain the defined semantic meaning of the HTML table
elements and to conform to the coding practice of separating presentation from content. If a table is used for layout, the caption
element is not used. The purpose of a layout table is simply to control the placement of content; the table itself is "transparent" to the user. A caption
would "break" this transparency by calling attention to the table. See F46 for details.
Although WCAG 2 does not prohibit the use of layout tables, CSS-based layouts are recommended in order to retain the defined semantic meaning of the HTML table
elements and to conform to the coding practice of separating presentation from content. If a table is used for layout, the caption
element is not used. The purpose of a layout table is simply to control the placement of content; the table itself is "transparent" to the user. A caption
would "break" this transparency by calling attention to the table. See F46 for details.
title
attribute is something the user should know before
following the link, such as a warning, then it should be provided in the link text
rather than in the title
attribute.
- Because of the extensive user agent limitations in supporting access to the title attribute, authors should use caution in applying this technique. For this reason, it is preferred that the author use technique C7: Using CSS to hide a portion of the link text or H30: Providing link text that describes the purpose of a link for anchor elements.
+Because of the extensive user agent limitations in supporting access to the title attribute, authors should use caution in applying this technique. For this reason, it is preferred that the author use technique C7: Using CSS to hide a portion of the link text or H30: Providing link text that describes the purpose of a link for anchor elements.
This objective of this technique is to provide both text and iconic representations of links without making the web page more confusing or difficult for keyboard users or assistive technology users. Since different users finding text and icons more usable, providing both can improve the accessibility of the link.
Many links have both a text and iconic representation adjacent to each other, but rendered in separate a
elements. Visually they appear to be a single link, but many users encounter them as adjacent identical links. For a keyboard user, it is tedious to navigate through redundant links. For users of assistive technologies, it can be confusing to encounter successive identical links. When the text alternative for the icon is a duplicate of the link text, it is repetitive as screen readers read the description twice.
If the author omitted alternative text from the link image, it would fail Success Criterion 1.1.1 because the text alternative would not serve the same purpose as the graphical link.
+If the author omitted alternative text from the link image, it would fail Success Criterion 1.1.1 because the text alternative would not serve the same purpose as the graphical link.
This technique provides such links by putting the text and image together in one a
element and providing null alternative text on the image to eliminate duplication of text. In this way, both representations of the link are provided, but keyboard users only encounter one link and assistive technology that provides users with link lists for a web page do not include duplicate links.
Sometimes the text and the icon link are rendered in separate, adjacent table cells to facilitate page layout. Although WCAG 2 does not prohibit the use of layout tables, CSS-based layouts are recommended in order to retain the defined semantic meaning of the HTML table elements and to conform to the coding practice of separating presentation from content. If CSS is used, this technique can be applied to combine the links.
To prevent accidental activation, authors must allow users to turn off or reconfigure shortcuts that are made up of only character keys. Reconfiguring the shortcut may involve the ability to add a modifier key such as Ctrl, or authors may elect to allow users to alter the character keys assigned in addition to adding a modifer. Providing a mechanism to turn off or reassign the shortcut ensures more users can successfully interact with the application.
If the keyboard shortcut is only active when a particular user interface component has focus, then the author does not need to provide an override mechanism. For example, in a select
element, it is expected behaviour that pressing a letter key will reposition to the next item within the select element that begins with that character. This shortcut is only triggered when the select element has focus, and so it does not interfere with a user's ability to interact with the rest of the page.
An initial challenge for testers is identifying if author-created shortcuts exist, and then determining if existing shortcuts are triggered by character keys without modifiers. Where testers have access to the develop team, the existence and nature of shortcut keys can often be determined simply by asking involved designers and developers. Where reliable information from the authors is not available, the presence of shortcuts can possibly be identified by checking code (for example, in javascript, the presence of keydown
, keyup
and keypress
listeners). Another means of identifying shortcuts is to review documentation. Where none of these strategies provide information on the presence of keyboard shortcuts, manual tests will need to be completed to search for the existence of character key shortcuts. Review the test procedure in failure technique F99 for guidance.
An initial challenge for testers is identifying if author-created shortcuts exist, and then determining if existing shortcuts are triggered by character keys without modifiers. Where testers have access to the develop team, the existence and nature of shortcut keys can often be determined simply by asking involved designers and developers. Where reliable information from the authors is not available, the presence of shortcuts can possibly be identified by checking code (for example, in javascript, the presence of keydown
, keyup
and keypress
listeners). Another means of identifying shortcuts is to review documentation. Where none of these strategies provide information on the presence of keyboard shortcuts, manual tests will need to be completed to search for the existence of character key shortcuts. Review the test procedure in failure technique F99 for guidance.
In native buttons in iOS and Android onclick events are triggered on the up-event by default.
-The WCAG standard itself applies to web pages at a URL, and therefore this example is provided as helpful supplementary advice for those looking to implement the WCAG2ICT for native applications.
+The WCAG standard itself applies to web pages at a URL, and therefore this example is provided as helpful supplementary advice for those looking to implement the WCAG2ICT for native applications.
When speech input users interact with a web page, they usually speak a command followed by the reference to some visible label (such as text beside an input field or inside a button or link). For example, they may say "click search" to activate a button labelled Search. When speech recognition software processes speech input and looks for matches, it uses the accessible name of controls. Where there is a mismatch between the text in the label and the text in the accessible name, it can cause issues for the user. The simplest way to enable speech input users and meet 2.5.3 Label in Name is to ensure that the accessible name matches the visible text label.
Sometimes more than one text string will be positioned in the vicinity of a control that could be considered a candidate for its label. For example, a set of inputs that each have their own labels may also be preceded by a heading, an instruction or a group label (such as an HTML legend/fieldset or an ARIA group or radiogroup). Note that the term "group label" means something different than "label", both programmatically and in regard to 2.5.3 Label in Name.
-The Understanding 2.5.3 Label in Name document recommends that only the text string adjacent to or in close proximity to an input should be treated as the label when assessing a control's label for the purposes of meeting 2.5.3 (see the section "Identifying label text for components"). There are both practical and technical reasons for restricting the designation of an input's label in this way. The technical reasons are discussed in the Understanding document's section called Accessible Name and Description Computation specification.
+The Understanding 2.5.3 Label in Name document recommends that only the text string adjacent to or in close proximity to an input should be treated as the label when assessing a control's label for the purposes of meeting 2.5.3 (see the section "Identifying label text for components"). There are both practical and technical reasons for restricting the designation of an input's label in this way. The technical reasons are discussed in the Understanding document's section called Accessible Name and Description Computation specification.
Mapping a visible label to the accessible name is achieved in many technologies by meeting 1.3.1 Information and Relationships through the proper use of native semantics. Many controls derive accessible names by correct nesting of elements, while other elements have specific attributes which are a valid means of providing or referencing an accessible name.
+Mapping a visible label to the accessible name is achieved in many technologies by meeting 1.3.1 Information and Relationships through the proper use of native semantics. Many controls derive accessible names by correct nesting of elements, while other elements have specific attributes which are a valid means of providing or referencing an accessible name.
The accessible name should be assigned through native elements and semantics where possible. That helps ensure an exact match between the visible label and name.
The label for each component should be restricted to "Yes" and "No". To meet 1.3.1 Information and Relationships and 3.3.2 Labels or Instructions, the "Call me…" text can be coded to convey the relationship to ATs, in this example by using a fieldset
and legend
.
The label for each component should be restricted to "Yes" and "No". To meet 1.3.1 Information and Relationships and 3.3.2 Labels or Instructions, the "Call me…" text can be coded to convey the relationship to ATs, in this example by using a fieldset
and legend
.
If the label is not restricted to the string adjacent to the radio button, multiple interpretations of what constitutes the label can result in less uniform functionality. If "Yes" alone is not the label for the first radio button, is it "Call me when balance exceeds $10,000"? Or is it a combination of text strings, in which case is the order "Call me when balance exceeds $10,000 Yes" or "Yes, Call me when balance exceeds $10,000"? Decisions to combine text strings can have negative effects on screen reader users since the order of concatenation can affect meaning. In this example, "No, call me when balance exceeds $10,000" could be very confusing to a screen reader user.
<fieldset>
From a2c744d9e2f9087d148b5ae69ae0fa5a7d0e3254 Mon Sep 17 00:00:00 2001
From: Francis Storr
Date: Mon, 6 Nov 2023 11:18:48 -0800
Subject: [PATCH 65/80] Replace absolute URL(s) with relative
---
techniques/general/G206.html | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/techniques/general/G206.html b/techniques/general/G206.html
index 2d8347efa8..02f024b29d 100644
--- a/techniques/general/G206.html
+++ b/techniques/general/G206.html
@@ -5,7 +5,7 @@
It should be noted that it is also sufficient to lay out the content in such a way that horizontal scrolling is required to access content, but that it is not necessary to scroll horizontally in order to read a line of text.
For instance, a spreadsheet that requires horizontal scrolling is acceptable if no horizontal scrolling is necessary for each column individually (i.e., scrolling is only necessary to see other columns, but not for the left or right edges of each individual column).
- This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to C29: Using a style switcher to provide a conforming alternate version and Understanding Conforming Alternate Versions for more information.
+ This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to C29: Using a style switcher to provide a conforming alternate version and Understanding Conforming Alternate Versions for more information.
The purpose of this technique is to provide help using a multimedia avatar that provides assistance in using the Web page. An avatar can be particularly helpful to people with cognitive disabilities who may have trouble reading text. The use of visuals will help some people to focus on the material presented.
The multimedia avatar must also satisfy relevant Success Criterion in - Guideline 1.2.
+ Guideline 1.2.This technique relates to all technologies.
This is a general technique for allowing people who cannot use a page with blinking content to turn the blinking content off. - Conformance Requirement 1 + Conformance Requirement 1 allows for conforming alternate pages to be used to meet conformance. This technique is an example of that approach applied to success criteria 2.2.2.
It is important that the page without blinking content contain all of the information that was on the page with blinking content.
This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to - - and - Understanding Conforming Alternate Versions + Using a style switcher to provide a conforming alternate version + and Understanding Conforming Alternate Versions for more information.
If the control for switching to the alternate version is a link, it must always be possible to understand the purpose of the control directly from its link text.
This technique provides the alternate version for the current page view. It is also possible, and in some cases would be advisable, to save this preference in a cookie or server-side user profile, so that users would only have to make the selection once per site and would automatically be taken to their preferred version.
This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to C29: Using a style switcher to provide a conforming alternate version and Understanding Conforming Alternate Versions for more information.
+This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to C29: Using a style switcher to provide a conforming alternate version and Understanding Conforming Alternate Versions for more information.
Many people with cognitive disabilities have trouble reading text that is single spaced. A button that increases the line height will help them read the content. In order to retain the separation of paragraphs, the space between paragraphs should also increase so that it is at least 1.5 times as high as the line spacing.
This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to C29: Using a style switcher to provide a conforming alternate version and Understanding Conforming Alternate Versions for more information.
+This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to C29: Using a style switcher to provide a conforming alternate version and Understanding Conforming Alternate Versions for more information.
The objective of this technique is to make it possible for users to locate all the information in a small Web site by providing links to all Web pages from the home page. When the number of pages in the site is small enough, the home page can contain site map information directly. The other pages in the Web site contain links to the home page.
In this way, the home page serves as two mechanisms in one. It provides the usual navigation to pages. It also is a de facto site map to the site.
All the Web pages in the site may contain links to all the other pages, and those sets of links satisfy - Success Criterion 3.2.3 (Consistent Navigation).
+ Success Criterion 3.2.3 (Consistent Navigation).To use this technique, an author incorporates a visual cue in addition to color for each place where color alone is used to convey information. Visual cues can take many forms including changes to the font style, the addition of underlines, bold, or italics, or changes to the font size.
While this technique is sufficient to meet the visual requirements of Success Criterion 1.4.1, the information conveyed by the color must also be available programmatically to satisfy Success Criterion 1.3.1. See - How to Meet 1.3.1.
+ How to Meet 1.3.1.Any technology.
When the contrast between the text and its background for some portion of the page has not been designed to meet the contrast level for - Success Criterion 1.4.3 + Success Criterion 1.4.3 or - 1.4.6, it is possible to meet these guidelines using the "Alternate Version" clause in the conformance requirements (Conformance Requirement 1). A link or control on the page can either change the page so that all aspects conform, or it could take the viewer to a new version of the page that does conform at the desired level. Placing the link or control prominently on the page will assist users in accessing the conforming content readily.
+ 1.4.6, it is possible to meet these guidelines using the "Alternate Version" clause in the conformance requirements (Conformance Requirement 1). A link or control on the page can either change the page so that all aspects conform, or it could take the viewer to a new version of the page that does conform at the desired level. Placing the link or control prominently on the page will assist users in accessing the conforming content readily.For this technique to be used successfully, three things must be true:
This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to - C29: Using a style switcher to provide a conforming alternate version + C29: Using a style switcher to provide a conforming alternate version and - Understanding Conforming Alternate Versions + Understanding Conforming Alternate Versions for more information.
- This technique uses the status
role from the ARIA specification to notify Assistive Technologies (AT) when content has been updated with information about the user's or application's status. This is done by adding role="status"
to the element that contains the status message. The aria live region role of status
has an implicit aria-live
value of polite
, which allows a user to be notified via AT (such as a screen reader) when status messages are added. The role of status
also has a default aria-atomic
value of true
, so that updates to the container marked with a role of status
will result in the AT presenting the entire contents of the container to the user, including any author-defined labels (or additional nested elements). Such additional context can be critical where the status message text alone will not provide an equivalent to the visual experience. The content of the aria-live container is automatically read by the AT, without the AT having to focus on the place where the text is displayed. See WAI-ARIA status (role) for more details.
status
role from the ARIA specification to notify Assistive Technologies (AT) when content has been updated with information about the user's or application's status. This is done by adding role="status"
to the element that contains the status message. The aria live region role of status
has an implicit aria-live
value of polite
, which allows a user to be notified via AT (such as a screen reader) when status messages are added. The role of status
also has a default aria-atomic
value of true
, so that updates to the container marked with a role of status
will result in the AT presenting the entire contents of the container to the user, including any author-defined labels (or additional nested elements). Such additional context can be critical where the status message text alone will not provide an equivalent to the visual experience. The content of the aria-live container is automatically read by the AT, without the AT having to focus on the place where the text is displayed. See WAI-ARIA status (role) for more details.
For each status message:
+For each status message:
role
attribute with a value of status
before the status message occurs.Technologies that support Accessible Rich Internet Applications.
This technique demonstrates how to assign a generic region
role to a section of a page so that user agents and assistive technologies may be able to programmatically identify it. The region
role demarcates a segment of the page that contains content of significance so that it is more readily discoverable and navigable. The generic region should be used when the section cannot be marked up using a standard document landmark role (see ARIA11).
This technique demonstrates how to assign a generic region
role to a section of a page so that user agents and assistive technologies may be able to programmatically identify it. The region
role demarcates a segment of the page that contains content of significance so that it is more readily discoverable and navigable. The generic region should be used when the section cannot be marked up using a standard document landmark role (see ARIA11).
It is important to name regions, because they are generic grouping elements and users will need some way to tell which region they are in. Regions can be named using aria-labelledby
, aria-label
, or another technique. Doing so helps to better expose content and information relationships on the page. The role of region
should be used prudently, because if overused they can make the page overly verbose for screen reader users.
Some Web pages display scrolling text because there is limited space available. Scrolling the text in a small text window makes the content available for users who can read quickly enough, but causes problems for users who read more slowly or use assistive technology. This technique provides a mechanism to stop the movement and make the entire block of text available statically. The text may be made available in a separate window or in a (larger) section of the page. Users can then read the text at their own speed.
This technique does not apply when the text that is moving can not be displayed all at once on the screen (e.g., a long chat conversation).
This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to C29: Using a style switcher to provide a conforming alternate version and Understanding Conforming Alternate Versions for more information.
+This technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to C29: Using a style switcher to provide a conforming alternate version and Understanding Conforming Alternate Versions for more information.
Generally applicable.
The objective of this technique is enhance the focus indicator in the browser, by creating a highly visible one in the content. This technique is very similar to G195, but with a stronger indicator to meet Focus Appearance.
+The objective of this technique is enhance the focus indicator in the browser, by creating a highly visible one in the content. This technique is very similar to G195, but with a stronger indicator to meet Focus Appearance.
For a more detailed view of recent changes to the informative documents see the github updates. +
For a more detailed view of recent changes to the informative documents see the github updates.
From a4f65eb1a0d5d126eddd761d01d4fd2aea204bb1 Mon Sep 17 00:00:00 2001 From: Francis StorrThis technique can be used in combination with a style switching technique to present a page that is a conforming alternate version for non-conforming content. Refer to - C29: Using a style switcher to provide a conforming alternate version + C29: Using a style switcher to provide a conforming alternate version and - Understanding Conforming Alternate Versions + Understanding Conforming Alternate Versions for more information.
div
element