10       Appendix C: LUX Controls

This chapter includes the keystroke controls for Lightweight User Interface Extensions (LUX).

LUX Breadcrumbs (oj-lux-breadcrumb)

This section contains information on the breadcrumbs keystroke for LUX and OJET controls.

Table 254: Breadcrumbs Keystroke

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.

LUX Grid (oj-lux-grid)

This section contains information on the grid (LUX) keystrokes.

Keyboard shortcuts for navigation in and out of the grid

This section contains information on the keyboard shortcuts for navigating in and out of the grid.

Table 255: 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

Keyboard Shortcuts for Navigation within the Grid (Includes Basic Selection of Cells and Rows)

This section contains information on the Keyboard shortcuts for navigation within the grid (includes a basic selection of cells and rows).

Table 256: Keyboard Shortcuts For Navigation within the Grid

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

 

Adjusting the Row and Cell Selection

This section contains information on adjusting the row and cell selection.

Table 257: 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.

Editing Cells

This section contains information on editing cells.

Table 258: 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;
New cell: Editable

(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;
New cell: Editable

(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;
New row: Editable

(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

Keyboard shortcuts for Grouped Rows and Tree Grid

This section contains information on Grouped Rows and Tree Grid.

Table 259: 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

Keyboard shortcuts for triggering cell actions in other types of cells

This section contains information on keyboard shortcuts for triggering cell actions in other types of cells.

Table 260: 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

Keyboard shortcuts for sorting on columns

This section contains information on sorting on columns.

Table 261: 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

Keyboard Shortcuts for Menus

This section contains information on keyboard shortcuts for menus.

Table 262: 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

Miscellaneous

This section contains information on the miscellaneous keystrokes.

Table 263: 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