Skip to content

@serenity-is/corelib / MessageDialogOptions

Interface: MessageDialogOptions

Defined in: src/base/dialogs.tsx:990

Options for helper message dialogs (alertDialog, confirmDialog, etc.).

Remarks

Extends DialogOptions with message-specific rendering flags.

Extends

Extended by

Properties

autoDispose?

optional autoDispose: boolean

Defined in: src/base/dialogs.tsx:57

When true, Dialog.dispose is called automatically on close.

Default Value

true

Inherited from

DialogOptions.autoDispose

autoOpen?

optional autoOpen: boolean

Defined in: src/base/dialogs.tsx:59

When true, the dialog opens immediately after construction.

Default Value

true

Inherited from

DialogOptions.autoOpen

backdrop?

optional backdrop: boolean | "static"

Defined in: src/base/dialogs.tsx:61

Backdrop behavior for Bootstrap modals; "static" prevents closing on outside click.

Default Value

false

Inherited from

DialogOptions.backdrop

buttons?

optional buttons: DialogButton[]

Defined in: src/base/dialogs.tsx:63

Buttons rendered in the dialog footer.

Inherited from

DialogOptions.buttons

centered?

optional centered: boolean

Defined in: src/base/dialogs.tsx:65

Vertically centers a Bootstrap modal via modal-dialog-centered.

Default Value

true

Inherited from

DialogOptions.centered

closeButton?

optional closeButton: boolean

Defined in: src/base/dialogs.tsx:67

Whether to render the header close (× / btn-close) button.

Default Value

true

Inherited from

DialogOptions.closeButton

closeOnEscape?

optional closeOnEscape: boolean

Defined in: src/base/dialogs.tsx:69

Whether pressing Escape closes the dialog. Message dialogs default to true.

Inherited from

DialogOptions.closeOnEscape

dialogClass?

optional dialogClass: string

Defined in: src/base/dialogs.tsx:71

Extra CSS class(es) added to the root dialog element (.modal, .ui-dialog, or .s-Panel).

Inherited from

DialogOptions.dialogClass

element?

optional element: HTMLElement | ArrayLike<HTMLElement> | (element) => void

Defined in: src/base/dialogs.tsx:73

Body element or a callback that populates the freshly created body element. Array-like values are treated as the content node.

Inherited from

DialogOptions.element

fade?

optional fade: boolean

Defined in: src/base/dialogs.tsx:75

Enables fade animation for Bootstrap modals.

Default Value

false for message dialogs, true otherwise

Inherited from

DialogOptions.fade

fullScreen?

optional fullScreen: boolean | "sm-down" | "md-down" | "lg-down" | "xl-down" | "xxl-down"

Defined in: src/base/dialogs.tsx:77

Applies a modal-fullscreen[-{breakpoint}-down] class. Only effective for Bootstrap modals.

Inherited from

DialogOptions.fullScreen

htmlEncode?

optional htmlEncode: boolean

Defined in: src/base/dialogs.tsx:995

Whether to HTML-encode string messages.

Default Value

true

Deprecated

Prefer passing a RenderableContent node or pre-sanitized HTML. When false, the string is sanitized via sanitizeHtml.

optional modal: boolean

Defined in: src/base/dialogs.tsx:79

jQuery UI modal flag. Retained for backward compatibility; does not affect Bootstrap modals.

Inherited from

DialogOptions.modal

onClose()?

optional onClose: (result, e?) => void

Defined in: src/base/dialogs.tsx:83

Callback invoked after the dialog is closed, receiving the result code.

Parameters

result

string

e?

Event

Returns

void

Inherited from

DialogOptions.onClose

onOpen()?

optional onOpen: (e?) => void

Defined in: src/base/dialogs.tsx:81

Callback invoked after the dialog is opened.

Parameters

e?

Event

Returns

void

Inherited from

DialogOptions.onOpen

preferBSModal?

optional preferBSModal: boolean

Defined in: src/base/dialogs.tsx:85

When both providers are available, prefer Bootstrap modal over jQuery UI dialog.

Default Value

true

Inherited from

DialogOptions.preferBSModal

preferPanel?

optional preferPanel: boolean

Defined in: src/base/dialogs.tsx:87

Force inline panel mode even when modal / jQuery UI providers are available.

Inherited from

DialogOptions.preferPanel

preWrap?

optional preWrap: boolean

Defined in: src/base/dialogs.tsx:1000

Whether to preserve line breaks via white-space: pre-wrap on the message container.

Default Value

true

Remarks

Only applied when the message is a string; element messages manage their own styling.

providerOptions()?

optional providerOptions: (type, opt) => any

Defined in: src/base/dialogs.tsx:89

Returns provider-specific options merged into the underlying call (Bootstrap modal options or jQuery UI dialog options).

Parameters

type

DialogProviderType

Resolved provider type.

opt

DialogOptions

The resolved dialog options.

Returns

any

Provider-specific options object.

Inherited from

DialogOptions.providerOptions

scrollable?

optional scrollable: boolean

Defined in: src/base/dialogs.tsx:91

Makes the Bootstrap modal body scrollable via modal-dialog-scrollable.

Inherited from

DialogOptions.scrollable

size?

optional size: "sm" | "md" | "lg" | "xl"

Defined in: src/base/dialogs.tsx:93

Bootstrap modal size.

Default Value

"lg" for regular dialogs, "md" for message dialogs

Inherited from

DialogOptions.size

title?

optional title: string

Defined in: src/base/dialogs.tsx:95

Title text shown in the dialog header.

Inherited from

DialogOptions.title

width?

optional width: number

Defined in: src/base/dialogs.tsx:97

Initial width in pixels; only used by the jQuery UI dialog provider.

Inherited from

DialogOptions.width

Previous Page Next Page