Skip to content

CSS: tray

.instui-tray — Et kant-fast panel, der glider ind fra enhver side; en native [popover] eller <dialog>.

Placeringer for start/ slut løses i forhold til inset-inline (logisk, retningsfølsom); slide-in transformen spejles automatisk under en forfader [dir="rtl"], så der ikke kræves ekstra markup til højre-til-venstre layouts.

Source: tray.css

Tilgængelighed

Træet er en dialog- eller popover-flade, så navngiv det med aria-label eller aria-labelledby, og dets luk-kontrol bærer en aria-label (eksemplets .instui-close-button bruger aria-label="Close").

Brug

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

Eksempler

html
<div class="instui-tray -placement-end -size-sm">
  <span class="instui-heading -level-h3">Filters</span>
  <p class="-size-sm">A tray slides in from the start edge and fills the viewport height.</p>
</div>
<button class="instui-button -toggle">toggle tray</button>

Struktur

text
.instui-tray
  close-button (component, 0..1)
  ‹content›
flowchart TD n0[".instui-tray"]:::cssdoc-root n1(["close-button"]):::cssdoc-component n2[/"‹content›"/]:::cssdoc-slot n0 -.->|0..1| n1 n0 --> n2 click n1 "/api/css/close-button.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;

Modifikatorer

ModifikatorBeskrivelse
.-placement-bottomFastgør til nederste kant.
.-placement-endFastgør til enden (inline-end) kanten.
.-placement-start(standard) Fastgør til start (inline-start) kanten.
.-placement-topFastgør til øverste kant.
.-size-largeStor. Langform-alias af -size-lg.
.-size-lgStor.
.-size-md(standard) Medium.
.-size-medium(standard) Medium. Langform-alias for -size-md.
.-size-regularUdløbet — use .-size-md.
.-size-smLille.
.-size-smallLille. Langform-alias af -size-sm.
.-size-x-largeEkstra stor. Langform-alias af -size-xl.
.-size-x-smallEkstra lille. Langform-alias af -size-xs.
.-size-xlEkstra stor.
.-size-xsEkstra lille.

Betingelser

TypeForespørgselBeskrivelse
supports(transition-behavior: allow-discrete)

Forbrugte tokens

TokenTypeVærdi
--instui-component-tray-background-color<color>LightDarklight-dark(#ffffff, #1C222B)
--instui-component-tray-border-color<color>LightDarklight-dark(#E8EAEC, #334450)
--instui-component-tray-border-width<length>0.0625rem
--instui-component-tray-padding<length>1.5rem
--instui-component-tray-width-lg<length>48em
--instui-component-tray-width-md<length>30em
--instui-component-tray-width-sm<length>20em
--instui-component-tray-width-xl<length>62em
--instui-component-tray-width-xs<length>16em
--instui-component-tray-z-index<integer>9999
--instui-elevation-topmostnone | <shadow>#
--tray-slide-x-100%
--tray-slide-y0%

Browserunderstøttelse

  • Åbner med den native [popover] API og @starting-style; slide-in ligger bag en @supports (transition-behavior: allow-discrete)-vagt, så browsere uden den stadig åbner træet, blot uden slide.

Underkomponenter

Relateret

  • modal — Det samme lukkbare overlay-mønster, centreret i stedet for fastgjort til kanten.
  • popover — Den generiske top-lagsoverflade, som dette bygger på.