Skip to content

CSS: modal

.instui-modal — Eine Dialogfläche (funktioniert mit einem nativen <dialog>); Header-/Body-/Footer-Teile.

Siehe die Mitglieder modal.header, modal.body und modal.footer für die einzelnen Teile.

Source: body.css

TIP

JS-Erweiterung — Das CSS dieses Components rendert und funktioniert eigenständig; mit @pantoken/interactions koppeln, um das interaktive Verhalten hinzuzufügen. Siehe die Modifier-Tabelle unten.

Barrierefreiheit

Öffne das native <dialog> mit showModal() für modale Semantik und Esc‑zum‑Schließen, und benenne es mit aria-labelledby, das auf das .header zeigt.

Verwendung

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

Demo

Beispiele

html
<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>

Struktur

text
.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;

Modifikatoren

ModifikatorBeschreibung
.-blurDen Hintergrund (Backdrop) hinter dem Modal unscharf machen.
.-color-inverseAuf dunklem Chrome (passt zu einem Medien‑Body). @affects modal.header @affects modal.body @affects modal.footer — Färbt jeden Teil für das dunkle Erscheinungsbild um.
.-density-compactEngere Teil‑Abstände. @affects modal.header @affects modal.body @affects modal.footer — Reduziert das Padding jedes Teils.
.-overflow-fitAuf die Viewport‑Größe beschränken und den Body scrollen. @affects modal.body — Lässt den Body scrollen, wenn das Modal an den Viewport begrenzt ist.
.-size-autoAn den Inhalt angepasst.
.-size-fullscreenKante‑zu‑Kante.
.-size-largeEin breites Modal. Langform‑Alias von -size-lg.
.-size-lgEin breites Modal.
.-size-smEin schmales Modal.
.-size-smallEin schmales Modal. Langform‑Alias von -size-sm.

Pseudo-Elemente

Pseudo-ElementBeschreibung
::backdropVerdunkelt die Seite hinter dem Dialog als Maske und frosted sie unter -blur.

Verbrauchte Tokens

TokenTypWert
--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-topmostnone | <shadow>#
--instui-spacing-space-xl<length>1.5rem

Browser-Unterstützung

  • Stiliert ein natives <dialog> und sein ::backdrop; das Top‑Layer‑Rendering und das Backdrop‑Styling benötigen einen Browser, der das dialog‑Element unterstützt.

Unterkomponenten

Verwandt

  • tray — Ein Tray ist dasselbe ausblendbare Overlay‑Muster, verankert an einer Bildschirmkante.