@serenity-is/corelib / Dialog
Class: Dialog
Defined in: src/base/dialogs.tsx:82
Wrapper for different types of dialogs, including jQuery UI, Bootstrap modals, and Panels.
Constructors
Constructor
new Dialog(
opt?):Dialog
Defined in: src/base/dialogs.tsx:92
Creates a new dialog. The type of the dialog will be determined based on the availability of jQuery UI, Bootstrap, and the options provided.
Parameters
opt?
Optional configuration for the dialog
Returns
Dialog
Properties
defaults
staticdefaults:DialogOptions
Defined in: src/base/dialogs.tsx:142
Default set of dialog options
messageDefaults
staticmessageDefaults:MessageDialogOptions
Defined in: src/base/dialogs.tsx:156
Default set of message dialog options
Accessors
result
Get Signature
get result():
string
Defined in: src/base/dialogs.tsx:185
The result code of the button that is clicked. Also attached to the dialog element as data-dialog-result
Returns
string
type
Get Signature
get type():
DialogProviderType
Defined in: src/base/dialogs.tsx:366
Returns the type of the dialog, or null if no dialog on the current element or if the element is null, e.g. dialog was disposed
Returns
Methods
close()
Call Signature
close():
this
Defined in: src/base/dialogs.tsx:190
Closes dialog setting the result to null
Returns
this
Call Signature
close(
result):this
Defined in: src/base/dialogs.tsx:192
Closes dialog with the result set to value
Parameters
result
string
Returns
this
dispose()
dispose():
void
Defined in: src/base/dialogs.tsx:552
Disposes the dialog, removing it from the DOM and unbinding all event handlers.
Returns
void
getContentNode()
getContentNode():
HTMLElement
Defined in: src/base/dialogs.tsx:380
Gets the body/content element of the dialog
Returns
HTMLElement
getDialogNode()
getDialogNode():
HTMLElement
Defined in: src/base/dialogs.tsx:385
Gets the dialog element of the dialog
Returns
HTMLElement
getEventsNode()
getEventsNode():
HTMLElement
Defined in: src/base/dialogs.tsx:390
Gets the node that receives events for the dialog. It's .ui-dialog-content, .modal, or .panel-body
Returns
HTMLElement
getFooterNode()
getFooterNode():
HTMLElement
Defined in: src/base/dialogs.tsx:395
Gets the footer element of the dialog
Returns
HTMLElement
getHeaderNode()
getHeaderNode():
HTMLElement
Defined in: src/base/dialogs.tsx:400
Gets the header element of the dialog
Returns
HTMLElement
onClose()
onClose(
handler,opt?):this
Defined in: src/base/dialogs.tsx:227
Adds an event handler that is called when the dialog is closed. If the opt.before is true, the handler is called before the dialog is closed and the closing can be cancelled by calling preventDefault on the event object.
Parameters
handler
(result?, e?) => void
The event handler function
opt?
Options to determine whether the handler should be called before the dialog is closed, and whether the handler should be called only once. The default for oneOff is true unless opt.before is true.
before?
boolean
oneOff?
boolean
Returns
this
The dialog instance
onOpen()
onOpen(
handler,opt?):this
Defined in: src/base/dialogs.tsx:283
Adds an event handler that is called when the dialog is opened. If the second parameter is true, the handler is called before the dialog is opened and the opening can be cancelled by calling preventDefault on the event object. Note that if the dialog is not yet initialized, the first argument must be the body element of the dialog.
Parameters
handler
(e?) => void
The event handler function
opt?
Options to determine whether the handler should be called before the dialog is opened, and whether the handler should be called only once. The default for oneOff is true unless opt.before is true.
before?
boolean
oneOff?
boolean
Returns
this
The dialog instance
open()
open():
Dialog
Defined in: src/base/dialogs.tsx:331
Opens the dialog
Returns
Dialog
title()
Call Signature
title():
string
Defined in: src/base/dialogs.tsx:353
Gets the title text of the dialog
Returns
string
Call Signature
title(
value):this
Defined in: src/base/dialogs.tsx:355
Sets the title text of the dialog.
Parameters
value
string
Returns
this
getInstance()
staticgetInstance(el):Dialog
Defined in: src/base/dialogs.tsx:177
Gets the dialog instance for the specified element.
Parameters
el
The dialog body element (.s-Panel, .ui-dialog-content, or .modal-body) or the root element (.modal, .ui-dialog, .s-Panel)
HTMLElement | ArrayLike<HTMLElement>
Returns
Dialog
The dialog instance, or null if the element is not a dialog.
onClose()
staticonClose(el,handler,opt?):void
Defined in: src/base/dialogs.tsx:252
Adds an event handler that is called when the dialog is closed. If the opt.before is true, the handler is called before the dialog is closed and the closing can be cancelled by calling preventDefault on the event object. Note that if the dialog is not yet initialized, the first argument must be the body element of the dialog.
Parameters
el
The dialog body element (.s-Panel, .ui-dialog-content, or .modal-body)
HTMLElement | ArrayLike<HTMLElement>
handler
(result?, e?) => void
The event handler function
opt?
Options to determine whether the handler should be called before the dialog is closed, and whether the handler should be called only once. The default for oneOff is true unless opt.before is true.
before?
boolean
oneOff?
boolean
Returns
void
onOpen()
staticonOpen(el,handler,opt?):void
Defined in: src/base/dialogs.tsx:308
Adds an event handler that is called when the dialog is opened. If the second parameter is true, the handler is called before the dialog is opened and the opening can be cancelled by calling preventDefault on the event object. Note that if the dialog is not yet initialized, the first argument must be the body element of the dialog.
Parameters
el
The dialog body element (.s-Panel, .ui-dialog-content, or .modal-body)
HTMLElement | ArrayLike<HTMLElement>
handler
(e?) => void
The event handler function
opt?
Options to determine whether the handler should be called before the dialog is opened, and whether the handler should be called only once. The default for oneOff is true unless opt.before is true.
before?
boolean
oneOff?
boolean
Returns
void
The dialog instance