[]
SpreadJS allows you to navigate through a selected range using common hotkeys such as Tab/Shift+Tab for left and right focus, as well as Enter/Shift+Enter for up and down focus.
The following table depicts the cursor movement in the selected region while using keyboard keys:
Key | Description | Scenario |
---|---|---|
Tab | Focus moves towards the right cell in the current selection. | |
Focus moves from the last column to the first cell of the next row within the selection. | ||
Focus moves from the last cell to the first cell in the current selection. | ||
In the case of spans, if the span is next to the selected cell of the same row, the focus moves to span, otherwise, the focus moves to the next cell after span. | ||
In the case of multiple selections, the focus moves from the last cell of the first selection to the first cell of the next selection. | ||
Shift + Tab | Focus moves towards the left cell in the selection. | |
Focus moves from the first column to the last cell of the previous row within the selection. | ||
Focus moves from the first cell to the last cell in the current selection. | ||
In the case of spans, if the span is before the selected cell of the same row, the focus moves to span, otherwise, the focus moves to the cell before span. | ||
In the case of multiple selections, the focus moves from the first cell of the second selection to the last cell of the first selection. | ||
Enter | Focus moves downwards in the selection. | |
Focus moves from the last cell of the previous column to the first cell of the next column within the selection. | ||
Focus moves from the last cell to the first cell in the current selection. | ||
In the case of spans, if the span is next to the selected cell of the same column, the focus moves to the span, otherwise, the focus moves to the next cell after the span. | ||
In the case of multiple selections, the focus moves from the last cell of the first selection to the first cell of the next selection. | ||
Shift + Enter | Focus moves upwards in selection. | |
Focus moves from the first cell of the column to the last cell of the previous column within the selection. | ||
Focus moves from the first cell to the last cell in the current selection. | ||
In the case of spans, if the span is before the selected cell of the same column, the focus moves to span, otherwise, the focus moves to the next cell before span. | ||
In the case of multiple selections, the focus moves from the first cell of the second selection to the last cell of the first selection. |
Note: Use the register method to change navigation keys and it’s corresponding actions. For more information, see Input Mapping.