Dialogs
Dialogs are a central piece of Magnolia projects; they are the interface between authors and the content. Dialogs are generally assembled by using controls, grouped in tabs. The Can't resolve link to: /templating-guide offers an overview on how to create your own dialogs.
Here is the list of properties you can modify to customize the appearance and functionality of your dialogs:| Property | Default | Values | Description |
|---|---|---|---|
| label | Dialog.editTitle | There are no real limitations to the values that can be used for label but it is recommended that conventional alphanumeric characters are used. | The label property is the functional title of the dialog that will be displayed to the user. |
| width | 800 | This property is only limited by the size of image that will be displayed on the user or viewer's screen. | The width property is the width of the dialog in pixels. This property can be edited after the dialog is created. |
| height | 650 | This property is only limited by the size of image that will be displayed on the user or viewer's screen. | The height property is the height of the dialog in pixels. This property can be edited after the dialog is created. |
| saveOnclick | mgnlDialogFormSubmit() | Defined javascript with appropriate functionality. | This property names the javascript to be executed when users click a dialog save button". |
| saveLabel | buttons.save | This property should be short and descriptive since it will be displayed on a button. | This property defines the label for the dialog save button. |
| cancelOnclick | Window.close() | Defined javascript with appropriate functionality. | This property defines the javascript that dictates the action that will be executed when users click the cancel button within the dialog. |
| cancelLabel | buttons.cancel | This property should be short and descriptive since it will be displayed on a button. | This property defines the label for the dialog cancel button. |
| i18nBasename | info.magnolia.module. admininterface.messages | Any appropriately defined message bundle. | This property defines which message bundle to use for the dialog. |
| name | name of the node | It is recommended that conventional alphanumeric characters be used for this property to avoid the inadvertent use of any "special" or "forbidden" characters. | This property defines an optional name for the dialog. |
| class | ParagraphEditDialog | This property needs to be in appropriate Magnolia class syntax and specifically refers to the class for the dialog. | This is the DialogHandler class and it is generally a subclass of the ConfiguredDialog class or or the ParagraphEditDialog. The particular class for the dialog facilitates the creation, validation and saving of the dialog. |
| saveHandler | UUIDSaveHandler | This property must specify a defined class that will be used as the SaveHandler class for the dialog. | This property defines the SaveHandler class to use for the dialog. |