Alert Dialog

Overview

A confirmation dialog that blocks interaction until the user acknowledges it. Unlike Dialog, clicking the background overlay won’t dismiss it — the user must choose an action.

Usage

Import the components:

import {
  AlertDialog,
  AlertDialogAction,
  AlertDialogCancel,
  AlertDialogContent,
  AlertDialogDescription,
  AlertDialogFooter,
  AlertDialogHeader,
  AlertDialogTitle,
  AlertDialogTrigger,
} from "@eqtylab/equality";

<AlertDialog>
  <AlertDialogTrigger asChild>
    <Button>Delete Item</Button>
  </AlertDialogTrigger>
  <AlertDialogContent>
    <AlertDialogHeader>
      <AlertDialogTitle>Are you sure?</AlertDialogTitle>
      <AlertDialogDescription>
        This action cannot be undone. This will permanently delete the item.
      </AlertDialogDescription>
    </AlertDialogHeader>
    <AlertDialogFooter>
      <AlertDialogCancel>Cancel</AlertDialogCancel>
      <AlertDialogAction>Delete</AlertDialogAction>
    </AlertDialogFooter>
  </AlertDialogContent>
</AlertDialog>

Variants

Action Button Variants

AlertDialogAction and AlertDialogCancel accept variant and size props from Button. Defaults are primary (action) and tertiary (cancel) at size sm.

Use danger for destructive confirmations:

<AlertDialogFooter>
  <AlertDialogCancel>Cancel</AlertDialogCancel>
  <AlertDialogAction variant="danger">Delete</AlertDialogAction>
</AlertDialogFooter>

Controlled State

Control the open state with open and onOpenChange:

const [open, setOpen] = useState(false);

<AlertDialog open={open} onOpenChange={setOpen}>
  <AlertDialogTrigger asChild>
    <Button>Open</Button>
  </AlertDialogTrigger>
  <AlertDialogContent>...</AlertDialogContent>
</AlertDialog>;

Slots

Props

AlertDialog

AlertDialogAction

AlertDialogCancel