Toolbar: add allowKeyboardNavigation and update KBN article#8976
Open
vladaskorohodova wants to merge 7 commits into
Open
Toolbar: add allowKeyboardNavigation and update KBN article#8976vladaskorohodova wants to merge 7 commits into
vladaskorohodova wants to merge 7 commits into
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
| --- | ||
| --- | ||
| ##### shortDescription | ||
| Specifies whether the Toolbar manages keyboard navigation between the items. |
Contributor
There was a problem hiding this comment.
"toolbar manages navigation" sounds a little vague. Suppose it doesn't manage navigation. But then maybe something else manages that navigation? We better specifically say what's available to end-users.
Suggested change
| Specifies whether the Toolbar manages keyboard navigation between the items. | |
| Specifies whether users navigate between Toolbar items using standard keyboard shortcuts. |
| Specifies whether the Toolbar manages keyboard navigation between the items. | ||
|
|
||
| --- | ||
| When this property is set to `true`, the Toolbar uses keyboard patterns 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. |
Contributor
There was a problem hiding this comment.
I'm not sure if "patterns" is part of some standard accessibility terminology. But I would say "shortcuts" instead to make it simpler for majority of readers.
Suggested change
| When this property is set to `true`, the Toolbar uses keyboard patterns 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 `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 `true`, the Toolbar uses keyboard patterns 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 movement, and each focusable item participates in the page tab order according to its settings. No newline at end of file |
Contributor
There was a problem hiding this comment.
Suggested change
| When this property is set to `false`, the Toolbar does not process item-to-item keyboard movement, and each focusable item participates in the page tab order according to its settings. | |
| 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>Moves focus to the last Toolbar item or to the previous focusable element before the Toolbar.</td> |
Contributor
There was a problem hiding this comment.
Suggested change
| <td>Moves focus to the last Toolbar item or to the previous focusable element before the Toolbar.</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.