Skip to content

Commit f1b9522

Browse files
Update index.md
1 parent 7999fa3 commit f1b9522

1 file changed

Lines changed: 19 additions & 19 deletions

File tree

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

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

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -31,36 +31,36 @@ Begin with semantic HTML to establish meaning, implement the user-facing functio
3131
Use ARIA (e.g., `aria-describedby`, `aria-live`) only when needed to associate instructions or announce dynamic error messages.
3232

3333

34-
<details><summary>Example: Expand/Collapse Section (Accordion)</summary>
34+
??? Info "Example: Expand/Collapse Section (Accordion)"
3535

36-
A user expands or collapses a section to show or hide content.
36+
A user expands or collapses a section to show or hide content.
3737

38-
- **Structural Element**
39-
Use semantic elements such as `<button>` for the trigger and headings or sections to organize content.
38+
- **Structural Element**
39+
Use semantic elements such as `<button>` for the trigger and headings or sections to organize content.
40+
41+
- **Feature**
42+
Allow users to toggle visibility of content in a predictable and accessible way.
43+
44+
- **ARIA**
45+
Use `aria-expanded` and `aria-controls` to communicate the current state and relationship between the trigger and the content region.
4046

41-
- **Feature**
42-
Allow users to toggle visibility of content in a predictable and accessible way.
47+
Use the table below to explore individual patterns, understand their purpose, and learn how to implement them correctly to support accessible, standards-compliant experiences.
4348

44-
- **ARIA**
45-
Use `aria-expanded` and `aria-controls` to communicate the current state and relationship between the trigger and the content region.
4649

47-
Use the table below to explore individual patterns, understand their purpose, and learn how to implement them correctly to support accessible, standards-compliant experiences.
48-
</details>
4950

51+
??? Info "Example: Navigation with Skip Link"
5052

51-
<details><summary>Example: Navigation with Skip Link</summary>
53+
A user navigates a page and wants to skip repetitive navigation to reach the main content.
5254

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

55-
- **Structural Element**
56-
Use landmarks such as `<nav>` and `<main>` to define navigation and primary content areas.
58+
- **Feature**
59+
Provide a skip link that allows users to jump directly to the main content.
5760

58-
- **Feature**
59-
Provide a skip link that allows users to jump directly to the main content.
61+
- **ARIA**
62+
Use ARIA landmarks or labels only if needed to further clarify regions when multiple similar elements exist.
6063

61-
- **ARIA**
62-
Use ARIA landmarks or labels only if needed to further clarify regions when multiple similar elements exist.
63-
</details>
6464

6565
[INSERT TABLE]
6666

0 commit comments

Comments
 (0)