Keyboard Support in Blazor Ribbon
- 5 minutes to read
Keyboard shortcuts allow users to move through Ribbon tabs, items, and drop-down menus and execute any command. Keyboard navigation is implemented on the client and works seamlessly even in Blazor Server apps with a slow connection.
Note
Keyboard support allows users to interact with application content in cases they cannot use a mouse or they rely on assistive technologies (like screen readers or switch devices). Refer to the Accessibility help topic for information on other accessibility areas that we address.
Available shortcuts depend on the focused Ribbon element.
Tab
The following shortcut keys are available when a Ribbon tab is focused:
| PC/Windows Shortcuts | Mac Shortcuts | Description |
|---|---|---|
| Tab | Tab | Moves focus to the first enabled item in the tab’s content area. |
| Shift + Tab | Shift + Tab | Moves focus to the application tab (if present) or to the previous focusable element outside the Ribbon. |
| Right Arrow, Left Arrow | Right Arrow, Left Arrow | Moves focus to the next or previous tab (except for the application tab). |
Application Tab
The following shortcut keys are available when a Ribbon application tab is focused:
| PC/Windows Shortcuts | Mac Shortcuts | Description |
|---|---|---|
| Tab | Tab | Moves focus to the active Ribbon tab header. |
| Shift + Tab | Shift + Tab | Moves focus to the previous focusable element outside the Ribbon. |
| Enter, Space, Alt + Down Arrow | Enter, Space, Option + Down Arrow | Opens the application tab menu and moves focus to its first item. |
| Enter, Space | Enter, Space | When the application tab menu or submenu is opened: Clicks the focused menu item. |
| Down Arrow, Up Arrow | Down Arrow, Up Arrow | When the application tab menu or submenu is opened: Moves focus to the next/previous menu item. |
| Right Arrow | Right Arrow | For a submenu item: Opens the submenu and moves focus to the first item. |
| Down Arrow, Up Arrow | Down Arrow, Up Arrow | When a menu or submenu is opened: Moves focus to the next/previous menu item. |
| Home, End | Fn+Left Arrow, Fn+Right Arrow | When a menu or submenu is opened: Moves focus to the first/last menu item. |
| Alt + Up Arrow | Option + Up Arrow | When a menu is opened: Closes the application tab menu and moves focus to the application tab. |
| Esc, Left Arrow | Esc, Left Arrow | When a submenu is opened: Closes the submenu and moves focus to its parent menu item. |
Item
Available shortcuts depend on the focused Ribbon item type.
Common Shortcuts
| PC/Windows Shortcuts | Mac Shortcuts | Description |
|---|---|---|
| Tab | Tab | Moves focus to the next focusable element outside the Ribbon. |
| Shift + Tab | Shift + Tab | Moves focus back to the active Ribbon tab header. |
| Right Arrow, Left Arrow | Right Arrow, Left Arrow | Moves focus to the next/previous Ribbon item. Each part of a split drop-down button counts as a separate item. |
| Home | Fn+Left Arrow | Moves focus to the first enabled item in the current tab. |
| End | Fn+Right Arrow | Moves focus to the last enabled item in the current tab. |
Button & Menu
| PC/Windows Shortcuts | Mac Shortcuts | Description |
|---|---|---|
| Enter, Space | Enter, Space | Clicks the focused button or selects/clears the toggle button. For a drop-down item: Opens a drop-down menu and moves focus to its first item. |
| Alt + Down Arrow | Option + Down Arrow | Opens a drop-down menu and moves focus to its first item. |
| Right Arrow | Right Arrow | Opens the submenu and moves focus to the first item. |
| Left Arrow | Left Arrow | For nested drop-down menu items: Navigates back to the parent level and moves focus to the parent item. In modal windows, for main drop-down menu items with child items: Opens a submenu and moves focus to its last item. |
| Down Arrow, Up Arrow | Down Arrow, Up Arrow | When a menu or submenu is opened: Moves focus to the next/previous menu item. |
| Home, End | Fn+Left Arrow, Fn+Right Arrow | When a menu or submenu is opened: Moves focus to the first/last menu item. |
| Alt + Up Arrow | Option + Up Arrow | When a menu or submenu is opened: Closes the drop-down menu and moves focus to the corresponding Ribbon item. |
| Esc | Esc | When a submenu is opened: Closes the submenu and moves focus to its parent menu item. |
Color Palette Drop-Down
| PC/Windows Shortcuts | Mac Shortcuts | Description |
|---|---|---|
| Enter, Space | Enter, Space | Selects the focused color and closes the color palette drop-down. |
| Right Arrow, Left Arrow | Right Arrow, Left Arrow | Moves focus to the next/previous color swatch. |
| Down Arrow, Up Arrow | Down Arrow, Up Arrow | Moves focus to the next/previous color palette row. |
| Tab, Shift + Tab | Tab, Shift + Tab | Moves focus to the first item in the next/previous color group. |
| Esc | Esc | Closes the color palette drop-down. |
Combo Box
| PC/Windows Shortcuts | Mac Shortcuts | Description |
|---|---|---|
| Enter | Enter | Moves focus to the input field. |
| Esc | Esc | Moves focus back to the parent element (Ribbon tab or drop-down menu). |
| Alt + Down Arrow | Option + Down Arrow | When an input field is focused: Opens a drop-down list and moves focus to its first value. |
| Enter | Enter | For an editable combo box: Updates the EditText value and fires the EditTextChanged event. |
| Down Arrow, Up Arrow | Down Arrow, Up Arrow | When a drop-down list is opened: Moves focus to the next/previous value. |
| Page Down, Page Up | Fn+Down Arrow, Fn+Up Arrow | When a drop-down list is opened: Moves focus to a value on the next/previous page. |
| Enter | Enter | When a drop-down list is opened: Selects the focused value and closes the combo box drop-down. |
| Esc, Alt + Up Arrow | Esc, Option + Up Arrow | When a drop-down list is opened: Closes the drop-down and moves focus back to the combo box. |
Spin Editor
| PC/Windows Shortcuts | Mac Shortcuts | Description |
|---|---|---|
| Enter | Enter | Moves focus to the input field. |
| Esc | Esc | Moves focus back to the parent element (Ribbon tab or drop-down menu). |
| Down Arrow, Up Arrow | Down Arrow, Up Arrow | When an input field is focused: Increases/decreases the value by the specified increment. |