NotificationUI
Description
Methods
createToastElement
notificationUI.createToastElement(options, closeLabel, animation) ⇒ Object
Builds a toast element from normalized options.
| Param | Type | Description |
|---|---|---|
| options | object | Normalized notification options (id, variant, title, message, closable, actions). |
| closeLabel | string | Translated label for the close control. |
| animation | boolean | Whether enter animation is enabled. |
destroy
notificationUI.destroy()
Detaches the host from the DOM and clears internal stack references.
getFocusables
NotificationUI.getFocusables(toastEl) ⇒ Array<HTMLElement>
| Param | Type | Description |
|---|---|---|
| toastEl | HTMLElement | Toast root element. |
getHost
notificationUI.getHost() ⇒ HTMLElement | null
getStack
notificationUI.getStack(position) ⇒ HTMLElement | undefined
| Param | Type | Description |
|---|---|---|
| position | string | Stack key. |
install
notificationUI.install()
Creates the notification host and four corner stack elements inside the overlays layer (ht-overlay).
setRtl
notificationUI.setRtl(isRtl)
Updates RTL direction on the host.
| Param | Type | Description |
|---|---|---|
| isRtl | boolean | Whether the grid uses RTL layout. |
setSanitizer
notificationUI.setSanitizer(sanitizer)
Updates the HTML sanitizer used for string notification messages.
| Param | Type | Description |
|---|---|---|
| sanitizer | function | Sanitizer from Handsontable settings, if any. |
setSequentialFocusWithinHost
NotificationUI.setSequentialFocusWithinHost(host, enabled)
Enables or disables sequential keyboard focus for notification controls. When disabled, controls stay
out of the tab order so opening a toast does not move focus; screen readers still receive aria-live updates.
| Param | Type | Description |
|---|---|---|
| host | HTMLElement null | Notification plugin host element. |
| enabled | boolean | Whether controls participate in tab navigation. |