- Loading...
Page History
...
In contrast to Desktop, TextArea on non-touch platforms will not support the following functionality unless it is supported by the HW keyboard:
- no "cancel changes" support and
- no copy, paste, or selection support.
TextArea is a control that can trap the focus traversal and cause users to get stuck. Giving that, users need to press OK/Select key to switch from the "traverse" mode to the "interactive" mode to be able to navigate and interact with this control. Note that the text area in "traverse" mode does not have to display scroll bars. The scroll bars might be visible only when the text area is in the "interactive" mode.
When in the "interactive" mode users can use the navigation keys to scroll the text area (text area in read only mode) or to move the caret within the text area (text area in edit mode). Because there is no support for the virtual keyboard, users must use the HW keyboard to type characters. When done, users must press OK/Select key to switch back from the "interactive" mode to the "traverse" mode.
Image: TextArea in Traverse and Interactive Mode
The following table describes actions that are performed when the focus traversal is on a text area and users press the following keys:
| Up | Move the focus traversal up. |
| Down | Move the focus traversal down. |
| Left | Move the focus traversal left. |
| Right | Move the focus traversal right. |
| OK/Select | Switch the text area to the "interactive" mode. |
Next tables describe actions that are performed when a text area is in the "interactive" mode and users press the following keys:
Text Area in Read Only Mode
| Up | Scroll the text area up by one step. |
| Down | Scroll the text area down by one step. |
| Left | Scroll the text area left by one step. |
| Right | Scroll the text area right by one step. |
| OK/Select | Switch the text area to the "traverse" mode. |
Text Area in Edit Mode
| Up | Move the caret up by one row. The text may scroll to keep the caret visible. The up arrow key results in no change when the cursor is positioned to the left of the very first entered character. |
| Down | Move the caret down by one row. The text may scroll to keep the caret visible. The down arrow key results in no change when the cursor is positioned to the right of the very last entered character. |
| Left | Move the caret left by one character. The text area may scroll to keep the caret visible. The left arrow key results in no change when the cursor is positioned to the left of the very first entered character. |
| Right | Move the caret right by one character. The text area may scroll to keep the caret visible. The right arrow key results in no change when the cursor is positioned to the right of the very last entered character. |
| HW key | Type a character. |
| OK/Select | Save changes and switch the text area to the "traverse" mode. |
...
TextField control behaves similarly to TextAreato TextArea. It also does not support the same functionality as TextArea unless it is supported by the HW keyboard.
Similarly to TextArea, TextField also needs to be switched to the "interactive" mode in order to enable users to interact with it. In the "interactive" mode, users can use the navigation keys to move the caret. To type a character, they must use the HW keyboard. When done, users must press OK/Select key to switch back from the "interactive" mode to the "traverse" mode.
Image: TextField in Traverse and Interactive Mode
The following table describes actions that are performed when the focus traversal is on a text field and users press the following keys:
| Up | Move the focus traversal up. |
| Down | Move the focus traversal down. |
| Left | Move the focus traversal left. |
| Right | Move the focus traversal right. |
| OK/Select | Switch the text field to the "interactive" mode. |
Next table describes actions that are performed when a text field is in the "interactive" mode and users press the following keys:
| Left | Move the caret left by one character. The text may scroll to keep the caret visible. The left arrow key results in no change when the cursor is positioned to the left of the very first entered character. |
| Right | Move the caret right by one character. The text may scroll to keep the caret visible. The right arrow key results in no change when the cursor is positioned to the right of the very last entered character. |
| HW key | Type a character. |
| OK/Select | Save changes and switch the text field to the "traverse" mode. |
TreeView 2-level control NOT FOR
...
LOMBARD (8.0)
Note that this control is not on the list of controls for Embedded platforms, however, since an use-case for this control exists on Embedded platforms, the expected interaction is mentioned here. In addition to that, this control may not be implemented due time and resource constraints.
...
Giving the limited number of keys that are dedicated to the traversal and interaction, functionality of TreeView is also limited. It means that this control will allow users to select a single node only. Selection of multiple nodes will be disabled and developers will need to place e.g. check box controls next to each node to enable this functionality. In addition to that, TreeView on non-touch platforms will have Add, Edit, Reorder, and Delete function disabled. If this functionality is required, developers will need to expose this functionality to end users by themselves.
Image: TreeView in Traverse and Interactive Mode
The following table describes actions that are performed when the focus traversal is on a tree view and users press the following keys:
| Up | Move the focus traversal up. |
| Down | Move the focus traversal down. |
| Left | Move the focus traversal left. |
| Right | Move the focus traversal right. |
| OK/Select | Switch the tree view to the "interactive" mode. |
Next tables describe actions that are performed when a tree view is in the "interactive" mode and users press the following keys:
| Up | Move the focus traversal up by one node. |
| Down | Move the focus traversal down by one node. |
| Left | Collapse current selection or go to the parent node. |
| Right | Expand current selection or go to the first child node. |
| OK/Select | Select the node and switch the tree view to the "traverse" mode. |
TreeView is the sole node in a container
| Up | Move the focus traversal up by one node. |
| Down | Move the focus traversal down by one node. |
| Left | Collapse current selection or go to the parent node. |
| Right | Expand current selection or go to the first child node. |
| OK/Select | Select the node. |
4. Appendix
A. Glossary
Common terms used by the JavaFX UI controls are defined once for all controls. See the JavaFX UI Controls - Common Glossary for details.
B. Gesture Definitions
Gestures used by the JavaFX UI controls are defined in one place for all controls. See the JavaFX UI Controls - Gesture Definitions for details.
...
| . |
...
Input Mechanisms used by the JavaFX UI controls are defined in one place for all controls. See the JavaFX UI Controls - Input Mechanisms for details.
D. Examples
...
Overview
Content Tools