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.
- No tab bar, the dialog is built with one tab.
- One or more fields.
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.
- Multiple tabs for grouping fields.
- One or more fields per tab.
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.
- 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.
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 custom actions for uploading and uploading/editing images from the desktop. The definition is in