Field Decorators and Validation

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 - "Normal" case of field-based content assist (the light bulb by the field)

Figure 1.2 JDT New Java Interface Dialog - List Cell Editor - Lightbulb overlay, on top of the adjacent icon, is not very visible and inconsistent with other use cases.

Figure 1.3 JDT Change Method Signature Dialog - Table Cell Editor - Lightbulb Overlay is clipped by table edge

Required Input

Figure 2.1 Save As Dialog: Parent folder and file name fields - Text Field - text

Figure 2.2 Save As Dialog: Input error - Text Field, Header (banner) - text

Figure 2.3 PDE Form - Text Field - text

Figure 2.4 Jazz SCM New Repository Form - Combo Box - text

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