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 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.