[]
        
(Showing Draft Content)

Selection Navigation

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.

tab-normal.gif


Focus moves from the last column to the first cell of the next row within the selection.

tab-last.gif


Focus moves from the last cell to the first cell in the current selection.

tab-lastrow.gif


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.

tab-span.gif


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.

tab-multipleselection.gif

Shift + Tab

Focus moves towards the left cell in the selection.

tabshift-normal.gif


Focus moves from the first column to the last cell of the previous row within the selection.

tabshift-firstlast.gif


Focus moves from the first cell to the last cell in the current selection.

tabshift-firstcolfirstrow.gif


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.

tabshift-span.gif


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.

tabshift-multipleselection.gif

Enter

Focus moves downwards in the selection.

enter-normal.gif


Focus moves from the last cell of the previous column to the first cell of the next column within the selection.

enter-lastfirst.gif


Focus moves from the last cell to the first cell in the current selection.

enter-lastcollastrow.gif


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.

enter-span.gif


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.

enter-multipleselection.gif

Shift + Enter

Focus moves upwards in selection.

shiftenter-normal.gif


Focus moves from the first cell of the column to the last cell of the previous column within the selection.

shiftenter-firstcolfirstrow.gif


Focus moves from the first cell to the last cell in the current selection.

shiftenter-lastrow.gif


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.

shiftenter-span.gif


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.

shiftenter-multipleselection.gif

Note: Use the register method to change navigation keys and it’s corresponding actions. For more information, see Input Mapping.