Skip to content

Commit d0b226a

Browse files
committed
fix: Updated based on feedback from Kitty
1 parent c31473d commit d0b226a

File tree

3 files changed

+7
-404
lines changed

3 files changed

+7
-404
lines changed

demos/description-region/LICENSE

Lines changed: 0 additions & 201 deletions
This file was deleted.

demos/description-region/README.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## Project Description
44

5-
This application demonstrates how to enhance accessibility by setting the `aria-describedby` attribute for the map element. Additionally, it showcases the use of `aria-live` regions to provide dynamic updates for assistive technologies.
5+
This application demonstrates how to enhance accessibility by setting the `aria-describedby` attribute for the map element. Additionally, it showcases the use of `aria-live` regions to provide dynamic updates for assistive technologies. Note: Some assistive technologies such as [Narrator](https://a11ysupport.io/tech/aria/aria-describedby_attribute) may not support aria-describedby
66

77
## Testing `aria-describedby`
88

@@ -24,6 +24,10 @@ This application demonstrates how to enhance accessibility by setting the `aria-
2424

2525
The `aria-describedby` attribute is used to provide additional descriptive information for an element, which can be especially useful for users of assistive technologies. By linking the element to another element that contains the description, screen readers can convey more context and details to users, enhancing their understanding and interaction with the web content. This is particularly important for complex elements like maps, where visual information needs to be translated into meaningful text descriptions.
2626

27+
### Why Use `aria-describedby` Instead of `aria-label`
28+
29+
While both `aria-describedby` and `aria-label` are used to provide accessible descriptions, they serve different purposes. The `aria-label` attribute is used to provide a concise, accessible name for an element, which is typically short and to the point. In contrast, `aria-describedby` is used to link an element to another element that contains a more detailed description. This is particularly useful for complex elements like maps, where a brief label would not suffice to convey all necessary information. By using `aria-describedby`, we can provide users with assistive technologies a richer, more informative description that enhances their understanding and interaction with the map.
30+
2731
For more information on how to use `aria-describedby`, refer to the [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby).
2832

2933
## Understanding `aria-live`
@@ -36,7 +40,8 @@ When an element has the `aria-live` attribute, screen readers will monitor chang
3640

3741
- **off**: Default value. Updates are not announced.
3842
- **polite**: Updates are announced at the next available opportunity, allowing the user to finish their current task without interruption.
39-
- **assertive**: Updates are announced immediately, interrupting the current task. This should be used sparingly and only for critical updates.
43+
-- **assertive**: Updates are announced immediately, interrupting the current task. This should be used sparingly and only for critical updates.
44+
+- **assertive**: Updates are announced immediately, interrupting the current task. **This should be used sparingly and only for critical updates.**
4045

4146
### When to Use `aria-live`
4247

0 commit comments

Comments
 (0)