CSS: modal

.instui-modal — A dialog surface (works on a native <dialog>); header/body/footer parts.

See the modal.header, modal.body, and modal.footer members for the individual parts.

Source: body.css

TIP

JS Enhancement — This component's CSS renders and works on its own; pair it with @pantoken/interactions to add the interactive behavior. See the modifier table below.

Accessibility

Open the native <dialog> with showModal() for modal semantics and Esc-to-close, and name it with aria-labelledby pointing at the .header.

Usage

@import "@pantoken/components/components.css";
@import "@pantoken/components/modal.css";

Demo

Examples

<dialog class="instui-modal -size-sm" id="modal-sm">
  <div class="header"><strong>Small</strong></div>
  <div class="body"><code>-size-sm</code> — a narrow modal.</div>
  <div class="footer">
    <button class="instui-button">Close</button>
  </div>
</dialog>

Structure

.instui-modal
  modal.header (component)
  modal.body (component)
  modal.footer (component)

flowchart TD n0[".instui-modal"]:::cssdoc-root n1(["modal.header"]):::cssdoc-component n2(["modal.body"]):::cssdoc-component n3(["modal.footer"]):::cssdoc-component n0 --> n1 n0 --> n2 n0 --> n3 click n1 "/api/css/modal.header.md" click n2 "/api/css/modal.body.md" click n3 "/api/css/modal.footer.md" classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

Modifiers

Modifier	Description
.-blur	Blur the backdrop behind the modal.
.-color-inverse	On-dark chrome (pairs with a media body). @affects modal.header @affects modal.body @affects modal.footer — Recolours each part for the on-dark look.
.-density-compact	Tighter part padding. @affects modal.header @affects modal.body @affects modal.footer — Tightens each part's padding.
.-overflow-fit	Constrain to the viewport and scroll the body. @affects modal.body — Scrolls the body when the modal is capped to the viewport.
.-size-auto	Sized to content.
.-size-fullscreen	Edge-to-edge.
.-size-large	A wide modal. Long-form alias of -size-lg.
.-size-lg	A wide modal.
.-size-sm	A narrow modal.
.-size-small	A narrow modal. Long-form alias of -size-sm.

Pseudo-elements

Pseudo-element	Description
::backdrop	Dims the page behind the dialog as its mask, and frosts it under -blur.

Tokens consumed

Token	Type	Value
--instui-component-mask-background-color	<color>	LightDarklight-dark(rgba(255,255,255,0.75), rgba(28,34,43,0.75))
--instui-component-modal-auto-min-width	<length>	16em
--instui-component-modal-background-color	<color>	LightDarklight-dark(#ffffff, #171B21)
--instui-component-modal-border-color	<color>	LightDarklight-dark(#E8EAEC, #334450)
--instui-component-modal-border-radius	<length>	1rem
--instui-component-modal-border-width	<length>	0.0625rem
--instui-component-modal-font-family	[ <font-family-name> | <generic-font-family> ]#	Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-component-modal-inverse-background-color	<color>	LightDarklight-dark(#273540, #1C222B)
--instui-component-modal-inverse-border-color	<color>	#334450
--instui-component-modal-inverse-text-color	<color>	#ffffff
--instui-component-modal-large-max-width	<length>	62em
--instui-component-modal-medium-max-width	<length>	48em
--instui-component-modal-small-max-width	<length>	30em
--instui-component-modal-text-color	<color>	LightDarklight-dark(#273540, #F2F4F5)
--instui-elevation-topmost	none | <shadow>#	—
--instui-spacing-space-xl	<length>	1.5rem

Browser support

• Styles a native <dialog> and its ::backdrop; the top-layer rendering and backdrop styling need a browser that supports the dialog element.

Subcomponents

• modal.body
• modal.footer
• modal.header

Related

• tray — A tray is the same dismissible overlay pattern, anchored to a screen edge.