Form

Focus traversal and editing

Table: Inline editing and focus traversal behavior

Item

Key event

Behavior

TextField

Up, down, left, right arrow keys

Moves cursor in editor.


  • If the cursor is moved beyond the editor contents, e.g., pressing the down arrow key in the last row or the up arrow key in the first row, the focus moves to the end or the beginning of the TextField, respectively.

  • Left and right arrow key presses in the beginning and end of the rows move the focus to the end or to the beginning of the editing buffer respectively only if the cursor is in the beginning or at the end of the editing buffer, not in middle of the buffer

  • Left and right arrow keys in the line ends in the middle of the buffer move normally in the buffer (e.g., move to the start of the next line in the end of line when the right arrow key is pressed in left to right editing mode).

Interactive Gauge

Left, right arrow keys

Modifies Gauge value.

Interactive Gauge

Up, down keys

Does focus traversal out of the Item.

DateField

Left, right arrow keys

Changes between DateField subfields (switches between minute, hour, day, month, or year subfields if available).


  • The subfield ordering within DateField is as defined in section DateField.

  • Focus traversal is possible out of the Item when focus is in the first and last subfield using left and right arrow keys

DateField

Up, down keys

Does focus traversal out of the Item.


  • If the key event happens inside a DateField in which there are two rows of subfields, then up and down change between the rows (focus traversal is similarly possible out of the DateField in the first and last row).

ChoiceGroup

Left, right arrow keys

Do not move focus at all.

ChoiceGroup

Up, down arrow keys

Moves focus inside the ChoiceGroup between the elements or if focus is in the first or last element, then moves focus out of the Item.

Line breaks

The following characters add a line break:

Table: Supported new-line characters

Line separator

New-line escape (Java source code)

Unicode values

CRLF (Carriage return + Line feed)

\r\n

U+000D, U+000A

LF (Line feed)

\n

U+000A

CR (Carriage return)

\r

U+000D

LS (Line separator, Unicode only)

\u2028

U+2028