Spin boxes

Use a spin box to allow users to choose an item from an ordered list easily. For example, use spin boxes to allow users to find a number or to change the day of the week.

Action

BlackBerry devices with a trackpad only

BlackBerry devices with a touch screen and a trackpad

Find an item in the list.

Move a finger vertically on the trackpad.

  • Drag a finger vertically on the screen.
  • Swipe up or down on the screen.
  • Move a finger vertically on the trackpad.

Move a finger up or down on the screen or the trackpad.

Choose an item from the list.

Click the trackpad.

  • Lift a finger from the screen.
  • Click the trackpad.

Move to another spin box.

Move a finger vertically on the trackpad.

  • Drag a finger vertically on the screen.
  • Move a finger vertically on the trackpad.
This screen shows an example of a spin box.

Best practice: Implementing spin boxes

  • Use spin boxes for a list of sequential items.
  • Use drop-down lists for non-sequential items or items with irregular intervals. For a short list of non-sequential items, you can use a spin box to provide a more interactive experience for users.
  • Avoid using a spin box if several other components appear on the screen.
  • Use the SpinBoxField class and the SpinBoxFieldManager class to create spin boxes. For more information about creating spin boxes, see the API reference for the BlackBerry® Java® SDK and the BlackBerry Java Application UI Quick Reference Guide.
  • Add spin boxes to dialog boxes instead of screens where possible.
  • When users highlight a spin box, display three to five items vertically.
  • Use an identifiable pattern for the sequence of items (for example, 5, 10, 15) so that users can estimate how much they need to scroll to find the target item.
  • Avoid making users scroll horizontally to view multiple spin boxes. If necessary, separate spin boxes into multiple fields.
  • If the text in a spin box is too long, use an ellipsis (...).
Next topic: Tree views

Was this information helpful? Send us your comments.