From 4952511733412bc30d900ca2833f439e43b8d959 Mon Sep 17 00:00:00 2001 From: Momdo Nakamura Date: Sat, 27 Jul 2024 13:30:39 +0900 Subject: [PATCH] Fix mentions to HTML to Platform Accessibility APIs Implementation Guide --- techniques/aria/ARIA5.html | 3 --- techniques/aria/ARIA6.html | 4 ++-- techniques/aria/ARIA8.html | 2 +- techniques/aria/ARIA9.html | 4 ++-- techniques/failures/F65.html | 3 --- 5 files changed, 5 insertions(+), 11 deletions(-) diff --git a/techniques/aria/ARIA5.html b/techniques/aria/ARIA5.html index d79b673cde..706d9249f4 100644 --- a/techniques/aria/ARIA5.html +++ b/techniques/aria/ARIA5.html @@ -85,9 +85,6 @@

A slider

  • Accessible Rich Internet Applications (WAI-ARIA), Supported States and Properties
    • -
  • - HTML to Platform Accessibility APIs Implementation Guide: HTML Element to Accessibility API Role Mapping Matrix -
  • WAI-ARIA Authoring Practices Guide
    • diff --git a/techniques/aria/ARIA6.html b/techniques/aria/ARIA6.html index 929da3a2b4..dde82edf76 100644 --- a/techniques/aria/ARIA6.html +++ b/techniques/aria/ARIA6.html @@ -2,7 +2,7 @@

    Technologies that support Accessible Rich Internet Applications (WAI-ARIA).

    Description

    The purpose of this technique is to provide a label for objects that can be read by assistive technology. The aria-label attribute provides the text label for an object, such as a button. When a screen reader encounters the object, the aria-label text is read so that the user will know what it is.

    -

    Authors should be aware that aria-label may be disregarded by assistive technologies in situations where aria-labelledby is used for the same object. For more information on the naming hierarchy please consult the ARIA specification and the accessible name and description calculation in the HTML to Platform Accessibility APIs Implementation Guide. Authors should be aware that use of aria-label will override any native naming such as alt on images or label associated with a form field using the for attribute.

    +

    Authors should be aware that aria-label may be disregarded by assistive technologies in situations where aria-labelledby is used for the same object. For more information on the naming hierarchy please consult the ARIA specification and the Accessible Name and Description Computation in the HTML Accessibility API Mappings 1.0. Authors should be aware that use of aria-label will override any native naming such as alt on images or label associated with a form field using the for attribute.

    Examples

    Distinguishing navigation landmarks

    @@ -64,7 +64,7 @@

    Providing a label for Math

    Description

    The objective of this technique is to describe the purpose of a link using the aria-label attribute. The aria-label attribute provides a way to place a descriptive text label on an object, such as a link, when there are no elements visible on the page that describe the object. If descriptive elements are visible on the page, the aria-labelledby attribute should be used instead of aria-label. Providing a descriptive text label lets a user distinguish the link from links in the Web page that lead to other destinations and helps the user determine whether to follow the link. In some assistive technologies the aria-label value will show in the list of links instead of the actual link text.

    -

    Per the Accessible Name and Description Computation and the HTML to Platform Accessibility APIs Implementation Guide, the aria-label text will override the text supplied within the link. As such the text supplied will be used instead of the link text by assistive technology. Due to this it is recommended to start the text used in aria-label with the text used within the link. This will allow consistent communication between users.

    +

    Per the Accessible Name and Description Computation and the Accessible Name and Description Computation in the HTML Accessibility API Mappings 1.0, the aria-label text will override the text supplied within the link. As such the text supplied will be used instead of the link text by assistive technology. Due to this it is recommended to start the text used in aria-label with the text used within the link. This will allow consistent communication between users.

    Examples

    Describing the purpose of a link in HTML using aria-label.

    diff --git a/techniques/aria/ARIA9.html b/techniques/aria/ARIA9.html index 1ee130cbcb..8e4c42601f 100644 --- a/techniques/aria/ARIA9.html +++ b/techniques/aria/ARIA9.html @@ -7,14 +7,14 @@

    The concatenation of strings can be useful for different reasons. In example 1, an input is nested within the context of a full sentence. The desired screen reader output is "Extend time-out to [ 20 ] minutes - edit with autocomplete, selected 20". Since the id of the text input is included in the string of ids referenced by aria-labelledby, the value of the input is included in the concatenated name at the right position.

    Another application of aria-labelledby is when there is no space to provide a visible label next to the input, or when using native labels would create unnecessary redundancy. Here, the use aria-labelledby makes it possible to associate visible elements on the page as name for such inputs. This is demonstrated in example 2 where table column and row headings are concatenated into names for the text input elements inside the table.

    -

    The ARIA accessible name and description calculation specifies that the string specified in aria-labelledby should replace rather than add to the content of the element that carries the property. So adding the aria-labelledby property to a native label should replace the text content inside that label unless the label itself is referenced as part of the sequence of ids in aria-labelledby.

    +

    The Accessible Name and Description Computation specifies that the string specified in aria-labelledby should replace rather than add to the content of the element that carries the property. So adding the aria-labelledby property to a native label should replace the text content inside that label unless the label itself is referenced as part of the sequence of ids in aria-labelledby.

    Examples

    A time-out input field with concatenated name

    A text input allows users to extend the default time before a time-out occurs.

    -

    The string "Extend time-out to" is contained in a native label element and is associated with the input with the input by id="timeout-duration" . This label is associated with this input using the for/id association only on user agents that don't support ARIA. On user agents that support ARIA, the for/id association is ignored and the name for the input is provided only by aria-labelledby, per the accessible name and description calculation in the HTML to Platform Accessibility APIs Implementation Guide.

    +

    The string "Extend time-out to" is contained in a native label element and is associated with the input with the input by id="timeout-duration" . This label is associated with this input using the for/id association only on user agents that don't support ARIA. On user agents that support ARIA, the for/id association is ignored and the name for the input is provided only by aria-labelledby, per the Accessible Name and Description Computation in the HTML Accessibility API Mappings 1.0.

    The aria-labelledby attribute on the text input references three elements: (1) the span containing the native label, (2) the text input containing the default text '20' (recall that this input is not labelled with the for/id associated label text), and (3) the string 'minutes' contained in a span. These elements should be concatenated to provide the full name for the text input

    <div>
   <span id="timeout-label">
diff --git a/techniques/failures/F65.html b/techniques/failures/F65.html
index 4732d30257..1979795151 100644
--- a/techniques/failures/F65.html
+++ b/techniques/failures/F65.html
@@ -36,9 +36,6 @@ 
    Missing text alternative

    Resources