Skip to content
WebJs
Menu

Alert Dialog

A modal dialog that interrupts the user with important content and expects a response.

Are you absolutely sure?

This action cannot be undone. This will permanently delete your account from our servers.

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';
import {
  alertDialogHeaderClass, alertDialogFooterClass, alertDialogTitleClass, alertDialogDescriptionClass,
} from '#components/ui/alert-dialog.ts';

export default function AlertDialogDemo() {
  return html`
    <ui-alert-dialog>
      <ui-alert-dialog-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Show Dialog</button>
      </ui-alert-dialog-trigger>
      <ui-alert-dialog-content>
        <div data-slot="alert-dialog-header" class=${alertDialogHeaderClass()}>
          <h2 data-slot="alert-dialog-title" class=${alertDialogTitleClass()}>Are you absolutely sure?</h2>
          <p data-slot="alert-dialog-description" class=${alertDialogDescriptionClass()}>
            This action cannot be undone. This will permanently delete your
            account from our servers.
          </p>
        </div>
        <div data-slot="alert-dialog-footer" class=${alertDialogFooterClass()}>
          <ui-alert-dialog-cancel>Cancel</ui-alert-dialog-cancel>
          <ui-alert-dialog-action>Continue</ui-alert-dialog-action>
        </div>
      </ui-alert-dialog-content>
    </ui-alert-dialog>
  `;
}
View Code

Installation

pnpm dlx @webjsdev/ui add alert-dialog

Usage

import {
  alertDialogHeaderClass,
  alertDialogFooterClass,
  alertDialogTitleClass,
  alertDialogDescriptionClass,
} from '#components/ui/alert-dialog.ts';
<ui-alert-dialog>
  <ui-alert-dialog-trigger>
    <button class=${buttonClass({ variant: 'outline' })}>Show Dialog</button>
  </ui-alert-dialog-trigger>
  <ui-alert-dialog-content>
    <div data-slot="alert-dialog-header" class=${alertDialogHeaderClass()}>
      <h2 data-slot="alert-dialog-title" class=${alertDialogTitleClass()}>Are you absolutely sure?</h2>
      <p data-slot="alert-dialog-description" class=${alertDialogDescriptionClass()}>
        This action cannot be undone. This will permanently delete your account
        from our servers.
      </p>
    </div>
    <div data-slot="alert-dialog-footer" class=${alertDialogFooterClass()}>
      <ui-alert-dialog-cancel>Cancel</ui-alert-dialog-cancel>
      <ui-alert-dialog-action>Continue</ui-alert-dialog-action>
    </div>
  </ui-alert-dialog-content>
</ui-alert-dialog>

Importing the module registers the <ui-alert-dialog> elements. The trigger wraps your own button, and the content renders a native <dialog> opened with showModal().

Composition

Use the following composition to build an alert dialog:

<ui-alert-dialog>
├── <ui-alert-dialog-trigger>
└── <ui-alert-dialog-content>
    ├── alertDialogHeaderClass()
    │   ├── alertDialogMediaClass()
    │   ├── alertDialogTitleClass()
    │   └── alertDialogDescriptionClass()
    └── alertDialogFooterClass()
        ├── <ui-alert-dialog-cancel>
        └── <ui-alert-dialog-action>

Basic

A basic alert dialog with a title, description, and cancel and continue buttons.

Are you absolutely sure?

This action cannot be undone. This will permanently delete your account and remove your data from our servers.

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';
import {
  alertDialogHeaderClass, alertDialogFooterClass, alertDialogTitleClass, alertDialogDescriptionClass,
} from '#components/ui/alert-dialog.ts';

export default function AlertDialogBasic() {
  return html`
    <ui-alert-dialog>
      <ui-alert-dialog-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Show Dialog</button>
      </ui-alert-dialog-trigger>
      <ui-alert-dialog-content>
        <div data-slot="alert-dialog-header" class=${alertDialogHeaderClass()}>
          <h2 data-slot="alert-dialog-title" class=${alertDialogTitleClass()}>Are you absolutely sure?</h2>
          <p data-slot="alert-dialog-description" class=${alertDialogDescriptionClass()}>
            This action cannot be undone. This will permanently delete your
            account and remove your data from our servers.
          </p>
        </div>
        <div data-slot="alert-dialog-footer" class=${alertDialogFooterClass()}>
          <ui-alert-dialog-cancel>Cancel</ui-alert-dialog-cancel>
          <ui-alert-dialog-action>Continue</ui-alert-dialog-action>
        </div>
      </ui-alert-dialog-content>
    </ui-alert-dialog>
  `;
}
View Code

Small

Use the size="sm" attribute on <ui-alert-dialog-content> to make the alert dialog smaller.

Allow accessory to connect?

Do you want to allow the USB accessory to connect to this device?

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';
import {
  alertDialogHeaderClass, alertDialogFooterClass, alertDialogTitleClass, alertDialogDescriptionClass,
} from '#components/ui/alert-dialog.ts';

export default function AlertDialogSmall() {
  return html`
    <ui-alert-dialog>
      <ui-alert-dialog-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Show Dialog</button>
      </ui-alert-dialog-trigger>
      <ui-alert-dialog-content size="sm">
        <div data-slot="alert-dialog-header" class=${alertDialogHeaderClass()}>
          <h2 data-slot="alert-dialog-title" class=${alertDialogTitleClass()}>Allow accessory to connect?</h2>
          <p data-slot="alert-dialog-description" class=${alertDialogDescriptionClass()}>
            Do you want to allow the USB accessory to connect to this device?
          </p>
        </div>
        <div data-slot="alert-dialog-footer" class=${alertDialogFooterClass()}>
          <ui-alert-dialog-cancel>Don't allow</ui-alert-dialog-cancel>
          <ui-alert-dialog-action>Allow</ui-alert-dialog-action>
        </div>
      </ui-alert-dialog-content>
    </ui-alert-dialog>
  `;
}
View Code

Media

Use alertDialogMediaClass() on an element marked data-slot="alert-dialog-media" to add a media element such as an icon or image to the alert dialog.

Share this project?

Anyone with the link will be able to view and edit this project.

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';
import {
  alertDialogHeaderClass, alertDialogFooterClass, alertDialogTitleClass, alertDialogDescriptionClass,
  alertDialogMediaClass,
} from '#components/ui/alert-dialog.ts';
import { CircleFadingPlusIcon } from '#lib/ui/lucide.ts';

export default function AlertDialogWithMedia() {
  return html`
    <ui-alert-dialog>
      <ui-alert-dialog-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Share Project</button>
      </ui-alert-dialog-trigger>
      <ui-alert-dialog-content>
        <div data-slot="alert-dialog-header" class=${alertDialogHeaderClass()}>
          <div data-slot="alert-dialog-media" aria-hidden="true" class=${alertDialogMediaClass()}>
            ${CircleFadingPlusIcon()}
          </div>
          <h2 data-slot="alert-dialog-title" class=${alertDialogTitleClass()}>Share this project?</h2>
          <p data-slot="alert-dialog-description" class=${alertDialogDescriptionClass()}>
            Anyone with the link will be able to view and edit this project.
          </p>
        </div>
        <div data-slot="alert-dialog-footer" class=${alertDialogFooterClass()}>
          <ui-alert-dialog-cancel>Cancel</ui-alert-dialog-cancel>
          <ui-alert-dialog-action>Share</ui-alert-dialog-action>
        </div>
      </ui-alert-dialog-content>
    </ui-alert-dialog>
  `;
}
View Code

Small with Media

Use the size="sm" attribute to make the alert dialog smaller and alertDialogMediaClass() to add a media element such as an icon or image to the alert dialog.

Allow accessory to connect?

Do you want to allow the USB accessory to connect to this device?

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';
import {
  alertDialogHeaderClass, alertDialogFooterClass, alertDialogTitleClass, alertDialogDescriptionClass,
  alertDialogMediaClass,
} from '#components/ui/alert-dialog.ts';
import { BluetoothIcon } from '#lib/ui/lucide.ts';

export default function AlertDialogSmallWithMedia() {
  return html`
    <ui-alert-dialog>
      <ui-alert-dialog-trigger>
        <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>Show Dialog</button>
      </ui-alert-dialog-trigger>
      <ui-alert-dialog-content size="sm">
        <div data-slot="alert-dialog-header" class=${alertDialogHeaderClass()}>
          <div data-slot="alert-dialog-media" aria-hidden="true" class=${alertDialogMediaClass()}>
            ${BluetoothIcon()}
          </div>
          <h2 data-slot="alert-dialog-title" class=${alertDialogTitleClass()}>Allow accessory to connect?</h2>
          <p data-slot="alert-dialog-description" class=${alertDialogDescriptionClass()}>
            Do you want to allow the USB accessory to connect to this device?
          </p>
        </div>
        <div data-slot="alert-dialog-footer" class=${alertDialogFooterClass()}>
          <ui-alert-dialog-cancel>Don't allow</ui-alert-dialog-cancel>
          <ui-alert-dialog-action>Allow</ui-alert-dialog-action>
        </div>
      </ui-alert-dialog-content>
    </ui-alert-dialog>
  `;
}
View Code

Destructive

Use variant="destructive" on <ui-alert-dialog-action> to add a destructive action button to the alert dialog.

Delete chat?

This will permanently delete this chat conversation. View Settings delete any memories saved during this chat.

import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import {
  alertDialogHeaderClass, alertDialogFooterClass, alertDialogTitleClass, alertDialogDescriptionClass,
  alertDialogMediaClass,
} from '#components/ui/alert-dialog.ts';
import { Trash2Icon } from '#lib/ui/lucide.ts';

export default function AlertDialogDestructive() {
  return html`
    <ui-alert-dialog>
      <ui-alert-dialog-trigger>
        <button type="button" data-slot="button" data-variant="destructive" data-size="default" class=${buttonClass({ variant: 'destructive' })}>Delete Chat</button>
      </ui-alert-dialog-trigger>
      <ui-alert-dialog-content size="sm">
        <div data-slot="alert-dialog-header" class=${alertDialogHeaderClass()}>
          <div data-slot="alert-dialog-media" aria-hidden="true" class=${cn(alertDialogMediaClass(), 'bg-destructive/10 text-destructive dark:bg-destructive/20 dark:text-destructive')}>
            ${Trash2Icon()}
          </div>
          <h2 data-slot="alert-dialog-title" class=${alertDialogTitleClass()}>Delete chat?</h2>
          <p data-slot="alert-dialog-description" class=${alertDialogDescriptionClass()}>
            This will permanently delete this chat conversation. View
            <a href="#">Settings</a> delete any memories saved during this chat.
          </p>
        </div>
        <div data-slot="alert-dialog-footer" class=${alertDialogFooterClass()}>
          <ui-alert-dialog-cancel variant="outline">Cancel</ui-alert-dialog-cancel>
          <ui-alert-dialog-action variant="destructive">Delete</ui-alert-dialog-action>
        </div>
      </ui-alert-dialog-content>
    </ui-alert-dialog>
  `;
}
View Code

RTL

To enable RTL support, see the RTL configuration guide.

هل أنت متأكد تمامًا؟

لا يمكن التراجع عن هذا الإجراء. سيؤدي هذا إلى حذف حسابك نهائيًا من خوادمنا.

السماح للملحق بالاتصال؟

هل تريد السماح لملحق USB بالاتصال بهذا الجهاز؟

import { html } from '@webjsdev/core';
import { buttonClass } from '#components/ui/button.ts';
import {
  alertDialogHeaderClass, alertDialogFooterClass, alertDialogTitleClass, alertDialogDescriptionClass,
  alertDialogMediaClass,
} from '#components/ui/alert-dialog.ts';
import { BluetoothIcon } from '#lib/ui/lucide.ts';

const translations = {
  en: {
    dir: 'ltr',
    values: {
      showDialog: 'Show Dialog',
      showDialogSm: 'Show Dialog (sm)',
      title: 'Are you absolutely sure?',
      description:
        'This action cannot be undone. This will permanently delete your account from our servers.',
      cancel: 'Cancel',
      continue: 'Continue',
      smallTitle: 'Allow accessory to connect?',
      smallDescription:
        'Do you want to allow the USB accessory to connect to this device?',
      dontAllow: "Don't allow",
      allow: 'Allow',
    },
  },
  ar: {
    dir: 'rtl',
    values: {
      showDialog: 'إظهار الحوار',
      showDialogSm: 'إظهار الحوار (صغير)',
      title: 'هل أنت متأكد تمامًا؟',
      description:
        'لا يمكن التراجع عن هذا الإجراء. سيؤدي هذا إلى حذف حسابك نهائيًا من خوادمنا.',
      cancel: 'إلغاء',
      continue: 'متابعة',
      smallTitle: 'السماح للملحق بالاتصال؟',
      smallDescription: 'هل تريد السماح لملحق USB بالاتصال بهذا الجهاز؟',
      dontAllow: 'عدم السماح',
      allow: 'السماح',
    },
  },
  he: {
    dir: 'rtl',
    values: {
      showDialog: 'הצג דיאלוג',
      showDialogSm: 'הצג דיאלוג (קטן)',
      title: 'האם אתה בטוח לחלוטין?',
      description:
        'פעולה זו לא ניתנת לביטול. זה ימחק לצמיתות את החשבון שלך מהשרתים שלנו.',
      cancel: 'ביטול',
      continue: 'המשך',
      smallTitle: 'לאפשר להתקן להתחבר?',
      smallDescription: 'האם אתה רוצה לאפשר להתקן USB להתחבר למכשיר זה?',
      dontAllow: 'אל תאפשר',
      allow: 'אפשר',
    },
  },
};

export default function AlertDialogRtl() {
  const lang = 'ar';
  const { dir, values: t } = translations[lang];

  return html`
    <div class="flex gap-4" dir=${dir} lang=${lang}>
      <ui-alert-dialog>
        <ui-alert-dialog-trigger>
          <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>${t.showDialog}</button>
        </ui-alert-dialog-trigger>
        <ui-alert-dialog-content dir=${dir} data-lang=${lang}>
          <div data-slot="alert-dialog-header" class=${alertDialogHeaderClass()}>
            <h2 data-slot="alert-dialog-title" class=${alertDialogTitleClass()}>${t.title}</h2>
            <p data-slot="alert-dialog-description" class=${alertDialogDescriptionClass()}>${t.description}</p>
          </div>
          <div data-slot="alert-dialog-footer" class=${alertDialogFooterClass()}>
            <ui-alert-dialog-cancel>${t.cancel}</ui-alert-dialog-cancel>
            <ui-alert-dialog-action>${t.continue}</ui-alert-dialog-action>
          </div>
        </ui-alert-dialog-content>
      </ui-alert-dialog>
      <ui-alert-dialog>
        <ui-alert-dialog-trigger>
          <button type="button" data-slot="button" data-variant="outline" data-size="default" class=${buttonClass({ variant: 'outline' })}>${t.showDialogSm}</button>
        </ui-alert-dialog-trigger>
        <ui-alert-dialog-content size="sm" dir=${dir} data-lang=${lang}>
          <div data-slot="alert-dialog-header" class=${alertDialogHeaderClass()}>
            <div data-slot="alert-dialog-media" aria-hidden="true" class=${alertDialogMediaClass()}>
              ${BluetoothIcon()}
            </div>
            <h2 data-slot="alert-dialog-title" class=${alertDialogTitleClass()}>${t.smallTitle}</h2>
            <p data-slot="alert-dialog-description" class=${alertDialogDescriptionClass()}>${t.smallDescription}</p>
          </div>
          <div data-slot="alert-dialog-footer" class=${alertDialogFooterClass()}>
            <ui-alert-dialog-cancel>${t.dontAllow}</ui-alert-dialog-cancel>
            <ui-alert-dialog-action>${t.allow}</ui-alert-dialog-action>
          </div>
        </ui-alert-dialog-content>
      </ui-alert-dialog>
    </div>
  `;
}
View Code

API Reference

size

Use the size attribute on <ui-alert-dialog-content> to control the size of the alert dialog. The small size lays the footer out as two full-width columns. It accepts the following values:

AttributeTypeDefault
size"default" | "sm""default"

ui-alert-dialog

The root element. It tracks the open state and opens the content when the trigger is activated. Escape and a click outside do not close it: an alert dialog waits for an explicit choice. It dispatches no events, so observe the reflected open attribute.

Attribute / MethodTypeDefault
openboolean (reflected)false
show() / hide()() => void

ui-alert-dialog-action and ui-alert-dialog-cancel

The footer buttons. Both close the dialog. They render a button with the button classes, so they take the button's variant and size.

AttributeTypeDefault
variant"default" | "outline" | "ghost" | "destructive" | "secondary" | "link""default" on the action, "outline" on the cancel
size"default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg""default"

Class helpers

alertDialogHeaderClass(), alertDialogTitleClass(), alertDialogDescriptionClass(), alertDialogMediaClass() and alertDialogFooterClass() take no options. Mark each element with its data-slot: the element names the dialog from data-slot="alert-dialog-title" and describes it from data-slot="alert-dialog-description", so always give it a title.