diff --git a/techniques/aria/ARIA20.html b/techniques/aria/ARIA20.html index b6de2fc8fa..ff47428ffb 100644 --- a/techniques/aria/ARIA20.html +++ b/techniques/aria/ARIA20.html @@ -1,7 +1,7 @@ Using the region role to identify a region of the page

Using the region role to identify a region of the page

ID: ARIA20

Technology: aria

Type: Technique

When to Use

Technologies that support Accessible Rich Internet Applications.

Description

-

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.

Examples

@@ -92,15 +92,11 @@

Identifying a portlet with a generic region

  • Checks #1-3 are true.
  • -
    - +

    Resources

    diff --git a/techniques/css/C30.html b/techniques/css/C30.html index 39c84b874b..d83a32b31d 100644 --- a/techniques/css/C30.html +++ b/techniques/css/C30.html @@ -21,7 +21,7 @@

    Description

    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.

    @@ -106,7 +106,7 @@

    Expected Results

    @@ -123,10 +123,10 @@

    Resources

    In Defense of Fahrner Image Replacement
  • - Fahrner Image Replacement + CSS image replacement
  • - CSS2: 14.2.1 Background properties: 'background-color', 'background-image', 'background-repeat', 'background-attachment', 'background-position', and 'background' + CSS Backgrounds And Borders Module
  • diff --git a/techniques/failures/F105.html b/techniques/failures/F105.html index 18be43550b..6bbbb182ca 100644 --- a/techniques/failures/F105.html +++ b/techniques/failures/F105.html @@ -21,7 +21,7 @@

    Applicability

    Description

    The 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.

    -

    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.

    +

    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 Criterion 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.

    Examples

    @@ -51,10 +51,11 @@

    Expected Results

    + diff --git a/techniques/failures/F41.html b/techniques/failures/F41.html index 7c059e713e..4f8445997f 100644 --- a/techniques/failures/F41.html +++ b/techniques/failures/F41.html @@ -1,30 +1,19 @@ Failure of Success Criterion 2.2.1, 2.2.4, and 3.2.5 due to using meta refresh to reload the page

    Failure of Success Criterion 2.2.1, 2.2.4, and 3.2.5 due to using meta refresh to reload the page

    ID: F41

    Technology: failures

    Type: Failure

    When to Use

    HTML

    -

    Description

    -

    - meta - http-equiv of refresh is often used to periodically refresh - pages or to redirect users to another page. If the time interval is too - short, and there is no way to turn auto-refresh off, people who are blind will not have enough time to make their screen - readers read the page before the page refreshes unexpectedly and causes the - screen reader to begin reading at the top. Sighted users may also be - disoriented by the unexpected refresh.

    -

    Examples

    +
    +
    +

    Description

    +

    meta http-equiv of refresh is often used to periodically refresh pages or to redirect users to another page. If the time interval is too short, and there is no way to turn auto-refresh off, people who are blind will not have enough time to make their screen readers read the page before the page refreshes unexpectedly and causes the screen reader to begin reading at the top. Sighted users may also be disoriented by the unexpected refresh.

    +
    +
    +

    Examples

    - -

    This is a deprecated example that changes the user's page at regular - intervals. Content developers should not use this technique to - simulate "push" technology. Developers cannot predict how much time - a user will require to read a page; premature refresh can disorient - users. Content developers should avoid periodic refresh and allow - users to choose when they want the latest information. (The number - in the content attribute is the refresh interval in - seconds.)

    +

    This is a deprecated example that changes the user's page at regular intervals. Content developers should not use this technique to simulate "push" technology. Developers cannot predict how much time a user will require to read a page; premature refresh can disorient users. Content developers should avoid periodic refresh and allow users to choose when they want the latest information. (The number in the content attribute is the refresh interval in seconds.)

    <!doctype>
     <html lang="en">
     <head>     
    -  <title>HTML Techniques for WCAG 2.0</title>     
    +  <title>HTML Techniques for WCAG 2</title>     
       <meta http-equiv="refresh" content="60" />   
     </head>
     <body>
    @@ -34,13 +23,13 @@
           

    Tests

    Procedure

    -

    For a page that uses meta http-equiv="refresh":

    +

    For a page that uses meta http-equiv="refresh":

      -
    1. Check that the numerical value for seconds until refresh in the content attribute is present.
    2. -
    3. Check that the numerical value for seconds until refresh in the content attribute is less than one or greater than 72,000.
    4. -
    5. Check if the page qualifies for Real-time or Essential Exceptions in Success Criterion 2.2.1 Timing Adjustable.
    6. +
    7. Check that the numerical value for seconds until refresh in the content attribute is present.
    8. +
    9. Check that the numerical value for seconds until refresh in the content attribute is less than one or greater than 72,000.
    10. +
    11. Check if the page qualifies for Real-time or Essential Exceptions in Success Criterion 2.2.1 Timing Adjustable.
    12. Check if the user is provided an opportunity to turn off, extend, or adjust the timing of the page refresh.
    13. -
    14. Check if the page does not refresh after the duration specified in the content attribute.
    15. +
    16. Check if the page does not refresh after the duration specified in the content attribute.

    Expected Results

    diff --git a/techniques/failures/F42.html b/techniques/failures/F42.html index b3a04249d2..001e1962f5 100644 --- a/techniques/failures/F42.html +++ b/techniques/failures/F42.html @@ -7,7 +7,7 @@ agents including assistive technology may not be able to identify the links in the content as links. They may be recognized as interactive controls but still not recognized as links. Such elements do not appear in the links list generated by user agents or assistive technology.

    -

    It is possible to use the ARIA role attribute to identify an anonymous element as link control for assistive technologies. However, best practice for ARIA calls for making use of native elements whenever possible, so the use of the role attribute to identify anonymous elements as links is not recommended.

    +

    It is possible to use the ARIA role attribute to identify an anonymous element as link control for assistive technologies. However, best practice for ARIA calls for making use of native elements whenever possible, so the use of the role attribute to identify anonymous elements as links is not recommended.

    The a and area elements are intended to mark up links.

    Examples

    @@ -116,13 +116,13 @@

    Scripting a div element

    Resources

    diff --git a/techniques/failures/F47.html b/techniques/failures/F47.html index 3adc2afd53..e6f50b0be3 100644 --- a/techniques/failures/F47.html +++ b/techniques/failures/F47.html @@ -1,19 +1,11 @@ Failure of Success Criterion 2.2.2 due to using the blink element

    Failure of Success Criterion 2.2.2 due to using the blink element

    ID: F47

    Technology: failures

    Type: Failure

    When to Use

    HTML

    Description

    -

    The blink element, while not part of the official HTML or XHTML - specification, is supported by many user agents. It causes any text inside - the element to blink at a predetermined rate. This cannot be interrupted by - the user, nor can it be disabled as a preference. The blinking continues as - long as the page is displayed. Therefore, content that uses - blink fails the Success Criterion because blinking can continue - for more than three seconds.

    +

    The blink element, while not part of the official HTML specification, is supported by many user agents. It causes any text inside the element to blink at a predetermined rate. This cannot be interrupted by the user, nor can it be disabled as a preference. The blinking continues as long as the page is displayed. Therefore, content that uses blink fails the Success Criterion because blinking can continue for more than three seconds.

    Examples

    -

    A product list page uses the blink element to draw - attention to sale prices. This fails the Success Criterion because - users cannot control the blink.

    +

    A product list page uses the blink element to draw attention to sale prices. This fails the Success Criterion because users cannot control the blink.

    <p>My Great Product <blink>Sale! $44,995!</blink></p>
    diff --git a/techniques/failures/F59.html b/techniques/failures/F59.html index ad52df74b2..517e362ffc 100644 --- a/techniques/failures/F59.html +++ b/techniques/failures/F59.html @@ -59,18 +59,18 @@

    If check #2 AND check #3 are false, the failure condition applies.

    Resources

    diff --git a/techniques/failures/F63.html b/techniques/failures/F63.html index 0f2f5d840d..55d4239f70 100644 --- a/techniques/failures/F63.html +++ b/techniques/failures/F63.html @@ -51,17 +51,17 @@

    A Link in an Adjacent Cell Within a Layout Table

    Resources

    diff --git a/techniques/failures/F65.html b/techniques/failures/F65.html index 8d64be22a0..4732d30257 100644 --- a/techniques/failures/F65.html +++ b/techniques/failures/F65.html @@ -1,4 +1,4 @@ -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"

    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"

    ID: F65

    Technology: failures

    Type: Failure

    When to Use

    +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"

    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"

    ID: F65

    Technology: failures

    Type: Failure

    When to Use

    HTML

    Description

    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.

    @@ -17,19 +17,10 @@

    Missing text alternative

    Procedure

    Identify img, area, and input elements of type image. For each of these elements:

      -
    1. - Check if the alt attribute is present. - -
    2. -
    3. - Check if aria-labelledby attribute is present AND references one or more id attributes in the page AND check if aria-labelledby is accessibility supported. -
    4. -
    5. - Check if the aria-label attribute is present AND check if aria-label is accessibility supported. -
    6. -
    7. - Check if the title attribute is present AND check if title is accessibility supported. -
    8. +
    9. Check if the alt attribute is present.
    10. +
    11. Check if aria-labelledby attribute is present AND references one or more id attributes in the page AND check if aria-labelledby is accessibility supported.
    12. +
    13. Check if the aria-label attribute is present AND check if aria-label is accessibility supported.
    14. +
    15. Check if the title attribute is present AND check if title is accessibility supported.

    Expected Results

    @@ -38,19 +29,19 @@

    Missing text alternative

    Resources

    diff --git a/techniques/failures/F75.html b/techniques/failures/F75.html index 45e2b3c9e6..1c18a743f8 100644 --- a/techniques/failures/F75.html +++ b/techniques/failures/F75.html @@ -1,7 +1,7 @@ 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

    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

    ID: F75

    Technology: failures

    Type: Failure

    When to Use

    Any technology.

    Description

    -

    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 Success Criterion 1.2.5.

    Examples

    Tests

    Procedure

      diff --git a/techniques/failures/F90.html b/techniques/failures/F90.html index a711c0e2cb..de1f7b5ec2 100644 --- a/techniques/failures/F90.html +++ b/techniques/failures/F90.html @@ -43,8 +43,7 @@

      Table content not correctly associated to nested headers

    Tests

    Procedure

      -
    1. For tables that associate data cells to header cells via the id and headers attributes, check that the programmatic association is correct. -
    2. +
    3. For tables that associate data cells to header cells via the id and headers attributes, check that the programmatic association is correct.

    Expected Results

    @@ -53,8 +52,8 @@

    Table content not correctly associated to nested headers

    \ No newline at end of file diff --git a/techniques/failures/F91.html b/techniques/failures/F91.html index 0df9da7b63..0a00ce9b9c 100644 --- a/techniques/failures/F91.html +++ b/techniques/failures/F91.html @@ -51,15 +51,11 @@

    Headers not marked up appropriately

    For all data tables, check if table headers can be correctly programmatically determined by use of one of the following mechanisms:

      -
    1. headers marked up with table header (th) elements -
    2. +
    3. headers marked up with table header (th) elements
    4. scope attributes on th for tables with more than a single row or column of table headers.
    5. -
    6. headers and data cells associated using headers and id attributes -
    7. -
    8. headers marked up as td elements with the scope attribute -
    9. -
    10. headers marked up with ARIA role attributes rowheader or columnheader -
    11. +
    12. headers and data cells associated using headers and id attributes
    13. +
    14. headers marked up as td elements with the scope attribute
    15. +
    16. headers marked up with ARIA role attributes rowheader or columnheader

    Expected Results

    @@ -68,10 +64,10 @@

    Headers not marked up appropriately

    \ No newline at end of file diff --git a/techniques/html/H33.html b/techniques/html/H33.html index ccc9698fae..e4674abc91 100644 --- a/techniques/html/H33.html +++ b/techniques/html/H33.html @@ -18,7 +18,7 @@

    When to Use

    Description

    The objective of this technique is to demonstrate how to use a title attribute on an anchor element to provide additional text describing a link. The title attribute is used to provide additional information to help clarify or further describe the purpose of a link. If the supplementary information provided through the 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.

    Examples

    @@ -50,7 +50,7 @@

    Expected Results

    Related Techniques

    diff --git a/techniques/html/H86.html b/techniques/html/H86.html index 5cf1e0a5f6..f439cd5f1f 100644 --- a/techniques/html/H86.html +++ b/techniques/html/H86.html @@ -20,7 +20,9 @@

    Description

    Emojis are very popular and are frequently used online to help provide more context and expression to text-based communication. Emojis come with their own pre-defined names that might not always match what the author is intending to communicate. For example, the emoji of a black right-facing triangle (►) is described by default as black right-pointing pointer, which would be confusing if a designer had changed its rotation or color, or if it was being used to give the accessible name to a "play" button in a multimedia player.

    Emoticons pre-date emojis, are still used but are much less popular than they once were. Emoticons use ASCII characters to create facial expressions and other ways to communicate an emotion. Because emoticons are made from many text characters, they can be confusing for screen reader users. When possible it is better simply to use a word like "smile" or a suitable emoji instead of an emoticon. If emoticons are used they should have a text alternative.

    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).

    +

    Examples

    diff --git a/techniques/html/H88.html b/techniques/html/H88.html index bb67b226f3..89fc224611 100644 --- a/techniques/html/H88.html +++ b/techniques/html/H88.html @@ -35,8 +35,8 @@

    Procedure

    For each HTML page:

    1. Check that the page uses only elements, attributes, and attribute values that are defined in the specification.
    2. -
    3. Check that elements, attributes, and values are used in the manner prescribed by the relevant specification.
    4. -
    5. Check that the page can be parsed correctly, according to the rules of the relevant specification.
    6. +
    7. Check that elements, attributes, and values are used in the manner prescribed by the specification.
    8. +
    9. Check that the page can be parsed correctly, according to the rules of the specification.

    Check #1 and #3 are most easily checked with page validation tools. Check #2 can be checked with the assistance of heuristic evaluation tools though manual judgment is usually required.

    @@ -53,11 +53,9 @@

    Expected Results

    Related Techniques

    -
    -
    -

    Resources

    -

    Refer to the resources section of Validating Web pages.

    -
    - - +

    Resources

    + +

    Refer to the resources section of Validating Web + pages.

    + +
    \ No newline at end of file diff --git a/techniques/html/H98.html b/techniques/html/H98.html index 5f2e7efe6a..d6e33330a2 100644 --- a/techniques/html/H98.html +++ b/techniques/html/H98.html @@ -20,9 +20,12 @@

    Description

    The objective of this technique is to programmatically link a pre-defined and published taxonomic term to the input, so that the inputs can also be machine-interpreted. This way the input will always have a common, referable and identifiable value associated to it, no matter what language is used, or what visible on-screen term is used to label the input. Then it can be further customized or otherwise machine-manipulated to help users.

    The technique works by adding the appropriate autocomplete token to each form field on the form to make the identified inputs Programmatically Determinable. This will help people with cognitive disabilities who may not immediately know the purpose of the field because the label used by the author is not familiar to them. When inputs have been programmatically assigned, third party plugins and software can manipulate these form fields to make them more accessible to people with cognitive disabilities. For instance, a plugin could detect an autocomplete token with the text string "tel" and insert a telephone icon. It will further enable third party software to swap out the existing labels for text labels that the user finds more familiar. For instance, it could change "Given Name" to "First Name".

    The autocomplete attribute also improves the browser's ability to pre-populate form fields with user-preferred values. When the input has been properly "tagged" with the known token value, the value entered by the user is stored locally on the host machine and associated with the token value for reuse. It helps those with dexterity disabilities who have trouble typing, those who may need more time, and anyone who wishes to reduce effort to fill out a form.

    -

    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.

    + +

    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.

    -

    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 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.

    Security considerations

    Organizations can be concerned about allowing input fields to be automatically filled-in. There is sometimes confusion about how browsers save information and the security implications.