Components Modal

CSS-only transitions NEW

A <dialog> opened with dialog.showModal() fades in and its <article> zooms in, without JS classes. Pico's modal JS (.modal-is-open, .modal-is-opening, .modal-is-closing) still works on top of it.

dialog:modal {
  transition: opacity var(--pico-transition);

  > article {
    transition: transform var(--pico-transition);
  }
}
@starting-style {
  dialog:modal {
    opacity: 0;

    > article {
      transform: scale(0.96);
    }
  }
}

Open and close without JS NEW

The Invoker Commands API lets a <button> open and close a dialog with attributes only. Give the button a command and a commandfor that holds the dialog's id:

<button command="show-modal" commandfor="my-dialog">Open</button>

<dialog id="my-dialog" closedby="any">
  <article>
    <header>
      <button aria-label="Close" rel="prev" command="close" commandfor="my-dialog"></button>
      <h3>Title</h3>
    </header>
    <p>Content.</p>
    <footer>
      <button class="secondary" command="request-close" commandfor="my-dialog">Cancel</button>
      <button command="close" commandfor="my-dialog" value="confirm">Confirm</button>
    </footer>
  </article>
</dialog>

Click outside to close NEW

<dialog closedby="any"> closes when the user clicks outside its box. The browser does this, so the click itself needs no JS. The dim and blur are on ::backdrop, and they fade in over --pico-transition. closedby="closerequest" and closedby="none" get the same ::backdrop and box styles while keeping their native close behavior; dialogs without closedby are unchanged.


How it works

/open-sveti/blades/refs/heads/main/src/blades/components/_modal-modern.css :

dialog:modal[closedby] {
  width: calc(100% - var(--pico-spacing) * 2);
  max-width: none;
  min-width: 0;
  height: fit-content;
  min-height: 0;
  max-height: calc(100% - var(--pico-spacing) * 2);
  margin: auto;
  padding: 0;
  background: transparent;
  -webkit-backdrop-filter: none;
  backdrop-filter: none;

  @media (min-width: 576px) {
    width: min(510px, calc(100% - var(--pico-spacing) * 2));
  }
  @media (min-width: 768px) {
    width: min(700px, calc(100% - var(--pico-spacing) * 2));
  }

  > article {
    width: 100%;
    max-width: none;
    max-height: calc(100vh - var(--pico-spacing) * 2);
    max-height: calc(100dvh - var(--pico-spacing) * 2);
    margin: 0;
  }

  &::backdrop {
    background: var(--pico-modal-overlay-background-color);
    -webkit-backdrop-filter: var(--pico-modal-overlay-backdrop-filter);
    backdrop-filter: var(--pico-modal-overlay-backdrop-filter);
    transition:
      background-color var(--pico-transition),
      -webkit-backdrop-filter var(--pico-transition),
      backdrop-filter var(--pico-transition);

    @starting-style {
      background-color: transparent;
      -webkit-backdrop-filter: none;
      backdrop-filter: none;
    }

    @media (prefers-reduced-motion: reduce) {
      transition: none;
    }
  }
}

Syntax

The classic modal component with graceful spacings across devices and viewports, using the semantic HTML tag <dialog>.

Modals are built with <dialog> as a wrapper and <article> for the modal content.

Inside <header> <button rel="prev"> is defined to float: right; allowing a close icon to be top aligned with a title.

🗓️ Thank You for Registering!

We’re excited to have you join us for our upcoming event. Please arrive at the museum on time to check in and get started.

  • Date: Saturday, April 15
  • Time: 10:00am - 12:00pm
<dialog open>
  <article>
    <header>
      <button aria-label="Close" rel="prev"></button>
      <p>
        <strong>🗓️ Thank You for Registering!</strong>
      </p>
    </header>
    <p>
      We're excited to have you join us for our
      upcoming event. Please arrive at the museum 
      on time to check in and get started.
    </p>
    <ul>
      <li>Date: Saturday, April 15</li>
      <li>Time: 10:00am - 12:00pm</li>
    </ul>
  </article>
</dialog>

Inside <footer>, the content is right aligned by default.

Confirm Your Membership

Thank you for signing up for a membership! Please review the membership details below:

  • Membership: Individual
  • Price: $10
<dialog open>
  <article>
    <h2>Confirm Your Membership</h2>
    <p>
      Thank you for signing up for a membership!
      Please review the membership details below:
    </p>
    <ul>
      <li>Membership: Individual</li>
      <li>Price: $10</li>
    </ul>
    <footer>
      <button class="secondary">
        Cancel
      </button>
      <button>Confirm</button>
    </footer>
  </article>
</dialog>

Demo#

Toggle a modal by clicking the button below.

Pico does not include JavaScript code. You need to implement your JS to interact with modals.

As a starting point, you can look at the HTMLDialogElement or the advanced examples below:

To open a modal, add the open attribute to the<dialog> container.

Utilities#

Modals come with 3 utility classes.

These classes are not available in the class-less version.

.modal-is-open prevents any scrolling and interactions below the modal.

<!doctype html>
<html class="modal-is-open">
  ...
</html>

.modal-is-opening brings an opening animation.

<!doctype html>
<html class="modal-is-open modal-is-opening">
  ...
</html>

.modal-is-closing brings a closing animation.

<!doctype html>
<html class="modal-is-open modal-is-closing">
  ...
</html>

Edit this page on GitHub