Widgets

From Openmoko

Important Note: This article or section is significantly outdated, either by significant hardware or software changes. Procedures mentioned in this page may well not work for current hardware/software.

NOTE: The following Widgets are listed in order of priority.

Contents 1 Bar Widgets 2 Menu Widgets 3 List Widgets 4 Scrolling Widgets 5 Preview Widgets 6 Field Widgets 7 Dialog Widgets 8 Input Method Widgets 9 Other Widgets

Bar Widgets

• Toolbar
• Menubar
• Finger Toolbar

Menu Widgets

• Application Menu
• Filter Menu
• Popup Menu

List Widgets

• Navigation List
• Details List

Scrolling Widgets

• Finger Scrolling
• Stylus Scrolling

Preview Widgets

All preview widgets will have an icon to visual represent the type of widget and a means (read: icon) to collapse/expand them to see more information. These are used in applications such as the File Browser and Contacts' Communication History section. Most preview widgets contain a big representation of the contents to the left and then a number of field widgets (view mode) to the right.

Selection/Expand/Collapse logic goes like this:

• Select, if not selected
• Expand, if selected and collapsed
• Collapse, if selected and expanded

NOTE: Do we want auto-collapse for an expanded widget when user selects a different one?

The term "Open with Associate Application" will be substituted with the actual application's name.

• Message Preview
• Picture Preview
• Call Preview
• Sound / Recording Preview
• Date & Time Preview

Field Widgets

Field widgets are small widgets visualizing one kind of data. They are commonly used in Preview Widgets.

We should allow for 3rd party applications to hook into the "Tap with Hold" menu.

The first "tap with hold" action is always the same as the "tap" action.

TODO: Need to add two arrow buttons to allow changing order (See: To-Do List)

• Phone Number Field
• Address Field
• Event Field
• Sound Field
• Picture Thumbnail Field

Dialog Widgets

Dialog Widgets are temporarily shown to indicate a condition or to gather more information before a certain application can continue its normal operation.

• Information Dialog
• Confirmation Dialog
• Call Notification Dialog
• Data Entry Dialog
• Accounts Dialog
• Sources Dialog
• File Open Dialog

Input Method Widgets

Input Method Widgets allow entering data into the field that is currently focused. They should be displayed / hidden automatically according to the input focus.

Every Input Method Widget allows switching between available input methods and locales (languages).

TODO: Need to experiment with resize or overlay. Find out what works better (See: To-Do List)

• Input Method

Other Widgets

• Message Body
• Auto-complete
• Action Button
• Search
• Icon
• Application
• Setup Devices
• Email Address Field
• Date & Time Field
• Web Address Field