Keyboard Navigation
The keyboard navigation of the Diagram is always available and enabled by default.
For a complete example, refer to the demo on keyboard navigation of the Diagram.
The Diagram provides comprehensive keyboard navigation capabilities that allow users to interact with shapes, connections, and other diagram elements without using a mouse. You can disable keyboard navigation by setting the navigatable.disabled option to true.
The following example demonstrates how to disable the keyboard navigation in the Diagram.
$("#diagram").kendoDiagram({
navigatable: {
disabled: true
}
});
Focus and Navigation Shortcuts
The Diagram supports the following keyboard shortcuts for focusing and navigating between diagram elements.
| SHORTCUT | DESCRIPTION |
|---|---|
Tab | Focuses the diagram and the first shape. |
Shift & Tab | Focuses the previous element on the page. |
Right Arrow | Moves focus to the next shape or connection. |
Left Arrow | Moves focus to the previous shape or connection. |
Home | Moves focus to the first item in the diagram. |
End | Moves focus to the last item in the diagram. |
Selection Shortcuts
Use the following keyboard shortcuts to manage selection in the Diagram.
| SHORTCUT | DESCRIPTION |
|---|---|
Ctrl (or Cmd) & A | Selects all shapes and connections in the diagram. |
Escape | Deselects all selected items. |
Movement Shortcuts
The Diagram supports moving selected shapes using keyboard shortcuts. Movement is performed in small or large steps depending on the key combination.
Small Step Movement
| SHORTCUT | DESCRIPTION |
|---|---|
Ctrl (or Cmd) & Up | Moves the selected shapes up by a small step. |
Ctrl (or Cmd) & Down | Moves the selected shapes down by a small step. |
Ctrl (or Cmd) & Left | Moves the selected shapes left by a small step. |
Ctrl (or Cmd) & Right | Moves the selected shapes right by a small step. |
Large Step Movement
| SHORTCUT | DESCRIPTION |
|---|---|
Shift & Ctrl (or Cmd) & Up | Moves the selected shapes up by a large step. |
Shift & Ctrl (or Cmd) & Down | Moves the selected shapes down by a large step. |
Shift & Ctrl (or Cmd) & Left | Moves the selected shapes left by a large step. |
Shift & Ctrl (or Cmd) & Right | Moves the selected shapes right by a large step. |
Editing Shortcuts
The Diagram provides keyboard shortcuts for common editing operations.
| SHORTCUT | DESCRIPTION |
|---|---|
Ctrl (or Cmd) & C | Copies the selected shapes and connections. |
Ctrl (or Cmd) & X | Cuts the selected shapes and connections. |
Ctrl (or Cmd) & V | Pastes the previously copied or cut items. |
Ctrl (or Cmd) & D | Duplicates the selected shapes and connections. |
Delete | Deletes the selected shapes and connections. |
Action Shortcuts
Use the following keyboard shortcuts to perform diagram actions.
| SHORTCUT | DESCRIPTION |
|---|---|
Ctrl (or Cmd) & Z | Undoes the last action. |
Ctrl (or Cmd) & Y | Redoes the previously undone action. |
Ctrl (or Cmd) & L | Applies the configured layout to the diagram. |
Accessibility Configuration
The Diagram provides accessibility options for both the component itself and its connections through ARIA attributes.
Diagram Accessibility
Configure the accessibility attributes of the Diagram using the accessibility option.
$("#diagram").kendoDiagram({
accessibility: {
role: "application",
ariaRoleDescription: "Diagram",
ariaLabel: "Organization Chart"
}
});
Connection Accessibility
Configure accessibility attributes for connections using the connectionDefaults.accessibility option.
$("#diagram").kendoDiagram({
connectionDefaults: {
accessibility: {
ariaRoleDescription: "Connection",
ariaLabel: "Connection between shapes"
}
}
});
The ariaRoleDescription property sets the accessibility role description for connection elements, which defaults to "Connection". The ariaLabel property defines the accessibility label for connection elements.