Jump to: navigation, search

Field Decorators and Validation

Revision as of 17:29, 10 November 2006 by Kelvinc.ca.ibm.com (Talk | contribs)

This document describes Use Cases and Solutions for field decorators of (1) Content Assist, (2) Required Fields, and (3) Errors/Warnings. Each of these indicators are shown in various UI contexts, such as Dialog Boxes, Wizards, and Forms, in order to describe the design issues and apply a consistent solution where possible. The main techniques that are described in the Blueprint Specifications and Solutions refer to icon/text treatment (size and position) at the Control-level, as well as messages at the UI-level.


Indicator (cue)
  • Content Assist
  • Required Input
  • Errors & Warnings
UI Controls or Area
  • Text Field
  • Combo Box
  • Drop-Down List Box
  • List box
  • Table
  • Table Cell
  • Header
  • Body
  • Tab
UI Context
  • Dialog Boxes
  • Wizards
  • Forms


Content Assist

Figure 1.1 Find/Replace Dialog - Combo Box
Lightbulb overlay is middle-aligned vertically with the combo box and text labels.

FindReplace.gif


Figure 1.2 JDT New Java Interface Dialog - List Cell Editor
Lightbulb overlay is placed to the left of the list box.

NewJavaInterface.gif


Figure 1.3 JDT Change Method Signature Dialog - Table Cell Editor
Lightbulb overlay is placed to the left of the table. For indication at the cell-level, the text is shifted to the right to accommodate for the overlay placed on the left side.

ChangeMethod.gif ChangeMethodCell.gif

Required Input

Figure 2.1 Save As Dialog: Parent folder and file name fields - Text Field
Asterisk is placed after the text label and colon.

SaveAs.gif


Figure 2.2 Save As Dialog: Input error - Text Field, Header (banner)
Asterisk is placed after the text label and colon; Error icon with message replaces the description in the top banner info area; Large error icon provides association with the text field indicator inside the dialog page.

SaveAsError.gif


Figure 2.3 PDE Form - Text Field
Asterisk is placed after the text label and colon; Lightbulb overlay is middle-aligned vertically with the combo box and text labels.

PDE.gif


Figure 2.4 Jazz SCM New Repository Form - Combo Box
Asterisk is placed after the text label and colon.

NewRepository.gif

Error and Warning Messages

Figure 3.1 Native Library Folder Configuration Dialog: Input error - Text field, Body of dialog
Warning indicator is placed to the left of the text field.

NativeLibrary.gif


Figure 3.2 New Package Wizard - Text Field, Header
Error icon with message replaces the description in the top banner info area; Large error icon provides association with the text field indicator inside the dialog page.

NewPackage.gif


Figure 3.3 New Class Wizard - Text Field, Header
Asterisk is placed after the text label and colon; Content assist icon is placed to the left of text field; indicator inside the dialog page. Warning icon with message replaces the description in the top banner info area; Large error icon provides association with the text field

NewClass.gif File:NewClassB.gif


Figure 3.4 Jazz SCM New Repository Form: Input error - Text Field, Combo Box, Header


Figure 3.5 Jazz Work Item Form: Failed to load error - Header, Tab

Blueprint Specifications

BlueprintSpecifications.gif