Common Desktop Environment: Style Guide and Certification Checklist

SpinBox

 

n/a 

 

 

Required 

hw: 

Present the items as a ring of items that wrap. For example, if a user is at the largest number and presses the up arrow, the smallest number is displayed and vice versa so that the user can spin through all the items by pressing the same arrow. 

Required 

hx: 

Move through the items in a spin box as shown in Table 10-5.

Table 10-5 Navigation in a Spin Box

Movement 

Keys 

Example 

Toward the beginning of the list 

left arrow, down arrow 

Chronological: If Tuesday is displayed, move to Monday when the user presses the left or down arrow. 

Magnitude: If 15 is displayed, move to 14 when the user presses the left or down arrow. 

Toward the end of the list 

right arrow, up arrow 

Chronological: If Tuesday is displayed, move to Wednesday when the user presses the right or up arrow. 

Magnitude: If 15 is displayed, move to 16 when the user presses the right or up arrow. 

 

n/a 

 

 

Recommended 

hy: 

Values can be set using the arrow buttons or through keyboard input. Values should be evaluated immediately upon entry. If a value is entered that is already in the list, scroll to the position of that entry in the list. 

Recommended 

hz: 

If entry of non-listed items is permitted, use the following behavior. When a new value is entered, scroll the list to the position appropriate for the new entry. If the user scrolls off the new entry, scroll to the next appropriate value in the list and the keyboard-entered value is lost. 

Recommended 

ia: 

On entry of an invalid value, an auditory warning and error message should be provided.