@progress/wct-a11y-spec
Version:
Contains accessibility and keyboard navigation specification of Telerik and Kendo web components.
56 lines (36 loc) • 2.18 kB
Markdown
## Managing the Focus
Focusable elements in the Smart Box are part of the page tabsequence. Those are:
- `.k-smart-box .k-input-inner` (the main input field);
- all `.k-input-suffix button` elements (microphone, send button);
## Keyboard Shortcuts
This section lists the keyboard shortcuts supported by the Smart Box component.
### Button Component
[Button specification]({{button_kb_link}})
### Speech-to-Text Button Component
[Speech-to-Text Button specification]({{speechtotextbutton_kb_link}})
### List Component
[List specification]({{list_kb_link}})
## Keyboard Shortcuts applicable to the `.k-smart-box .k-input-inner` element
| Shortcut | Behavior |
| -------- | -------- |
| `Down Arrow` | Opens the suggestion popup if closed, or moves focus to the next suggestion in the list. |
| `Up Arrow` | Opens the suggestion popup if closed, or moves focus to the previous suggestion in the list. |
| `Enter` / `Return` | Selects the currently highlighted suggestion (if any) and submits the input. |
| `Escape` | Closes the suggestion popup if open, or clears the input field. |
| `Home` | When the popup is open, moves focus to the first suggestion in the list. |
| `End` | When the popup is open, moves focus to the last suggestion in the list. |
| `Alt + Down Arrow` | Opens the suggestion popup (alternative method). |
| `Alt + Up Arrow` | Closes the suggestion popup (alternative method). |
## Keyboard Shortcuts applicable to the `.k-input-suffix button` elements
| Shortcut | Behavior |
| -------- | -------- |
| `Enter` / `Space` | Triggers a click action on the button (e.g., start voice input, send input, stop processing). |
## Keyboard Shortcuts applicable to suggestion list items (`.k-list-item`)
| Shortcut | Behavior |
| -------- | -------- |
| `Down Arrow` | Moves focus to the next suggestion in the list. |
| `Up Arrow` | Moves focus to the previous suggestion in the list. |
| `Home` | Moves focus to the first suggestion in the list. |
| `End` | Moves focus to the last suggestion in the list. |
| `Enter` | Selects the focused suggestion and closes the popup. |
| `Escape` | Closes the popup and returns focus to the input field. |