Skip to content

Toolbar: add allowKeyboardNavigation and update KBN article#8976

Merged
vladaskorohodova merged 11 commits into
mainfrom
feature/26_2_toolbar-kbn-improvement
Jul 16, 2026
Merged

Toolbar: add allowKeyboardNavigation and update KBN article#8976
vladaskorohodova merged 11 commits into
mainfrom
feature/26_2_toolbar-kbn-improvement

Conversation

@vladaskorohodova

Copy link
Copy Markdown
Collaborator

No description provided.

@vladaskorohodova vladaskorohodova self-assigned this Jul 13, 2026
Copilot AI review requested due to automatic review settings July 13, 2026 11:05

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.json with the Vue kebab-case mapping for allowKeyboardNavigation.

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.

Comment thread concepts/05 UI Components/Toolbar/05 Accessibility/15 Keyboard Navigation.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 13, 2026 11:08

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

Comment thread concepts/05 UI Components/Toolbar/05 Accessibility/15 Keyboard Navigation.md Outdated
Comment thread concepts/05 UI Components/Toolbar/05 Accessibility/15 Keyboard Navigation.md Outdated
Comment thread concepts/05 UI Components/Toolbar/05 Accessibility/15 Keyboard Navigation.md Outdated
Copilot AI review requested due to automatic review settings July 13, 2026 11:28

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

Comment thread concepts/05 UI Components/Toolbar/05 Accessibility/15 Keyboard Navigation.md Outdated
Comment thread concepts/05 UI Components/Toolbar/05 Accessibility/15 Keyboard Navigation.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 13, 2026 11:31

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

Comment thread concepts/05 UI Components/Toolbar/05 Accessibility/15 Keyboard Navigation.md Outdated
Comment thread concepts/05 UI Components/Toolbar/05 Accessibility/15 Keyboard Navigation.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 13, 2026 11:41

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

Comment thread concepts/05 UI Components/Toolbar/05 Accessibility/15 Keyboard Navigation.md Outdated
Comment thread concepts/05 UI Components/Toolbar/05 Accessibility/15 Keyboard Navigation.md Outdated
Comment thread concepts/05 UI Components/Toolbar/05 Accessibility/15 Keyboard Navigation.md Outdated
Co-authored-by: Vladimir Abadzhev <vladimira@devexpress.com>
Co-authored-by: Vlada Skorokhodova <94827090+vladaskorohodova@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 16, 2026 07:58

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 16, 2026 08:32

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

Comment thread concepts/05 UI Components/Toolbar/05 Accessibility/15 Keyboard Navigation.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: dirkpieterse <dirk.pieterse@devexpress.com>
Copilot AI review requested due to automatic review settings July 16, 2026 09:11

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

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>
Copilot AI review requested due to automatic review settings July 16, 2026 09:16

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

<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>
@vladaskorohodova
vladaskorohodova merged commit 58c7627 into main Jul 16, 2026
11 checks passed
@vladaskorohodova
vladaskorohodova deleted the feature/26_2_toolbar-kbn-improvement branch July 16, 2026 10:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants