Address Field

From Openmoko

Not implemented: This article or section documents one or more features that are not implemented and which may never be implemented.

Contents 1 Overview 2 Usages Cases 3 Appearance & Interaction 3.1 View Mode 3.1.1 On Tap 3.1.2 On Tap with Hold 3.2 Edit Mode 4 Constraints 5 Architectural Details 6 Implementation Recommendations 7 UI Position 8 Cross-Widget Interactions 9 Unresolved Issues 10 Questions and Answers

Overview

The Address Field Widget provides a general method to handle interactions with addresses

Usages Cases

• Commonly used in the Details Area of Native Stylus-Based applications.

Appearance & Interaction

View Mode

On Tap

On Tap with Hold

• Popup Menu is opened with the following structures, based on the active field type:

Home, Work Types

Item	Action	Constraints
Display on Map	Opens the Navigation application with the map locus at this address
Add to Contact	Adds this address to a contact	Grayed-out if address is within existing contact
Copy to Clipboard	Copies address to clipboard

Email Type

Item	Action	Constraints
Send Email	Opens the Messages application with a new email using this address
Add to Contact	Adds this address to a contact	Grayed-out if address is within existing contact
Copy to Clipboard	Copies address to clipboard

IM Type

Item	Action	Constraints
Send IM	Starts new IM conversation using this address
Add to Contact	Adds this address to a contact	Grayed-out if address is within existing contact
Copy to Clipboard	Copies address to clipboard

URL Type

Item	Action	Constraints
Open in Browser	Opens this URL in the Browser application
Add to Contact	Adds this address to a contact	Grayed-out if address is within existing contact
Copy to Clipboard	Copies address to clipboard

Custom Type

Item	Action	Constraints
Copy to Clipboard	Copies address to clipboard

Edit Mode

While in Edit Mode, the Phone Field Widget, has the following modifiable regions:

• 1) Remove Field -- On Tap will remove this widget.

• 2) Add New Field -- On Tap will add a new copy of this widget (empty, but of the same type)

• 3) Type

• 4) Type Selector -- On Tap will open Popup Menu with the following structure:

• 5) Text Field

Item	Action	Constraints
Home	Sets address type to Home
Work	Sets address type to Work
Email	Sets address type to Email
IM	Sets address type to IM
URL	Sets address type to URL
Custom	Opens Dialog prompting for custom type name

Constraints

(TBD)

Architectural Details

(TBD)

Implementation Recommendations

• Could be derived from a GtkHBox
• In View Mode, the actual e-mail address is shown using a GtkLabel
• In Edit Mode, the actual e-mail address is shown using a GtkEntry

UI Position

Cross-Widget Interactions

(TBD)

Unresolved Issues

• How do we want to handle Custom types?
• We are going to need to have a few non-removable fields. Otherwise, with this interface there is no way to (say) add another address, if there is only one, and it's removed.

Questions and Answers

(None)