Dialog types

Simple dialog

Use a simple dialog whenever only few data points need to be collected. Its main characteristic is simplicity. It only provides limited ways to organize and group fields.

Characteristics:

• Single tab
• One or more fields

Complex dialog

The complex dialog allows to collect larger amounts of data than its simple counterpart. The main characteristics of this dialog are that it is capable of handling complex, hierarchical data sets and that it may summarize key settings of some or all of its sub forms.

Characteristics:

• Multiple tabs for grouping fields
• One or more fields per tab
• The Show all tab displays content from all the other tabs in one go.

Light dialog

Light dialogs ask for quick input but do not severely interrupt the user. Use them as an integral part of the task the user is currently working on.

Modality level: light

Characteristics:

• Collects quick input.
• Commonly used with actions which require parameters from the user.
• Only makes sense in the context the user currently works.
• Displayed modally but does not black out the background.

Choose dialog

The target app can also provide a chooseDialog. This is an alternative to the usual workbench view and may be better suited for selecting an item. When a chooseDialog is configured, it is used instead of the workbench view provided by the browser subapp. For example, the Assets app provides a choose dialog for selecting images. The choose dialog looks like a workbench but it also provides a custom action for uploading images from the desktop. The definition is in /modules/dam-app/apps/assets/chooseDialog.