This chapter includes the keystroke controls for Lightweight User Interface Extensions (LUX).
This section contains information on the breadcrumbs keystroke for LUX and OJET controls.
Target |
Key |
Action |
---|---|---|
Link Button |
Tab |
Set focus to the Link. |
|
Enter |
Activates the control. |
Menu Drop Down |
Tab |
Set focus to the DownArrow. |
|
UpArrow |
Moves focus to the previous visible list item. |
|
DownArrow |
Moves focus to the next visible list item. |
|
Esc |
Collapse the drop-down list. If the drop-down is already closed, do nothing. |
This section contains information on the grid (LUX) keystrokes.
This section contains information on the keyboard shortcuts for navigating in and out of the grid.
Action for keyboard |
Key(s) |
Notes |
---|---|---|
Move focus from the previous focusable element on the page (outside of the grid) to the grid |
(All) Tab |
Initially, the first cell in the first data row is focused and selected Once focus has been moved to the grid, subsequent tab presses that re-enter the grid shall return focus to the cell that last held focus. |
Enter the grid for navigation and editing |
(LUX) Any key besides Tab and Shift+Tab |
(LUX) Focus must be on the grid (LUX) Most keys other than the Enter key will enter the grid and also perform their normal action |
Move focus from the grid to the next focusable element on the page (outside of the grid) |
(All) Tab |
(LUX) The grid must be in the "escape mode" state |
Move focus from the next focusable element on the page (outside of the grid) to the grid |
(All) Shift+Tab |
Once focus has been moved to the grid, subsequent tab presses that re-enter the grid shall return focus to the cell that last held focus. |
Move focus from the grid to the previous focusable element on the page (outside of the grid) |
(All) Shift+Tab |
(LUX) The grid must be in the "escape mode" state |
Toggle the "escape mode" state of the grid |
(LUX) Escape |
(LUX) The selected cell must be in Navigation Mode |
This section contains information on the Keyboard shortcuts for navigation within the grid (includes a basic selection of cells and rows).
Action for keyboard |
Key(s) |
Notes for keyboard |
---|---|---|
Move focus one row up (and update cell and row selection) |
(All) Up Arrow |
(LUX) The newly focused cell also becomes selected, and any other selected cells are deselected (LUX) The row containing the newly focused cell becomes focused, selected, and initially selected, and any other selected rows are deselected. There is no wrap at the first or last rows (LUX) If the currently focused cell is in the first data row, the Up Arrow moves the focus to the column heading cell immediately above the currently focused cell (see Keyboard shortcuts for sorting on columns, below.) The first data row is no longer focused or selected, but the column heading row does not get selected or focused. Also, any previously selected cells are no longer selected, but the column heading cell does not get selected. Nevertheless, if the Down Arrow is then pressed, the first data row gets focused and selected, focused is moved to the cell immediately below the focused column heading cell, and the newly focused cell becomes selected. |
Move focus one row down (and update cell and row selection) |
(All) Down Arrow |
(LUX) The newly focused cell also becomes selected, and any other selected cells are deselected (LUX) The row containing the newly focused cell becomes focused, selected, and initially selected, and any other selected rows are deselected There is no wrap at the first or last rows (LUX) See Up Arrow for behavior in column heading row. |
Move focus one column to the left (and update cell and row selection) |
(All) Left Arrow -or- (LUX) Shift+Tab |
(LUX) If the grid is in the "escape mode" state, Shift+Tab moves focus to the previous focusable element in the page (outside of the grid) instead of taking any action within the grid (LUX) Wrap at the first or last column is controlled by the LUX Grid wrapSelection option. The default is to wrap. Wrapping is generally only within data rows, not column headers. (LUX) If wrapSelection is true: If the currently focused cell is the first cell in the header row, then Shift+Tab causes the grid to enter the "escape mode" state If the currently focused cell is the first cell in the first data row, then Shift+Tab moves focus one row up, to the first cell of the header row, similar to Up Arrow (LUX) If the currently focused cell is in editable mode, Shift+Tab causes the cell to exit editable mode and return to navigation mode If the editOnTab option is true, the newly focused cell enters editable mode |
Move focus one column to the right (and update cell and row selection) |
(All) Right Arrow -or- (LUX) Tab |
(LUX) If the grid is in the "escape mode" state, Tab moves focus to the next focusable element in the page (outside of the grid) instead of taking any action within the grid (LUX) Wrap at the first or last column is controlled by the LUX Grid wrapSelection option. The default is to wrap. Wrapping is only within data rows, not column headers. (LUX) If wrapSelection is true: If the currently focused cell is the last cell in the header row, then Tab moves focus to the first cell in the first data row (wraps) If the currently focused cell is the last cell in the last data row, then Tab causes the grid to enter the "escape mode" state (LUX) If the currently focused cell is in editable mode, Tab causes the cell to exit editable mode and return to navigation mode If the editOnTab option is true, the newly focused cell enters editable mode |
Move focus to the first cell in the current row (and update cell and row selection) |
(All) Home |
(LUX) Excludes the selector column, if present (LUX) If the currently selected cell is in the header row, moves focus to the first cell in the first data row |
Move focus to the last cell in the current row (and update cell and row selection) |
(All) End |
(LUX) If the currently selected cell is in the header row, moves focus to the last cell in the first data row |
Move focus to the first data cell in the grid (and update cell and row selection) |
(LUX) Control+Home |
(LUX) Excludes the selector column, if present |
Move focus to the last data cell in the grid (and update cell and row selection) |
(LUX) Control+End |
|
This section contains information on adjusting the row and cell selection.
Action for keyboard |
Key(s) |
Notes for keyboard |
---|---|---|
Adjust the range of selected cells and rows one row up |
(All) Shift+Up Arrow |
(LUX) The multiSelect option must be true; otherwise, this has the same behavior as Up Arrow without Shift (LUX) Moves cell focus one row up; the newly focused cell also becomes selected (LUX) The row containing the newly focused cell becomes focused and selected (LUX) Generally selects a range of cells and rows from the "initially selected" row to the newly focused row with the newly focused cell If the focused cell and focused row are moved without changing the selection, e.g., with Control+Up/Down Arrow, then this action generally selects a range of rows from the currently focused row to one row above it |
Adjust the range of selected cells and rows one row down |
(All) Shift+Down Arrow |
(LUX) The multiSelect option must be true; otherwise, this has the same behavior as Down Arrow without Shift (LUX) Moves cell focus one row down; the newly focused cell also becomes selected (LUX) The row containing the newly focused cell becomes focused and selected (LUX) Generally selects a range of cells and rows from the "initially selected" row to the newly focused row with the newly selected cell If the focused cell and focused row are moved without updating the selection, e.g., with Control+Up/Down Arrow, then this action generally selects a range of rows from the currently focused row to one row below it |
Move focus one column to the left (and update cell selection) |
(LUX) Shift+Left Arrow |
(LUX) Moves cell focus and selection(s) one column to the left (selection can be multiple cells if multiple rows are currently selected) (LUX) If the currently focused cell is the first cell of the row, then behaves the same as Left Arrow without Shift |
Move focus one column to the right (and update cell selection) |
(LUX) Shift+Right Arrow |
(LUX) Moves cell focus and selection(s) one column to the right (selection can be multiple cells if multiple rows are currently selected) (LUX) If the currently focused cell is the last cell of the row, then behaves the same as Right Arrow without Shift |
Move focus one row up (no change to selection) |
(All) Control+Up Arrow |
(LUX) The row containing the newly focused cell becomes focused (LUX) Note: Enables selection of non-contiguous rows with Control+Space (LUX) There is no wrap at the first or last rows (LUX) If the currently focused row is the first data row, this has the same behavior as Up Arrow without Shift |
Move focus one row down (no change to selection) |
(All) Control+Down Arrow |
(LUX) The row containing the newly focused cell becomes focused (LUX) Note: Enables selection of non-contiguous rows with Control+Space (LUX) There is no wrap at the first or last rows |
Select the current row |
(WAI-ARIA) Shift+Space (LUX) Control+Space |
(LUX) Toggles selection of currently focused row (LUX) The multiSelect option must be true; otherwise, this has the same behavior as Space without Control |
Select the current column |
(WAI-ARIA) Control+Space
|
(LUX) Not supported |
NOTE:
WAI-ARIA defines selection within grids solely in terms of cells; a row is just a set of cells, each of which may or may not be selected. The LUX Grid keyboard shortcuts for selection assume the multiSelect option is set to 'true'.
In the LUX Grid:
· If a cell is selected, the cell's row is selected.
· Only one cell in a row may be selected at any given time.
· If multiple rows are selected, their selected cells are always in the same column.
This section contains information on editing cells.
Cell mode before action |
Action |
Key(s) |
Cell mode after action |
Notes |
---|---|---|---|---|
Navigation |
Edit focused cell (enter Actionable mode) |
(All) Enter -or- F2 -or- (LUX) Shift+Enter -or- (WAI-ARIA (optional), LUX) Any alphanumeric character |
Editable |
(LUX) In a Text Column or Text Area Column cell, typing an alphanumeric character will also replace the current cell value with the character just typed (LUX) In a Number/Cost/Percent column cell, typing an alphanumeric character will also select the current cell value, if any; the character just typed is not entered in the cell |
Editable |
Cancel changes and exit Actionable mode |
(All) Escape |
Navigation |
(WAI-ARIA) Does not mention canceling changes, just exiting Actionable mode |
Editable |
Commit changes and exit Actionable mode |
(WAI-ARIA (optional), LUX) Enter -or- (LUX) Shift+Enter
|
Navigation |
(LUX) If the currently focused cell is not in the last data row of the Grid, Enter or Shift+Enter will also move focus to the cell immediately below the focused cell (note that Shift+Enter moves focus down such as Enter, not up) (LUX) In a Text Area Column cell, Enter does not exit the editor; it just adds a newline character to the text value at the current insertion point. Shift+Enter behaves such as a normal Enter or Shift+Enter, as if the cell were not a Text Area Column cell (LUX) In a Date Column or Select Multi Column cell, Enter and Shift+Enter do nothing |
Editable |
Move focus to next actionable (tabbable) item |
(All) Tab |
Old
cell: Navigation; |
(LUX) Next actionable item is usually in next cell (LUX) If the editOnTab option is true, the newly focused cell enters Actionable mode |
Editable |
Move focus to previous actionable (tabbable) item |
(All) Shift+Tab |
Old
cell: Navigation; |
(LUX) Previous actionable item is usually in previous cell (LUX) If the editOnTab option is true, the newly focused cell enters Actionable mode |
Editable |
Move to next row |
Enter |
Old
row: Navigation; |
(LUX) See LUX comments for "Commit changes and exit Actionable mode" |
Editable |
Select date in Date Column |
(LUX) See the OJET Input Date and Time Keyboard End User Information. |
See the OJET Input Date and Time Keyboard End User Information. |
|
Editable |
Increment Spinner Number Column cell |
Up Arrow |
Editable |
|
Editable |
Decrement Spinner Number Column cell |
Down Arrow |
Editable |
|
Navigation |
Toggle checked state of checkbox |
Space |
Navigation |
|
Navigation |
Clear data from the focused cell |
(LUX) Delete |
Navigation |
Delete key clears the values in select and check column cells as well |
This section contains information on Grouped Rows and Tree Grid.
Action |
Key(s) |
Notes |
---|---|---|
Expand [+] |
Control+Right Arrow |
Focus must be in the cell with the disclosure icon |
Collapse [-] |
Control+Left Arrow |
Focus must be in the cell with the disclosure icon |
This section contains information on keyboard shortcuts for triggering cell actions in other types of cells.
Action |
Key(s) |
Notes |
---|---|---|
Trigger cell action in selected cell |
Space |
If the cell has an <a> with a valid href attribute, Space will follow the link |
This section contains information on sorting on columns.
Action |
Key(s) |
Notes |
---|---|---|
Cycle the sort of the focused column in the following sequence: · Ascending · Descending · Not sorted (default order) |
Space |
The selected cell must be the column header cell |
Cycle the sort of the focused column, subject to any other column sorts that are already defined, in the sequence above |
Control+Space |
The selected cell must be the column header cell |
This section contains information on keyboard shortcuts for menus.
Action |
Key |
Notes |
---|---|---|
Open the menu |
(WAI-ARIA, LUX) Enter -or- Space -or- Shift+F10 -or- (WAI-ARIA) Up/DownArrow (in a menu bar)
|
(LUX) Context Menu uses Space or Shift+F10; Column Menu uses Space; Select Column Menu uses Up/DownArrow (space (or character) opens the menu item search/filter field); Select Multi-Column Menu uses Enter (LUX) In Select Column Menu, Enter causes the cell to enter Actionable mode, but does not open the drop-down menu; the menu opens when Up/DownArrow keys are used (LUX) In the Select Multi-Column Menu, after the cell enters Actionable mode, the first Control+DownArrow enters the menu at the (first) currently selected option (or before the first option if no option is currently selected) |
Move focus to the next menu item in the menu |
(All) DownArrow |
(LUX) Column Menus, Select Column menus, and Select Multi-Column menus wrap at the bottom; Context menus do not |
Move focus to the previous menu item in the menu |
(All) UpArrow |
(LUX) Column Menus, Select Column menus, and Select Multi-Column menus wrap at the top; Context menus do not |
Open a submenu (if the focused menu item has a sub-menu) |
(WAI-ARIA, LUX) RightArrow -or- (WAI-ARIA, LUX) Enter -or- Space |
(LUX) Does not apply to Select Column menus and Select Multi-Column menus (LUX) Context Menu uses RightArrow; Column Menu uses RightArrow, Enter, or Space. |
Close a submenu and return focus to the parent menu item |
(WAI-ARIA, LUX) LeftArrow -or- (WAI-ARIA) Escape |
(LUX) Does not apply to Select Column menus and Select Multi-Column menus (LUX) Escape closes the top-level menu and any submenus |
Select a menu item (or invoke the menu action) and close the menu |
(All) Enter -or- Space |
(LUX) Does not apply to the Select Multi-Column menu (LUX) Select Column does not support Space, only Enter; space (or character) opens the menu item search/filter field |
Toggle selection of a menu item in the menu |
(LUX) Enter -or- Space |
(LUX) Select Multi-Column menu only |
Close the menu (commit selections) |
(LUX) Tab -or- Shift-Tab |
(LUX) Select Multi Column menu only (LUX) Also moves focused cell one column to the right (Tab) or left (Shift+Tab) |
Close the menu (no action or selection) |
(LUX) Escape |
(LUX) Escape closes the top-level menu and any submenus |
This section contains information on the miscellaneous keystrokes.
Action |
Key |
Notes |
---|---|---|
Insert a new row above the selected row |
(LUX) Insert Key |
A new row is added just above the selected row |