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 @@
Technologies that support Accessible Rich Internet Applications (WAI-ARIA).
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.
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 id
s 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 id
s 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 id
s in aria-labelledby
.
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