Dialog

Summary:

  • Dialog is used for:

    • Presenting queries, warnings or information.

    • Asking user to make a YES/NO selection.

  • Appears on top of the application content area, centered on screen.

  • 0, 1, and 2 button dialogs are directly supported.

  • Custom solutions required for:

    • 3 button dialog.

    • Progress bar (modified slider).

  • Can listen to threads; those must be started before the dialog is displayed.

  • Platform specific features:

    • Full touch uses different typography rules.

LWUIT

Related design guidelines

Note:

It is not recommended to use Dialog in the pop-up dialog mode, since it is not part of the Series 40 UI style in any of the three platform releases (non-touch, touch and type or full touch).

Basics

Figure: Dialog with title, icon and 1 button

  • Interaction:

    • Dialog opens in the foreground.

    • Parental screen stays in the background, but is partially occluded by a layer with 60% opacity.

    • Dialogs are typically dismissed by pressing a dedicated button, for example:

      • 'OK', when alert is purely informative.

      • 'Cancel', when there is an ongoing operation.

    • Buttons can be used for short commands only (for example: Yes, No, Cancel, Back, etc.)

      • Use "Cancel" to stop the process and discard all changes made by the process.

      • Use "Quit" to stop the process but to keep all the changes made by the process.

    • Title is recommended; if title is not defined, the title zone is shown but is empty.

    • In case the text is dynamic, split it up into title and body; for example:

      • "Delete contact?" (title).

      • "Anna Smith" (body).

    • Body text is limited and cannot be scrolled by default.

      • If long body text is necessary, open a new text view instead.

      • New view might require additional buttons like "OK" and "Cancel", icons might not be sufficient (i.e., Back arrow and checkmark in action button 1).

    • Dialog sound is by default the phone alert sound, but can be changed to:

      • Alarm.

      • Confirmation.

      • Error.

      • Info.

      • Warning.

    • Fully supported:

      • 0 buttons, timed dialog.

      • 1 button.

      • 2 buttons.

    • Custom solutions:

      • 3 buttons.

      • Additional icon.

      • Determinate progress indicator (modified slider).

      • Indeterminate progress indicator (busy indicator, UI component itself requires a custom solution).

  • Structure:

    • Dialog is a subclass of Form.

    • Form is a subclass of Container.

Supported formats

Figure: Timed dialog

Figure: 1 button dialog (default dialog)

Figure: 2 button dialog

 
  • The UI style is based on dialogs with up to 3 buttons.

  • In LWUIT, only up to 2 buttons directly supported.

  • If 0 buttons are used:

    • Timed dialog.

    • Pressing outside the dialog dismisses it in touch phones.

  • If 1 button is used (confirmation):

    • This is the default dialog.

    • Stays on the screen until user taps the button.

    • Ensures that user has had time to read the text because:

      • Text is long, and /or

      • note appears after a delay during which the user's attention to screen is likely lost.

  • If 2 buttons are used (confirmation query):

    • Buttons are placed :

      • On the same line (full touch).

      • In the softkey zone (touch and type and non touch).

    • Left button has positive command.

    • Right button has negative command.

Custom formats

LWUIT does not directly support all use cases which are necessary to fully support the Series 40 UI style. The following use cases require custom solutions.

Figure: 3 button dialog

Figure: Icon in dialog

  • 3 button dialog (confirmation query):

    • Requires additional button:

      • For positive command.

      • Centred on top of the existing buttons (full touch).

      • MSK in the soft key zone (touch and type and non-touch), Positive action.

    • Bottom-right button must be Back/Quit/Cancel.

  • Icon in dialog:

    • Top left aligned for full touch .

    • Top right for touch and type and non-touch phones.

    • Size:

      • 52 x 52 px bounding box.

      • 36 x 36 px canvas.

    • UI component is for display only, no function assigned.

Figure: Progress indicator in dialog

Figure: Busy indicator in dialog

  • Progress indicator in dialog:

    • Modified slider.

    • Determinate progress indicator.

    • Use whenever possible .

    • One of the following needs to be known:

      • Process duration, or

      • work estimates (for example, file size), or

      • timeout.

    Busy indicator in dialog:

    • UI component not part of LWUIT, requires custom solution.

    • Indeterminate progress indicator.

    • Only suitable for processes which take less than 10 seconds.

    • Visualisation can be:

      • A spinner in the icon position.

      • A barbershop roll in the progress indicator position.

Platform specific features

Full touch

Touch and type

Non-touch

Description

Figure: Dialog with icon and 3 buttons in full touch (custom solution)

Figure: Dialog with icon and 3 buttons as softkeys in touch and type (custom solution)

Figure: Dialog with icon and 3 buttons as softkeys in non-touch (custom solution)

  • Full touch:

    • Buttons are part of the dialog area.

    • 3rd button (main action) is placed on top of other 2 buttons.

    • Button labels are all caps.

    • Dialog is centered.

    • Icon is top-left aligned.

  • Touch and type:

    • Only 2 buttons possible.

    • Buttons are in the softkey area.

    • Yes/OK (positive command) is in the MSK.

    • No/Cancel (negative command) is in the RSK.

    • Button labels are initial caps.

    • Dialog is bottom aligned.

    • Icon is top-left aligned.

  • Non-touch:

    • Only 2 buttons possible.

    • Buttons are in the softkey area.

    • Yes/OK (positive command) is in the MSK.

    • No/Cancel (negative command) is in the RSK.

    • Button labels are initial caps.

    • Dialog is bottom aligned.

    • Icon is top-left aligned.