Skip to content

Commit d2fe867

Browse files
ok7saithePunderWoman
authored andcommitted
docs: update aria overview page
1 parent 7e5fca2 commit d2fe867

1 file changed

Lines changed: 27 additions & 6 deletions

File tree

adev/src/content/guide/aria/overview.md

Lines changed: 27 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,31 @@ npm install @angular/aria
1717

1818
For example, let's take a toolbar menu. While it may appear to be a "simple" row of buttons tied with specific logic, keyboard navigation and screen readers add a lot of unexpected complexity to those unfamiliar with accessibility.
1919

20-
```
21-
<!------------------------------------->
22-
<!-- INSERT EMBEDDED DEMO OF TOOLBAR -->
23-
<!------------------------------------->
24-
```
20+
<docs-tab-group>
21+
<docs-tab label="Basic">
22+
<docs-code-multifile preview hideCode path="adev/src/content/examples/aria/toolbar/src/basic/app/app.ts">
23+
<docs-code header="app.ts" path="adev/src/content/examples/aria/toolbar/src/basic/app/app.ts"/>
24+
<docs-code header="app.html" path="adev/src/content/examples/aria/toolbar/src/basic/app/app.html"/>
25+
<docs-code header="app.css" path="adev/src/content/examples/aria/toolbar/src/basic/app/app.css"/>
26+
</docs-code-multifile>
27+
</docs-tab>
28+
29+
<docs-tab label="Material">
30+
<docs-code-multifile preview hideCode path="adev/src/content/examples/aria/toolbar/src/basic/material/app/app.ts">
31+
<docs-code header="app.ts" path="adev/src/content/examples/aria/toolbar/src/basic/material/app/app.ts"/>
32+
<docs-code header="app.html" path="adev/src/content/examples/aria/toolbar/src/basic/material/app/app.html"/>
33+
<docs-code header="app.css" path="adev/src/content/examples/aria/toolbar/src/basic/material/app/app.css"/>
34+
</docs-code-multifile>
35+
</docs-tab>
36+
37+
<docs-tab label="Retro">
38+
<docs-code-multifile preview hideCode path="adev/src/content/examples/aria/toolbar/src/basic/retro/app/app.ts">
39+
<docs-code header="app.ts" path="adev/src/content/examples/aria/toolbar/src/basic/retro/app/app.ts"/>
40+
<docs-code header="app.html" path="adev/src/content/examples/aria/toolbar/src/basic/retro/app/app.html"/>
41+
<docs-code header="app.css" path="adev/src/content/examples/aria/toolbar/src/basic/retro/app/app.css"/>
42+
</docs-code-multifile>
43+
</docs-tab>
44+
</docs-tab-group>
2545

2646
In this one scenario, developers need to consider:
2747

@@ -42,6 +62,7 @@ Angular Aria includes directives for common interactive patterns:
4262
| [Grid](guide/aria/grid) | Two-dimensional data display with cell-by-cell keyboard navigation |
4363
| [Listbox](guide/aria/listbox) | Single or multi-select option lists with keyboard navigation |
4464
| [Menu](guide/aria/menu) | Dropdown menus with nested submenus and keyboard shortcuts |
65+
| [Menubar](guide/aria/menubar) | Horizontal navigation bar for persistent application menus. |
4566
| [Multiselect](guide/aria/multiselect) | Multiple-selection dropdown pattern with compact display |
4667
| [Select](guide/aria/select) | Single-selection dropdown pattern with keyboard navigation |
4768
| [Tabs](guide/aria/tabs) | Tabbed interfaces with automatic or manual activation modes |
@@ -63,7 +84,7 @@ Angular Aria works well when you need accessible interactive components that are
6384
Angular Aria might not fit every scenario:
6485

6586
- **Pre-styled components** - If you need components that look complete without custom styling, use Angular Material instead
66-
- **Simple forms** - Native HTML form controls like <button> and <input type="radio"> provide built-in accessibility for straightforward use cases
87+
- **Simple forms** - Native HTML form controls like `<button>` and `<input type="radio">` provide built-in accessibility for straightforward use cases
6788
- **Rapid prototyping** - When validating concepts quickly, pre-styled component libraries reduce initial development time
6889

6990
## Next steps

0 commit comments

Comments
 (0)