By default, the keyboard navigation of the TreeList is disabled.
For a complete example, refer to the demo on using the keyboard navigation of the TreeList.
The TreeList supports its keyboard navigation functionality through the
Navigatable() method. When enabled, you can initially select a row or cell and then move within the TreeList by using the
Arrow keys. The navigation occurs at a cell level regardless of what the
Selectable() mode is. To select the current row or cell, press
The following example demonstrates how to enable the key navigation in the TreeList.
@(Html.Kendo().TreeList<Kendo.Mvc.Examples.Models.TreeList.EmployeeDirectoryModel>() .Name("treelist") /* Other configuration. */ .Navigatable() )
The keyboard navigation of the TreeList works by listening to the
keydown events on the wrapper element of the helper. Its behavior is based on the assumption that whatever the user does is in accordance with the currently focused TreeList cell and not with the focused element of the browser. If the data cells of the TreeList contain hyperlinks that have to be activated through the keyboard:
- Navigate to the respective TreeList cell by using the
Enterto focus the hyperlink inside the cell.
To return the focus on the table cell, press
Esc. In order for the hyperlinks to be inaccessible through tabbing, set the
tabindex="-1" attribute to the custom hyperlinks.
You can also avoid the procedure and bypass the keyboard navigation of the TreeList, access the custom hyperlinks with tabbing, and activate them with
Enter. To achieve this, prevent the
keydown event bubbling of the custom hyperlinks. As a result, the
Enter key-presses will be unnoticed by the TreeList.