Difference between revisions of "Field Decorators and Validation"

From Eclipsepedia

Jump to: navigation, search
(Content Assist)
(Required Input)
Line 77: Line 77:
  
  
'''''Figure 2.1''''' Save As Dialog: Parent folder and file name fields - Text Field - text
+
'''''Figure 2.1''''' Save As Dialog: Parent folder and file name fields - Text Field<br/>
 +
Asterisk is placed after the text label and colon.
  
'''''Figure 2.2''''' Save As Dialog: Input error - Text Field, Header (banner) - text
 
  
'''''Figure 2.3''''' PDE Form - Text Field - text
+
[[Image:SaveAs.gif]]
  
'''''Figure 2.4''''' Jazz SCM New Repository Form - Combo Box - text
+
 
 +
'''''Figure 2.2''''' Save As Dialog: Input error - Text Field, Header (banner)<br/>
 +
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. 
 +
 
 +
 
 +
[[Image:SaveAsError.gif]]
 +
 
 +
 
 +
'''''Figure 2.3''''' PDE Form - Text Field<br/>
 +
Asterisk is placed after the text label and colon.  Lightbulb overlay is middle-aligned vertically with the combo box and text labels.
 +
 
 +
 
 +
[[Image:PDE.gif]]
 +
 
 +
 
 +
'''''Figure 2.4''''' Jazz SCM New Repository Form - Combo Box<br/>
 +
Asterisk is placed after the text label and colon.
 +
 
 +
 
 +
[[Image:NewRepository.gif]]
  
 
== Error and Warning Messages ==
 
== Error and Warning Messages ==

Revision as of 17:57, 10 November 2006

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


Contents

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.31 JDT Change Method Signature Dialog - Table Cell Editor
Lightbulb overlay is placed to the left of the table.

ChangeMethod.gif


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

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- text

Figure 3.2 New Package Wizard - Text Field, Header - text

Figure 3.3 New Class Wizard - Text Field, Header - text

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

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

Blueprint Specifications

BlueprintSpecifications.gif