MDN self-hosted library · e01.org

`:modal` CSS pseudo-class

The :modal CSS pseudo-class matches an element that is in a state in which it excludes all interaction with elements outside it until the interaction has been dismissed. Multiple elements can be selected by the :modal pseudo-class at the same time, but only one of them will be active and able to receive input.

no runnable cells css-pseudo-class upstream source

The :modal CSS pseudo-class matches an element that is in a state in which it excludes all interaction with elements outside it until the interaction has been dismissed. Multiple elements can be selected by the :modal pseudo-class at the same time, but only one of them will be active and able to receive input.

tabbed-shorter

```css interactive-example button { display: block; margin: auto; width: 10rem; height: 2rem; }

:modal { background-color: beige; border: 2px solid burlywood; border-radius: 5px; }

p { color: black; }


```html interactive-example
<p>Would you like to see a new random number?</p>
<button id="showNumber">Show me</button>

<dialog id="favDialog">
  <form method="dialog">
    <p>Lucky number is: <strong id="number"></strong></p>
    <button>Close dialog</button>
  </form>
</dialog>

```js interactive-example const showNumber = document.getElementById("showNumber"); const favDialog = document.getElementById("favDialog"); const number = document.getElementById("number");

showNumber.addEventListener("click", () => { number.innerText = Math.floor(Math.random() * 1000); favDialog.showModal(); });


## Syntax

```css
:modal {
  /* ... */
}

Usage notes

Examples of elements that will prevent user interaction with the rest of the page and will be selected by the :modal pseudo-class include:

  • The dialog element opened with the showModal() API.
  • The element selected by the :fullscreen pseudo-class when opened with the requestFullscreen() API.

Examples

Styling a modal dialog

This example styles a modal dialog that opens when the "Show the dialog" button is activated. This example is adapted from the dialog element example.

```html hidden



#### CSS

The `:modal` pseudo-class selects the dialog opened with `showModal()`, giving it a red border, a yellow background, and a box shadow.

```css
:modal {
  border: 5px solid red;
  background-color: yellow;
  box-shadow: 3px 3px 10px rgb(0 0 0 / 50%);
}

```js hidden const showButton = document.getElementById("showDialog"); const favDialog = document.getElementById("favDialog");

showButton.addEventListener("click", () => { favDialog.showModal(); }); ```

Result

100%

Specifications

Browser compatibility

See also

  • dialog element
  • Other element display state pseudo-classes: :fullscreen and :picture-in-picture
  • Complete list of pseudo-classes