Dialog

Options

dialog

Ask AI

Source code

dialog.dialog : boolean | object

The dialog option configures the Dialog plugin.

You can set the dialog option to one of the following:

Setting	Description
false	Disable the Dialog plugin
true	Enable the Dialog plugin with default options

dialog: Additional options

Option	Possible settings	Description
template	Object with the template configuration (default: null).	The template of the dialog allows to use prebuild templates
template.type	The type of the template (‘confirm’)	The type of the template
template.title	The title of the template	The title of the template
template.description	The description of the template	The description of the template
template.buttons	Array of objects with the buttons configuration (default: [])	The buttons of the template
template.buttons.text	The text of the button	The text of the button
template.buttons.type	The type of the button (‘primary'	'secondary’)
template.buttons.callback	The callback function to trigger when the button is clicked	The callback function to trigger when the button is clicked
content	A string, HTMLElement or DocumentFragment (default: '')	The content of the dialog
customClassName	A string (default: '')	The custom class name of the dialog
background	One of the options: 'solid' or 'semi-transparent' (default: 'solid')	The background of the dialog
contentBackground	Boolean (default: false)	Whether to show the content background
animation	Boolean (default: true)	Whether to show the animation
closable	Boolean (default: false)	Whether to make the dialog closable
a11y	Object with accessibility options (default: { role: 'dialog', ariaLabel: 'Dialog', ariaLabelledby: '', ariaDescribedby: '' })	Accessibility options for the dialog
a11y.role	The role of the dialog (‘dialog'	'alertdialog’)
a11y.ariaLabel	The label of the dialog	The label of the dialog
a11y.ariaLabelledby	The ID of the element that labels the dialog	The ID of the element that labels the dialog
a11y.ariaDescribedby	The ID of the element that describes the dialog	The ID of the element that describes the dialog

Read more:

This option can only be set at the grid level. It has no effect when set in the columns, cells, or cell options.

Default: false
Since: 16.1.0
Example

Members

DEFAULT_SETTINGS

Ask AI

Source code

Dialog.DEFAULT_SETTINGS

Returns the default settings applied when the plugin is enabled without explicit configuration.

PLUGIN_KEY

Ask AI

Source code

Dialog.PLUGIN_KEY

Returns the plugin key used to identify this plugin in Handsontable settings.

PLUGIN_PRIORITY

Ask AI

Source code

Dialog.PLUGIN_PRIORITY

Returns the priority order used to determine the order in which plugins are initialized.

SETTINGS_VALIDATORS

Ask AI

Source code

Dialog.SETTINGS_VALIDATORS

Returns validator functions for each plugin setting to verify their values are valid before applying them.

Methods

destroy

Ask AI

Source code

dialog.destroy()

Destroy dialog and reset plugin state.

disablePlugin

Ask AI

Source code

dialog.disablePlugin()

Disable plugin for this Handsontable instance.

enablePlugin

Ask AI

Source code

dialog.enablePlugin()

Enable plugin for this Handsontable instance.

focus

Ask AI

Source code

dialog.focus()

Focus the dialog.

hide

Ask AI

Source code

dialog.hide()

Hide the currently open dialog. Closes the dialog and restores the focus to the table.

isEnabled

Ask AI

Source code

dialog.isEnabled() ⇒ boolean

Check if the plugin is enabled in the handsontable settings.

isVisible

Ask AI

Source code

dialog.isVisible() ⇒ boolean

Check if the dialog is currently visible.

Returns: boolean - True if the dialog is visible, false otherwise.

show

Ask AI

Source code

dialog.show(options)

Show dialog with given configuration. Displays the dialog with the specified content and options.

Param	Type	Description
options	object	Dialog configuration object containing content and display options.
options.template	object	The template to use for the dialog (default: null). The error will be thrown when the template is provided together with the content option.
options.template.type	'confirm'	The type of the template (‘confirm’).
options.template.title	string	The title of the dialog.
options.template.description	string	The description of the dialog. Default: ”.
options.template.buttons	Array<object>	The buttons to display in the dialog. Default: [].
options.template.buttons.text	string	The text of the button.
options.template.buttons.type	'primary' 'secondary'	The type of the button.
options.template.buttons.callback	function	The callback to trigger when the button is clicked.
options.content	string HTMLElement DocumentFragment	The content to display in the dialog. Can be a string, HTMLElement, or DocumentFragment. Default: ”
options.customClassName	string	Custom CSS class name to apply to the dialog container. Default: ”
options.background	'solid' 'semi-transparent'	Dialog background variant. Default: ‘solid’.
options.contentBackground	boolean	Whether to show content background. Default: false.
options.animation	boolean	Whether to enable animations when showing/hiding the dialog. Default: true.
options.closable	boolean	Whether the dialog can be closed by user interaction. Default: false.
options.a11y	object	Object with accessibility options.
options.a11y.role	string	The role of the dialog. Default: ‘dialog’.
options.a11y.ariaLabel	string	The label of the dialog. Default: ‘Dialog’.
options.a11y.ariaLabelledby	string	The ID of the element that labels the dialog. Default: ”.
options.a11y.ariaDescribedby	string	The ID of the element that describes the dialog. Default: ”.

showAlert

Ask AI

Source code

dialog.showAlert(message, [callback])

Displays the alert dialog with the specified content.

Param	Type	Description
message	string Object	The message to display in the dialog. Can be a string or an object with title and description properties.
[callback]	function	optional The callback to trigger when the button is clicked.

showConfirm

Ask AI

Source code

dialog.showConfirm(message, [onOk], [onCancel])

Displays the confirm dialog with the specified content and options.

Param	Type	Description
message	string Object	The message to display in the dialog. Can be a string or an object with title and description properties.
[onOk]	function	optional The callback to trigger when the OK button is clicked.
[onCancel]	function	optional The callback to trigger when the Cancel button is clicked.

update

Ask AI

Source code

dialog.update(options)

Update the dialog configuration.

Param	Type	Description
options	object	Dialog configuration object containing content and display options.
options.template	object	The template to use for the dialog (default: null). The error will be thrown when the template is provided together with the content option.
options.template.type	'confirm'	The type of the template (‘confirm’).
options.template.title	string	The title of the dialog.
options.template.description	string	The description of the dialog. Default: ”.
options.template.buttons	Array<object>	The buttons to display in the dialog. Default: [].
options.template.buttons.text	string	The text of the button.
options.template.buttons.type	'primary' 'secondary'	The type of the button.
options.template.buttons.callback	function	The callback to trigger when the button is clicked.
options.content	string HTMLElement DocumentFragment	The content to display in the dialog. Can be a string, HTMLElement, or DocumentFragment. Default: ”
options.customClassName	string	Custom CSS class name to apply to the dialog container. Default: ”
options.background	'solid' 'semi-transparent'	Dialog background variant. Default: ‘solid’.
options.contentBackground	boolean	Whether to show content background. Default: false.
options.animation	boolean	Whether to enable animations when showing/hiding the dialog. Default: true.
options.closable	boolean	Whether the dialog can be closed by user interaction. Default: false.
options.a11y	object	Object with accessibility options.
options.a11y.role	string	The role of the dialog. Default: ‘dialog’.
options.a11y.ariaLabel	string	The label of the dialog. Default: ‘Dialog’.
options.a11y.ariaLabelledby	string	The ID of the element that labels the dialog. Default: ”.
options.a11y.ariaDescribedby	string	The ID of the element that describes the dialog. Default: ”.

updatePlugin

Ask AI

Source code

dialog.updatePlugin()

Update plugin state after Handsontable settings update.