Skip to content

Commit c187729

Browse files
Update index.md
1 parent 6e529fa commit c187729

1 file changed

Lines changed: 28 additions & 0 deletions

File tree

  • docs/getting-started/accessibility-patterns-index

docs/getting-started/accessibility-patterns-index/index.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,9 +33,37 @@ A user enters information into a form field and receives feedback if there is an
3333
Use ARIA (e.g., `aria-describedby`, `aria-live`) only when needed to associate instructions or announce dynamic error messages.
3434
</details>
3535

36+
37+
<details><summary>Example: Expand/Collapse Section (Accordion)</summary>
38+
39+
A user expands or collapses a section to show or hide content.
40+
41+
- **Structural Element**
42+
Use semantic elements such as `<button>` for the trigger and headings or sections to organize content.
43+
44+
- **Feature**
45+
Allow users to toggle visibility of content in a predictable and accessible way.
46+
47+
- **ARIA**
48+
Use `aria-expanded` and `aria-controls` to communicate the current state and relationship between the trigger and the content region.
49+
3650
Use the table below to explore individual patterns, understand their purpose, and learn how to implement them correctly to support accessible, standards-compliant experiences.
51+
</details>
52+
53+
54+
<details><summary>Example: Navigation with Skip Link</summary>
3755

56+
A user navigates a page and wants to skip repetitive navigation to reach the main content.
57+
58+
- **Structural Element**
59+
Use landmarks such as `<nav>` and `<main>` to define navigation and primary content areas.
3860

61+
- **Feature**
62+
Provide a skip link that allows users to jump directly to the main content.
63+
64+
- **ARIA**
65+
Use ARIA landmarks or labels only if needed to further clarify regions when multiple similar elements exist.
66+
</details>
3967

4068
[INSERT TABLE]
4169

0 commit comments

Comments
 (0)