Alert Dialog
A dialog that requires a user response to proceed.
import { AlertDialog } from 'base-ui-solid/alert-dialog';
import styles from './index.module.css';
export default function ExampleAlertDialog() {
return (
<AlertDialog.Root>
<AlertDialog.Trigger data-color="red" class={styles.Button}>
Discard draft
</AlertDialog.Trigger>
<AlertDialog.Portal>
<AlertDialog.Backdrop class={styles.Backdrop} />
<AlertDialog.Popup class={styles.Popup}>
<div class={styles.Intro}>
<AlertDialog.Title class={styles.Title}>Discard draft?</AlertDialog.Title>
<AlertDialog.Description class={styles.Description}>
You can't undo this action.
</AlertDialog.Description>
</div>
<div class={styles.Actions}>
<AlertDialog.Close class={styles.Button}>Cancel</AlertDialog.Close>
<AlertDialog.Close data-color="red" class={styles.Button}>
Discard
</AlertDialog.Close>
</div>
</AlertDialog.Popup>
</AlertDialog.Portal>
</AlertDialog.Root>
);
}
Anatomy
Import the component and assemble its parts:
import { AlertDialog } from 'base-ui-solid/alert-dialog';
<AlertDialog.Root>
<AlertDialog.Trigger />
<AlertDialog.Portal>
<AlertDialog.Backdrop />
<AlertDialog.Viewport>
<AlertDialog.Popup>
<AlertDialog.Title />
<AlertDialog.Description />
<AlertDialog.Close />
</AlertDialog.Popup>
</AlertDialog.Viewport>
</AlertDialog.Portal>
</AlertDialog.Root>;
Examples
Open from a menu
In order to open a dialog using a menu, control the dialog state and open it imperatively using the onClick handler on the menu item.
import { createSignal } from 'solid-js';
import type { JSX } from '@solidjs/web';
import { AlertDialog } from 'base-ui-solid/alert-dialog';
import { Menu } from 'base-ui-solid/menu';
import styles from './index.module.css';
export default function ExampleAlertDialog() {
const [dialogOpen, setDialogOpen] = createSignal(false);
return (
<>
<Menu.Root>
<Menu.Trigger class={styles.Button}>
Playlist <CaretDownIcon />
</Menu.Trigger>
<Menu.Portal>
<Menu.Positioner class={styles.Positioner} sideOffset={8} align="start">
<Menu.Popup class={styles.MenuPopup}>
<Menu.Item class={styles.MenuItem}>Play</Menu.Item>
<Menu.Item class={styles.MenuItem}>Share</Menu.Item>
<Menu.Separator class={styles.Separator} />
{/* Open the alert dialog when the menu item is clicked */}
<Menu.Item class={styles.MenuItem} onClick={() => setDialogOpen(true)}>
Delete…
</Menu.Item>
</Menu.Popup>
</Menu.Positioner>
</Menu.Portal>
</Menu.Root>
{/* Control the alert dialog state */}
<AlertDialog.Root open={dialogOpen()} onOpenChange={setDialogOpen}>
<AlertDialog.Portal>
<AlertDialog.Backdrop class={styles.Backdrop} />
<AlertDialog.Popup class={styles.DialogPopup}>
<div class={styles.Intro}>
<AlertDialog.Title class={styles.Title}>Delete playlist?</AlertDialog.Title>
<AlertDialog.Description class={styles.Description}>
You can't undo this action.
</AlertDialog.Description>
</div>
<div class={styles.Actions}>
<AlertDialog.Close class={styles.Button}>Cancel</AlertDialog.Close>
<AlertDialog.Close data-color="red" class={styles.Button}>
Delete
</AlertDialog.Close>
</div>
</AlertDialog.Popup>
</AlertDialog.Portal>
</AlertDialog.Root>
</>
);
}
function CaretDownIcon(props: JSX.IntrinsicElements['svg']) {
return (
<svg
width="16"
height="16"
viewBox="0 0 16 16"
fill="currentColor"
{...props}
style={
typeof props.style === 'string'
? `display: block; ${props.style}`
: { display: 'block', ...(typeof props.style === 'object' ? props.style : {}) }
}
>
<path d="M12 6H4l4 4.5z" />
</svg>
);
}
Close confirmation
This example shows a nested confirmation dialog that opens if the text entered in the parent dialog is going to be discarded.
To implement this, both dialogs should be controlled. The confirmation dialog may be opened when onOpenChange callback of the parent dialog receives a request to close. This way, the confirmation is automatically shown when the user clicks the backdrop, presses the Esc key, or clicks a close button.
Use the [data-nested-dialog-open] selector and the var(--nested-dialogs) CSS variable to customize the styling of the parent dialog. Backdrops of the child dialogs won’t be rendered so that you can present the parent dialog in a clean way behind the one on top of it.
import { createSignal, createUniqueId } from 'solid-js';
import { AlertDialog } from 'base-ui-solid/alert-dialog';
import { Dialog } from 'base-ui-solid/dialog';
import styles from './index.module.css';
export default function ExampleDialog() {
const [dialogOpen, setDialogOpen] = createSignal(false);
const [confirmationOpen, setConfirmationOpen] = createSignal(false);
const [textareaValue, setTextareaValue] = createSignal('');
const titleId = createUniqueId();
return (
<Dialog.Root
open={dialogOpen()}
onOpenChange={(open) => {
// Show the close confirmation if there’s text in the textarea
if (!open && textareaValue()) {
setConfirmationOpen(true);
} else {
// Reset the text area value
setTextareaValue('');
// Open or close the dialog normally
setDialogOpen(open);
}
}}
>
<Dialog.Trigger class={styles.Button}>Tweet</Dialog.Trigger>
<Dialog.Portal>
<Dialog.Backdrop class={styles.Backdrop} />
<Dialog.Popup class={styles.Popup}>
<div class={styles.PopupBody}>
<Dialog.Title id={titleId} class={styles.Title}>
New tweet
</Dialog.Title>
<form
class={styles.TextareaContainer}
onSubmit={(event) => {
event.preventDefault();
// Close the dialog when submitting
setDialogOpen(false);
}}
>
<textarea
aria-labelledby={titleId}
required
class={styles.Textarea}
placeholder="What’s on your mind?"
value={textareaValue()}
onInput={(event) => setTextareaValue(event.target.value)}
/>
<div class={styles.Actions}>
<Dialog.Close class={styles.Button}>Cancel</Dialog.Close>
<button type="submit" class={styles.Button}>
Tweet
</button>
</div>
</form>
</div>
</Dialog.Popup>
</Dialog.Portal>
{/* Confirmation dialog */}
<AlertDialog.Root open={confirmationOpen()} onOpenChange={setConfirmationOpen}>
<AlertDialog.Portal>
<AlertDialog.Popup class={styles.Popup}>
<div class={styles.Intro}>
<AlertDialog.Title class={styles.Title}>Discard tweet?</AlertDialog.Title>
<AlertDialog.Description class={styles.Description}>
Your tweet will be lost.
</AlertDialog.Description>
</div>
<div class={styles.Actions}>
<AlertDialog.Close class={styles.Button}>Go back</AlertDialog.Close>
<button
type="button"
class={styles.Button}
onClick={() => {
setConfirmationOpen(false);
setDialogOpen(false);
}}
>
Discard
</button>
</div>
</AlertDialog.Popup>
</AlertDialog.Portal>
</AlertDialog.Root>
</Dialog.Root>
);
}
Detached triggers
An alert dialog can be controlled by a trigger located either inside or outside the <AlertDialog.Root> component.
For simple, one-off interactions, place the <AlertDialog.Trigger> inside <AlertDialog.Root>, as shown in the example at the top of this page.
However, if defining the alert dialog’s content next to its trigger is not practical, you can use a detached trigger.
This involves placing the <AlertDialog.Trigger> outside of <AlertDialog.Root> and linking them with a handle created by the AlertDialog.createHandle() function.
The imperative methods on the handle, such as open() and openWithPayload(), require an <AlertDialog.Root> using the same handle to be mounted.
Calls made while no root is attached to the handle — before one mounts, or after it unmounts — are ignored. Each time a root mounts, it starts from fresh state: a call made while no root was attached is not replayed, and no open state carries over from a previous mount.
const demoAlertDialog = AlertDialog.createHandle();
<AlertDialog.Trigger handle={demoAlertDialog}>Open</AlertDialog.Trigger>
<AlertDialog.Root handle={demoAlertDialog}>
...
</AlertDialog.Root>
import { AlertDialog } from 'base-ui-solid/alert-dialog';
import styles from './index.module.css';
const demoAlertDialog = AlertDialog.createHandle();
export default function AlertDialogDetachedTriggersSimpleDemo() {
return (
<>
<AlertDialog.Trigger
class={`${styles.Button} ${styles.DangerButton}`}
handle={demoAlertDialog}
>
Discard draft
</AlertDialog.Trigger>
<AlertDialog.Root handle={demoAlertDialog}>
<AlertDialog.Portal>
<AlertDialog.Backdrop class={styles.Backdrop} />
<AlertDialog.Popup class={styles.Popup}>
<div class={styles.Intro}>
<AlertDialog.Title class={styles.Title}>Discard draft?</AlertDialog.Title>
<AlertDialog.Description class={styles.Description}>
This action cannot be undone.
</AlertDialog.Description>
</div>
<div class={styles.Actions}>
<AlertDialog.Close class={styles.Button}>Cancel</AlertDialog.Close>
<AlertDialog.Close class={`${styles.Button} ${styles.DangerButton}`}>
Discard
</AlertDialog.Close>
</div>
</AlertDialog.Popup>
</AlertDialog.Portal>
</AlertDialog.Root>
</>
);
}
Multiple triggers
A single alert dialog can be opened by multiple trigger elements.
You can achieve this by using the same handle for several detached triggers, or by placing multiple <AlertDialog.Trigger> components inside a single <AlertDialog.Root>.
<AlertDialog.Root>
<AlertDialog.Trigger>Trigger 1</AlertDialog.Trigger>
<AlertDialog.Trigger>Trigger 2</AlertDialog.Trigger>
...
</AlertDialog.Root>
const demoAlertDialog = AlertDialog.createHandle();
<AlertDialog.Trigger handle={demoAlertDialog}>Trigger 1</AlertDialog.Trigger>
<AlertDialog.Trigger handle={demoAlertDialog}>Trigger 2</AlertDialog.Trigger>
<AlertDialog.Root handle={demoAlertDialog}>
...
</AlertDialog.Root>
The alert dialog can render different content depending on which trigger opened it.
This is achieved by passing a payload to the <AlertDialog.Trigger> and using the function-as-a-child pattern in <AlertDialog.Root>.
The payload can be strongly typed by providing a type argument to the createHandle() function:
const demoAlertDialog = AlertDialog.createHandle<{ message: string }>();
<AlertDialog.Trigger handle={demoAlertDialog} payload={{ message: 'Trigger 1' }}>
Trigger 1
</AlertDialog.Trigger>
<AlertDialog.Trigger handle={demoAlertDialog} payload={{ message: 'Trigger 2' }}>
Trigger 2
</AlertDialog.Trigger>
<AlertDialog.Root handle={demoAlertDialog}>
{({ payload }) => (
<AlertDialog.Portal>
<AlertDialog.Popup>
<AlertDialog.Title>Alert dialog</AlertDialog.Title>
{payload !== undefined && (
<AlertDialog.Description>
Confirming {payload.message}
</AlertDialog.Description>
)}
</AlertDialog.Popup>
</AlertDialog.Portal>
)}
</AlertDialog.Root>
Controlled mode with multiple triggers
You can control the alert dialog’s open state externally using the open and onOpenChange props on <AlertDialog.Root>.
This allows you to manage the alert dialog’s visibility based on your application’s state.
When using multiple triggers, you have to manage which trigger is active with the triggerId prop on <AlertDialog.Root> and the id prop on each <AlertDialog.Trigger>.
Note that there is no separate onTriggerIdChange prop.
Instead, the onOpenChange callback receives an additional argument, eventDetails, which contains the trigger element that initiated the state change.
import { createSignal } from 'solid-js';
import { AlertDialog } from 'base-ui-solid/alert-dialog';
import styles from './index.module.css';
type AlertPayload = { message: string };
const demoAlertDialog = AlertDialog.createHandle<AlertPayload>();
export default function AlertDialogDetachedTriggersControlledDemo() {
const [open, setOpen] = createSignal(false);
const [triggerId, setTriggerId] = createSignal<string | null>(null);
const handleOpenChange = (isOpen: boolean, eventDetails: AlertDialog.Root.ChangeEventDetails) => {
setOpen(isOpen);
setTriggerId(eventDetails.trigger?.id ?? null);
};
return (
<>
<div class={styles.Container}>
<AlertDialog.Trigger
class={`${styles.Button} ${styles.DangerButton}`}
handle={demoAlertDialog}
id="alert-trigger-1"
payload={{ message: 'Discard draft?' }}
>
Discard
</AlertDialog.Trigger>
<AlertDialog.Trigger
class={`${styles.Button} ${styles.DangerButton}`}
handle={demoAlertDialog}
id="alert-trigger-2"
payload={{ message: 'Delete project?' }}
>
Delete
</AlertDialog.Trigger>
<AlertDialog.Trigger
class={styles.Button}
handle={demoAlertDialog}
id="alert-trigger-3"
payload={{ message: 'Sign out?' }}
>
Sign out
</AlertDialog.Trigger>
<button
class={styles.Button}
type="button"
onClick={() => {
setTriggerId('alert-trigger-2');
setOpen(true);
}}
>
Open programmatically
</button>
</div>
<AlertDialog.Root<AlertPayload>
handle={demoAlertDialog}
open={open()}
onOpenChange={handleOpenChange}
triggerId={triggerId()}
>
{(state) => (
<AlertDialog.Portal>
<AlertDialog.Backdrop class={styles.Backdrop} />
<AlertDialog.Popup class={styles.Popup}>
<div class={styles.Intro}>
<AlertDialog.Title class={styles.Title}>
{state.payload?.message ?? 'Are you sure?'}
</AlertDialog.Title>
<AlertDialog.Description class={styles.Description}>
This action cannot be undone.
</AlertDialog.Description>
</div>
<div class={styles.Actions}>
<AlertDialog.Close class={styles.Button}>Cancel</AlertDialog.Close>
<AlertDialog.Close class={`${styles.Button} ${styles.DangerButton}`}>
Confirm
</AlertDialog.Close>
</div>
</AlertDialog.Popup>
</AlertDialog.Portal>
)}
</AlertDialog.Root>
</>
);
}
API reference
Root
Groups all parts of the alert dialog. Doesn’t render its own HTML element.
defaultOpenbooleanfalse
open prop instead.booleanopenboolean—
booleanonOpenChangefunction—
((open: boolean, eventDetails: AlertDialog.Root.ChangeEventDetails) => void)actionsRefRefObject<AlertDialog.Root.Actions | null>—
unmount: Ends the closing phase of the alert dialog after an externally controlled closing animation finishes.
Call preventUnmountOnClose() in onOpenChange first, otherwise the alert dialog completes closing on its own.
Whether it leaves the DOM is decided by keepMounted on the portal.close: Closes the alert dialog imperatively when called.RefObject<AlertDialog.Root.Actions | null>defaultTriggerIdUnion—
defaultOpen prop to create an initially open dialog.string | nullhandleAlertDialog.Handle<Payload>—
AlertDialog.Handle<Payload>onOpenChangeCompletefunction—
((open: boolean) => void)triggerIdUnion—
open prop to create a controlled dialog.
There’s no need to specify this prop when the dialog is uncontrolled (that is, when the open prop is not set).string | nullchildrenUnion—
payload of the active trigger.JSX.Element | PayloadChildRenderFunction<Payload>Root.State
type AlertDialogRootState = {};Root.Actions
type AlertDialogRootActions = { unmount: () => void; close: () => void };Root.ChangeEventReason
type AlertDialogRootChangeEventReason =
| 'trigger-press'
| 'outside-press'
| 'escape-key'
| 'close-press'
| 'focus-out'
| 'imperative-action'
| 'none';Root.ChangeEventDetails
type AlertDialogRootChangeEventDetails = (
| { reason: 'trigger-press'; event: MouseEvent | PointerEvent | TouchEvent | KeyboardEvent }
| { reason: 'outside-press'; event: MouseEvent | PointerEvent | TouchEvent }
| { reason: 'escape-key'; event: KeyboardEvent }
| { reason: 'close-press'; event: MouseEvent | PointerEvent | KeyboardEvent }
| { reason: 'focus-out'; event: KeyboardEvent | FocusEvent }
| { reason: 'imperative-action'; event: Event }
| { reason: 'none'; event: Event }
) & {
/** Cancels Base UI from handling the event. */
cancel: () => void;
/** Allows the event to propagate in cases where Base UI will stop the propagation. */
allowPropagation: () => void;
/** Indicates whether the event has been canceled. */
isCanceled: boolean;
/** Indicates whether the event is allowed to propagate. */
isPropagationAllowed: boolean;
/** The element that triggered the event, if applicable. */
trigger: Element | undefined;
/** Prevents the popup from unmounting until the `unmount` action is called. */
preventUnmountOnClose: () => void;
};Trigger
A button that opens the alert dialog.
Renders a <button> element.
handleAlertDialog.Handle<Payload>—
AlertDialog.Handle<Payload>nativeButtonbooleantrue
<button> element when replacing it
via the render prop.
Set to false if the rendered element is not a button (for example, <div>).booleanpayloadPayload—
Payloadidstring—
triggerId prop).stringclassfunction—
JSX.ClassValue | ((state) => JSX.ClassValue)stylefunction—
JSX.CSSProperties | string | ((state) => JSX.CSSProperties | string | undefined)renderfunction—
keyof JSX.IntrinsicElements | Component | ((props, state) => JSX.Element)Data attributes
data-popup-open-—
-data-disabled-—
-Attribute | Description | |
|---|---|---|
data-popup-open | Present when the corresponding alert dialog is open. | |
data-disabled | Present when the trigger is disabled. | |
Trigger.State
type AlertDialogTriggerState = {
/** Whether the trigger is currently disabled. */
disabled: boolean;
/** Whether the dialog is currently open and was opened by this trigger. */
open: boolean;
};Portal
A portal element that moves the popup to a different part of the DOM.
By default, the portal element is appended to <body>.
Renders a <div> element.
containerUnion—
HTMLElement | ShadowRoot | RefObject<HTMLElement | ShadowRoot | null> | nullclassfunction—
JSX.ClassValue | ((state) => JSX.ClassValue)stylefunction—
JSX.CSSProperties | string | ((state) => JSX.CSSProperties | string | undefined)keepMountedbooleanfalse
booleanrenderfunction—
keyof JSX.IntrinsicElements | Component | ((props, state) => JSX.Element)Portal.State
type AlertDialogPortalState = {};Backdrop
An overlay displayed beneath the popup.
Renders a <div> element.
forceRenderbooleanfalse
booleanclassfunction—
JSX.ClassValue | ((state) => JSX.ClassValue)stylefunction—
JSX.CSSProperties | string | ((state) => JSX.CSSProperties | string | undefined)renderfunction—
keyof JSX.IntrinsicElements | Component | ((props, state) => JSX.Element)Data attributes
data-open-—
-data-closed-—
-data-starting-style-—
-data-ending-style-—
-Attribute | Description | |
|---|---|---|
data-open | Present when the dialog is open. | |
data-closed | Present when the dialog is closed. | |
data-starting-style | Present when the dialog begins animating in. | |
data-ending-style | Present when the dialog is animating out. | |
Backdrop.State
type AlertDialogBackdropState = {
/** Whether the dialog is currently open. */
open: boolean;
/** The transition status of the component. */
transitionStatus: TransitionStatus;
};Viewport
A positioning container for the dialog popup that can be made scrollable.
Renders a <div> element.
classfunction—
JSX.ClassValue | ((state) => JSX.ClassValue)stylefunction—
JSX.CSSProperties | string | ((state) => JSX.CSSProperties | string | undefined)renderfunction—
keyof JSX.IntrinsicElements | Component | ((props, state) => JSX.Element)Data attributes
data-open-—
-data-closed-—
-data-nested-—
-data-nested-dialog-open-—
-data-starting-style-—
-data-ending-style-—
-Attribute | Description | |
|---|---|---|
data-open | Present when the dialog is open. | |
data-closed | Present when the dialog is closed. | |
data-nested | Present when the dialog is nested within another dialog. | |
data-nested-dialog-open | Present when the dialog has other open dialogs nested within it. | |
data-starting-style | Present when the dialog begins animating in. | |
data-ending-style | Present when the dialog is animating out. | |
Viewport.State
type AlertDialogViewportState = {
/** Whether the dialog is currently open. */
open: boolean;
/** The transition status of the component. */
transitionStatus: TransitionStatus;
/** Whether the dialog is nested within another dialog. */
nested: boolean;
/** Whether the dialog has nested dialogs open. */
nestedDialogOpen: boolean;
};Popup
A container for the dialog contents.
Renders a <div> element.
initialFocusfunction—
false: Do not move focus.true: Move focus based on the default behavior (first tabbable element or popup).RefObject: Move focus to the ref element.function: Called with the interaction type (mouse, touch, pen, or keyboard).
Return an element to focus, true to use the default behavior, null to fall back to the default behavior, or false/undefined to do nothing.boolean | RefObject<HTMLElement | null> | ((openType: InteractionType) => boolean | void | HTMLElement | null)finalFocusfunction—
false: Do not move focus.true: Move focus based on the default behavior (trigger or previously focused element).RefObject: Move focus to the ref element.function: Called with the interaction type (mouse, touch, pen, or keyboard).
Return an element to focus, true to use the default behavior, null to fall back to the default behavior, or false/undefined to do nothing.boolean | RefObject<HTMLElement | null> | ((closeType: InteractionType) => boolean | void | HTMLElement | null)classfunction—
JSX.ClassValue | ((state) => JSX.ClassValue)stylefunction—
JSX.CSSProperties | string | ((state) => JSX.CSSProperties | string | undefined)renderfunction—
keyof JSX.IntrinsicElements | Component | ((props, state) => JSX.Element)Data attributes
data-open-—
-data-closed-—
-data-nested-—
-data-nested-dialog-open-—
-data-starting-style-—
-data-ending-style-—
-Attribute | Description | |
|---|---|---|
data-open | Present when the dialog is open. | |
data-closed | Present when the dialog is closed. | |
data-nested | Present when the dialog is nested within another dialog. | |
data-nested-dialog-open | Present when the dialog has other open dialogs nested within it. | |
data-starting-style | Present when the dialog begins animating in. | |
data-ending-style | Present when the dialog is animating out. | |
CSS variables
--nested-dialogsnumber—
numberCSS Variable | Description | |
|---|---|---|
--nested-dialogs | Indicates how many dialogs are nested within. | |
Popup.State
type AlertDialogPopupState = {
/** Whether the dialog is currently open. */
open: boolean;
/** The transition status of the component. */
transitionStatus: TransitionStatus;
/** Whether the dialog is nested within a parent dialog. */
nested: boolean;
/** Whether the dialog has nested dialogs open. */
nestedDialogOpen: boolean;
};Title
A heading that labels the dialog.
Renders an <h2> element.
classfunction—
JSX.ClassValue | ((state) => JSX.ClassValue)stylefunction—
JSX.CSSProperties | string | ((state) => JSX.CSSProperties | string | undefined)renderfunction—
keyof JSX.IntrinsicElements | Component | ((props, state) => JSX.Element)Title.State
type AlertDialogTitleState = {};Description
A paragraph with additional information about the dialog.
Renders a <p> element.
classfunction—
JSX.ClassValue | ((state) => JSX.ClassValue)stylefunction—
JSX.CSSProperties | string | ((state) => JSX.CSSProperties | string | undefined)renderfunction—
keyof JSX.IntrinsicElements | Component | ((props, state) => JSX.Element)Description.State
type AlertDialogDescriptionState = {};Close
A button that closes the dialog.
Renders a <button> element.
nativeButtonbooleantrue
<button> element when replacing it
via the render prop.
Set to false if the rendered element is not a button (for example, <div>).booleanclassfunction—
JSX.ClassValue | ((state) => JSX.ClassValue)stylefunction—
JSX.CSSProperties | string | ((state) => JSX.CSSProperties | string | undefined)renderfunction—
keyof JSX.IntrinsicElements | Component | ((props, state) => JSX.Element)Data attributes
data-disabled-—
-Attribute | Description | |
|---|---|---|
data-disabled | Present when the button is disabled. | |
Close.State
type AlertDialogCloseState = {
/** Whether the button is currently disabled. */
disabled: boolean;
};createHandle
Creates a new handle to connect an AlertDialog.Root with detached AlertDialog.Trigger components.
createHandle
type ReturnValue = AlertDialog.Handle<Payload>;
Handle
Controls an Alert Dialog imperatively and associates detached AlertDialog.Trigger components with
an AlertDialog.Root. Create one with AlertDialog.createHandle() and pass it to the handle
prop of the root and of any triggers rendered outside of it.
The imperative methods take effect only while a root using this handle is mounted; calls made
before a root attaches (or after it unmounts) are ignored.
Handle
function open(triggerId: string | null): void;
Handle
function openWithPayload(payload: Payload): void;
Handle
function close(): void;