Form

The layout of Items within a Form is organized around rows. The maximum width of all rows within a Form is the same and does not vary based on the Items contained within the Form. If a Form exceeds the height of the screen it grows vertically and vertical scrolling is used by the user to view further content. If the content exceeds the screen width, it is either wrapped (text) or cropped (images) to the available space.

The height of the rows can vary depending on the Items positioned in the row. If the first / last Itemin a Form is a Spacer larger than the size of the screen then as much of the Spacer as necessary is ignored in order to start or end the Form with the first or last visible Item being completely in view.


Focus traversal and editing
Table 32: 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 33: 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



For information on Form Item implementation in
Touch UI -enabled devices, see section Displayables
and commands.

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 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