Choose dialog - 5 UI
Deprecated
Choose dialog has been deprecated since Magnolia 6.0. It is part of the Magnolia 5 UI framework. For the updated implementation, see Chooser dialog for _Magnolia 6 UI instead. |
A choose dialog allows you to select an item from an app, typically from a content app. Below is a choose dialog for choosing a page. The dialog displays the workbench from the Pages app. You typically open a choose dialog by clicking a link field in some other dialog. Configure the choose dialog under the app that manages the items.
Choosing items from content apps
A content app already has a suitable view for choosing items: the
workbench of the first subapp. You don’t need to configure a choose
dialog explicitly. AppContext
creates ChooseDialogDefinition
programmatically.
WorkbenchFieldDefinition
and ContentConnectorDefinition
are instantiated in the ContentApp#openChooseDialog
method. Values for
the definition classes are cloned from the first subapp of the app.
Configuring a choose dialog
You don’t need to configure a choose dialog when choosing items from a content app. The workbench of the first subapp works as an item chooser automatically. |
You can configure a choose dialog explicitly if required. Create a
chooseDialog
node under the app configuration.
Property | Description |
---|---|
|
optional Choose dialog node. |
|
required Content connector node. |
|
required Content
connector definition class implementing
|
|
required Field node. |
|
required A field used to choose the item, typically a
workbench.
The value must be a subclass of
|
|
required A choose dialog definition class implementing
|
ChooseDialogDefinition extends DialogDefinition. This means
you can also configure actions (Select and Cancel by default) and an
actionArea (optional).
|
Configuring a workbench
If you want to configure a custom workbench, use
info.magnolia.ui.contentapp.field.WorkbenchFieldDefinition
as field.
Property | Description |
---|---|
|
optional Choose dialog node. |
|
required Field node. |
|
optional Extend an existing workbench definition or use any properties from the workbench definition. |
|
optional Path to extended definition. |
|
optional |