Dialog

Preview

<button data-target="dlg-md">Open dialog</button>

<esa-dialog id="dlg-md" heading="Medium dialog">
  <p>The default md dialog. The close button, backdrop click, and Esc all dismiss it.</p>
  <button slot="footer" data-close="dlg-md">Close</button>
</esa-dialog>

import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
import '@esa/ecology/esa-dialog';

@Component({
  selector: 'app-dialog-demo',
  standalone: true,
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  template: `
    <button data-target="dlg-md">Open dialog</button>
    <esa-dialog id="dlg-md" heading="Medium dialog">
      <p>The default md dialog. The close button, backdrop click, and Esc all dismiss it.</p>
      <button slot="footer" data-close="dlg-md">Close</button>
    </esa-dialog>
  `,
})
export class DialogDemo {}

Sizes

Five widths cover compact prompts through immersive, edge-to-edge flows.

<esa-dialog size="xs" heading="Extra small dialog">…</esa-dialog>
<esa-dialog size="sm" heading="Small dialog">…</esa-dialog>
<esa-dialog heading="Medium dialog">…</esa-dialog>
<esa-dialog size="lg" heading="Large dialog">…</esa-dialog>
<esa-dialog size="fullscreen" heading="Fullscreen dialog">…</esa-dialog>

import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
import '@esa/ecology/esa-dialog';

@Component({
  selector: 'app-dialog-demo',
  standalone: true,
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  template: `
    <esa-dialog size="xs" heading="Extra small dialog">…</esa-dialog>
    <esa-dialog size="sm" heading="Small dialog">…</esa-dialog>
    <esa-dialog heading="Medium dialog">…</esa-dialog>
    <esa-dialog size="lg" heading="Large dialog">…</esa-dialog>
    <esa-dialog size="fullscreen" heading="Fullscreen dialog">…</esa-dialog>
  `,
})
export class DialogDemo {}

API

Methods

Events

Accessibility

• The panel is role="dialog" with aria-modal="true"; heading provides the accessible name.
• Focus is trapped while open — Tab and Shift+Tab cycle within the panel.
• Opening stores the previously focused element and restores it on close.
• Escape closes the dialog; the close button carries an aria-label.

Theming surface

Every public token this component reads, extracted from its source at build time, split by blast radius: the hooks that belong to this component, then the shared and system tokens it consumes alongside everything else. The Resolves to column walks each token's real lineage — component → semantic → primitive → raw value — so you can see exactly where re-pointing it lands. A spoke re-skins by overriding these in its theme-<slug>.css; component internals are never edited. No hook for what you need? File it with /request-lego.

Type roles it names

This component does not set a size, weight, face or tracking of its own — it names a composite, and the composite carries all five. A composite is a class rather than a token, so none of it appears in the tables below; re-theme text by re-pointing the token family, not by editing the component.

Wired to this component

No other component reads these — re-point them and esa-dialog is the only thing that moves.

Shared tokens it reads

Owned by a family or by the semantic layer. Still overridable — but scope the override (esa-foo { --form-border-color: … }) unless you mean to move everything that reads it. Reach says what else that is.