Note: Changing the shortcuts used for accessing RadGrid can tally with browser shortcuts which have higher priority.
The keyboard navigation feature of Telerik RadTreeList allows you to:
Focus the treelist through a user-specified key combination
- Up/Down - navigate through the treelist records
- Page Up/Page Down - advance/return the pager
- Left Arrow + Right Arrow - Expand/Collapse child items
- Space - select treelist items
- Ctrl + Shift - select multiple treelist items
- Ctrl + I - insert a new item
- Enter - edit rows
- Enter - update/insert rows
- Esc - exit EDIT/INSERT mode
To enable this feature you have to set the ClientSettings -> AllowKeyboardNavigation property of the treelist to true
(it's default value is false).
To specify the key combination that focuses the treelist you need to set the ClientSettings -> KeyboardNavigationSettings -> FocusKey - the first key is preset to
CTRL by design.
The ClientSettings -> KeyboardNavigationSettings -> InitInsertKey propertie is used to provide shortcuts for opening RadTreeList insert form.
The default values is Ctrl + I where the first key is preset to Ctrl by design.
The ClientSettings -> KeyboardNavigationSettings -> ExpandChildItemsKey and ClientSettings -> KeyboardNavigationSettings -> CollapseChildItemsKey properties are used
to provide shortcuts for expanding or collapsing the active row's child items. The default values are
Left Arrow Key + Right Arrow Key. Upon changing these values, you will need to
hold Shift down for the new keys to take effect.
To enable the Update/Insert rows by hitting the Enter key feature you have to set the KeyboardNavigationSettings -> AllowSubmitOnEnter
property to True. Also to enable the validation when AllowSubmitOnEnter is set to True you have to set the ValidationSettings ->
EnableValidation to True and specify which command needs validation through CommandsToValidate property:
To validate a secific validation group you have to set the ValidationSettings -> ValidationGroup property to the name of the group:
To allow the active row to cycle to the beginning upon having reached the end of the treelist table, you have to set ClientSettings -> KeyboardNavigationSettings
-> AllowActiveRowCycle property to true.
The keyboard navigation is especially useful when you do not want your user to be dependand on mouse clicks when interacting with the control. It is designed in par with the Section 508 accessibility standards.