TheonUI Keyboard Control

The TheonUI web browesr database user interface can be completely controlled by keyboard. Overloaded keys (where pressing the key has different actions depending on context, usually focus) are shown in bold.

General Keyboard Shortcuts

Control Key Combo Comments
Choose Desktop Alt+D Opens menu. Select a Desktop from the menu using CursorUp / CursorDown and open with Return. Use Esc to close the menu without opening a Desktop.
New Query Ctrl+Q
Edit Current Query Ctrl+U
Search Shift+Return
Try Search Return Except when a text area entry box is focused where it adds a new line as normal or when a dynamic drop-down is focused where it opens the menu.
Edit Ctrl+E
Save Changes Shift+Return
Cancel Esc
Choose Box (!InfoBox and !ToolBox) Ctrl+B Toggles between each.
Choose Panel Ctrl+1, Ctrl+2 ... Ctrl+0 Selects the first to the tenth panels on a desktop or browser.
Choose Pattern Ctrl+P Steps through each Pattern type.
Invert Match Ctrl+I Toggles state.
Choose Order Ctrl+O Steps through each Order type.
Lock Value Ctrl+L Toggles state.
Lookup Return Except when a text area entry box is focused where it adds a new line as normal or when a dynamic drop-down is focused where it opens the menu.
Choose Field Tab and Shift+Tab Steps forwards and backwards through all fields on a panel. Unavoidably it will also step through some of the native browser elements, such as the location bar.

Browser Desktop Keyboard Shortcuts

Control Key Combo Comments
Choose Cluster Alt+C Opens menu. Select a Cluster from the menu using CursorUp / CursorDown and activate with Return. Use Esc to close the menu without making a selection.
Choose Table Alt+T Opens menu. Select a Table from the menu using CursorUp / CursorDown and open with Return. Use Esc to close the menu without opening a Table.
Choose Style (Use Form and Use Grid) ALT+S Toggles between each Style type.
Choose Link Alt+L Opens menu. Select a Link from the menu using CursorUp / CursorDown and open with Return. Use Esc to close the menu without creating a Link.

Field Specific Keyboard Shortcuts

Depending on the particular field focused these keyboard shortcuts can be used to control/select the content of that field. Most of these are overloaded keys, and will act in the way described only when the specific field or field control described is actually in focus. They will otherwise be likely to have a different behaviour which is described elsewhere on this page.

Dynamic Drop-Down

When a Dynamic Drop-Down Field is focused the following keyboard shortcuts apply. The field is focused by clicking on it with the mouse (which loads the content if necessary and then opens the menu) or by tabbing into it (which loads the content if necessary but does not automatically open the menu).

Key Combo Comments
Return Opens menu if not open aleady. If an option on an opened menu is highlighted then Return will select that value for the field and close the menu.
CursorUp and CursorDown Highlight a specific option on the menu by stepping up and down through all the options.
Backspace Closes menu leaving current value of field unchanged. Also deletes back one character of any live type-ahead match (see below).
Delete Closes menu selecting blank (empty) as the value for the field. Also applies in live type-ahead (see below).

Type-ahead matching is supported. Just type the first one or more characters of an item on the menu. As you type the first matching item will be substituted as the value for the field or the field will show the characters typed if there is no match. Matching is always case insenstive, so ab will match abc, Abc and ABC for example. Spaces and other characters are significant in the match however and must be included if necessary. You can use Backspace to delete back each character of what has been typed so far. The blank (empty) value can be selected at any point during type-ahead (irrespective of whether characters have already been typed) by pressing the Delete key, or alternatively if at least one random character has been typed and then all the characters have been deleted using Backspace.

The menu does not need to have been opened for type-ahead matching to work, however, if it is then the matching item is highlighted in the menu as characters are typed (you do not need to press Return to select it as it will have been automatically selected already, but you can with no effect other than closing the menu). With the menu open you can mix and match, that is, type-ahead to a particular item and then use cursor up/down to highlight a different item and Return to select it as the value for the field.

If there is no match to what has been typed (if the menu is open the initial blank value will be highlighted) and the menu is closed without making a selection (or the drop-down field loses focus for some other reason which will also automatically close the menu) then the most recent successful match will be left as the value for the field.

Lookup

Use the Delete key when a Lookup Field is focused to blank all of the fields associated with the lookup so that a new lookup query can be entered.

Others

These are just standard browser keyboard shortcuts for native form fields. Below is based on the behaviour in Firefox on Linux, other browsers and different platforms may differ slightly.

Key Combo Comments
Spacebar On a focused checkbox field this will toggle the state. On a focused drop-down field this will open the menu.
CursorUp and CursorDown On a focused drop-down field these will step up and down through all the options (the menu does not need to be open). You can also single character type-ahead, so pressing a character key (letter or number for example) will skip to the first option that has that character as its first letter. When the drop-down menu is open Esc or Return will close it (using currently highlighted option as the new value).

Record Navigation Keyboard Shortcuts

Depending on the particular selector type and/or focused box these keyboard shortcuts can be used to navigate through the displayed records. Most of these are overloaded keys, however they generally perform near identical actions that just affect the specifically focused content associated with a selector/grid.

Scroll Selector

When a box is focused (when any field within the box is focused or the box itself) with an embedded vertical scroll bar the following keyboard shortcuts apply. The Box is focused by clicking on (or tabbing onto) any field within the box, or by clicking on the box itself.

Key Combo Comments
CursorUp, Shift+CursorUp and PageUp Selects the previous record (step back one). Note that when a text entry field is focused CursorUp navigates text within the field rather than selecting records, or that when a dynamic drop-down with an open menu or a native browser drop-down is focused CursorUp selects an option from the drop-down rather than selecting records.
CursorDown, Shift+CursorDown and PageDown Selects the next record (step forward one). Additionally Shift+CursorDown will automatically append a new record and select that record when it is used on the last record and appending is enabled on the box content. Note that when a text entry field is focused CursorDown navigates text within the field rather than selecting records, or that when a dynamic drop-down with an open menu or a native browser drop-down is focused CursorDown selects an option from the drop-down rather than selecting records.
Home Selects the first record.
End Selects the last record.
Shift+Insert Appends a new record at the end and selects that record (when appending is enabled on the box content).
Shift+Delete Deletes the currently selected record (when deleting is enabled on the box content).

Note that rotating the mouse wheel up is equivalent to the PageUp key action above and rotating the mouse wheel down is equivalent to the PageDown key action above.

Tab Selector

When a Tab Selector Box is focused (when any field within the box is focused or the box itself) the following keyboard shortcuts apply. The Box is focused by clicking on (or tabbing onto) any field within the box, or by clicking on the box itself.

Key Combo Comments
CursorLeft and Shift+CursorLeft Selects previous Tab (tab to the immediate left of currently active tab). Note that when a text entry field is focused CursorLeft navigates text within the field rather than selecting tabs.
CursorRight and Shift+CursorRight Selects next Tab (tab to the immediate right of currently active tab). Note that when a text entry field is focused CursorRight navigates text within the field rather than selecting tabs.
Shift+Insert Adds a new Tab at the end and selects it as the currently active tab.
Shift+Delete Deletes the currently active tab, the next tab (to the immediate right) is then selected as the currently active tab, or if none the previous tab (to the immediate left) is selected.

Grid Container

When a grid container is focused (when any cell within the grid is focused or the grid container itself) the following keyboard shortcuts apply. The Grid Container is focused by clicking on (or tabbing onto) any cell within the grid, or by clicking on the grid container itself.

Key Combo Comments
CursorUp and Shift+CursorUp Selects the previous record (step back one). Note that when a dynamic drop-down with an open menu or a native browser drop-down is focused CursorUp selects an option from the drop-down rather than selecting records.
CursorDown, Shift+CursorDown Selects the next record (step forward one). Additionally Shift+CursorDown will automatically append a new record and select that record when it is used on the last record and appending is enabled on the grid content. Note that when a dynamic drop-down with an open menu or a native browser drop-down is focused CursorDown selects an option from the drop-down rather than selecting records.
PageUp Selects the previous page (step back one whole grid page). On the first page selects the first record.
PageDown Selects the next page (step forward one whole grid page). On the last page selects the last record.
Home Selects the first record.
End Selects the last record.
Shift+Insert Appends a new record at the end and selects that record (when appending is enabled on the grid content).
Shift+Delete Deletes the currently selected record (when deleting is enabled on the grid content).
CursorLeft and Shift+CursorLeft Moves the window of displayed columns to the left (left edge of window is stepped to the start of the next closest column to the left). Note that when a text entry field is focused CursorLeft navigates text within the field rather than moving the displayed columns.
CursorRight and Shift+CursorRight Moves the window over the displayed columns to the right (left edge of window is stepped to the start of the next closest column to the right). Note that when a text entry field is focused CursorLeft navigates text within the field rather than moving the displayed columns.

Note that rotating the mouse wheel up is equivalent to the PageUp key action above and rotating the mouse wheel down is equivalent to the PageDown key action above.

Box Navigation Keyboard Shortcuts

Not available yet.

-- TimColles - 27 Nov 2018

Topic revision: r1 - 27 Nov 2018 - 14:46:55 - TimColles
 
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
This Wiki uses Cookies