Toolbar: add allowKeyboardNavigation and update KBN article#8976
Merged
Conversation
There was a problem hiding this comment.
Pull request overview
This PR documents the new dxToolbar option allowKeyboardNavigation and updates the Toolbar accessibility guidance to reflect the keyboard interaction model when this option is enabled.
Changes:
- Added an API reference page for
dxToolbar.Options.allowKeyboardNavigation. - Updated the Toolbar “Keyboard Navigation” article with revised key behaviors and a prerequisite link to the option.
- Extended
metadata/syntax-data.jsonwith the Vue kebab-case mapping forallowKeyboardNavigation.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| metadata/syntax-data.json | Adds the Vue attribute mapping for dxToolbarOptions.allowKeyboardNavigation. |
| concepts/05 UI Components/Toolbar/05 Accessibility/15 Keyboard Navigation.md | Updates the keyboard navigation documentation and references allowKeyboardNavigation. |
| api-reference/10 UI Components/dxToolbar/1 Configuration/allowKeyboardNavigation.md | Introduces the API reference entry describing the option’s behavior and default. |
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
pharret31
reviewed
Jul 13, 2026
….com/DevExpress/devextreme-documentation into feature/26_2_toolbar-kbn-improvement
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
EugeniyKiyashko
approved these changes
Jul 13, 2026
Abadzhev
reviewed
Jul 14, 2026
Co-authored-by: Vladimir Abadzhev <vladimira@devexpress.com> Co-authored-by: Vlada Skorokhodova <94827090+vladaskorohodova@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: dirkpieterse <dirk.pieterse@devexpress.com>
Comment on lines
+1
to
+24
| --- | ||
| id: dxToolbar.Options.allowKeyboardNavigation | ||
| type: Boolean | ||
| default: true | ||
| --- | ||
| --- | ||
| ##### shortDescription | ||
| Specifies whether users can navigate between Toolbar items using standard keyboard shortcuts. | ||
|
|
||
| --- | ||
| When this property is set to `true`, the Toolbar enables keyboard shortcuts that match [WAI-ARIA Authoring Practices (APG)](https://www.w3.org/WAI/ARIA/apg/patterns/toolbar/) recommendations. Users can move focus between available items with the arrow keys and the `Home` and `End` keys. The `Tab` and `Shift+Tab` keys move focus into and out of the Toolbar. | ||
|
|
||
| ##### shortDescription | ||
|
|
||
| Specifies whether users can navigate between Toolbar items using standard keyboard shortcuts. | ||
|
|
||
|
|
||
|
|
||
| --- | ||
|
|
||
| When this property is set to `true`, the Toolbar enables keyboard shortcuts that match [WAI-ARIA Authoring Practices (APG)](https://www.w3.org/WAI/ARIA/apg/patterns/toolbar/) recommendations. Users can move focus between available items with arrow keys and the `Home` and `End` keys. The `Tab` and `Shift+Tab` keys move focus into and out of the Toolbar. | ||
|
|
||
|
|
||
| When this property is set to `false`, the Toolbar does not process item-to-item keyboard shortcuts. Each focusable item participates in the page tab order according to its settings. |
| <tr> | ||
| <td>Shift + Tab</td> | ||
| <td>Moves focus to the previous toolbar item.</td> | ||
| <td>If a Toolbar receives focus, it focuses its last available item.</td> |
| <tr> | ||
| <td>Tab</td> | ||
| <td>Moves focus to the next toolbar item.</td> | ||
| <td>If a Toolbar receives focus, it focuses its first available item.</td> |
| <tr> | ||
| <td>Shift + Tab</td> | ||
| <td>Moves focus to the previous toolbar item.</td> | ||
| <td>If a Toolbar receives focus, it focuses its last available item.</td> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.