Drawer

Ein Drawer ist ein Panel über die volle Höhe, an einer Seite verankert. Wie modal() ist er ein <dialog>: ein Button mit passendem commandfor und command: 'show-modal' öffnet ihn, und der Browser kümmert sich um Hintergrund, Fokus, Klick nach außen und Escape.

Auf einer statischen Website ist sein häufigster Job das Navigationsmenü am Telefon.

Einfacher Drawer

Einstellungen

fragment(
  button({ commandfor: 'drawer-basic', command: 'show-modal' }, 'Drawer öffnen'),
  drawer({ id: 'drawer-basic', title: 'Einstellungen' },
    stack({ gap: 'md' },
      toggle({ label: 'Pagefind-Suche', checked: true }),
      toggle({ label: 'Bildoptimierung', checked: true }),
      toggle({ label: 'Server-Islands' }),
    ),
  ),
)

Seiten

Anfang

An der vorderen Kante verankert — links in einer Sprache, die von links nach rechts läuft.

Ende

Der Standard: an der hinteren Kante verankert.

fragment(
  stack({ direction: 'row', gap: 'sm' },
    button({ variant: 'outline', color: 'neutral', commandfor: 'drawer-start', command: 'show-modal' }, 'Vom Anfang'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'drawer-end', command: 'show-modal' }, 'Vom Ende'),
  ),
  drawer({ id: 'drawer-start', side: 'start', title: 'Anfang' },
    text({ variant: 'small', tone: 'muted' }, 'An der vorderen Kante verankert — links in einer Sprache, die von links nach rechts läuft.'),
  ),
  drawer({ id: 'drawer-end', title: 'Ende' },
    text({ variant: 'small', tone: 'muted' }, 'Der Standard: an der hinteren Kante verankert.'),
  ),
)

Breite

Jede CSS-Länge. Sie ist auf 90 % des Viewports gedeckelt, sodass ein breiter Drawer auch auf ein Telefon passt.

Schmal

width: 14rem

Breit

width: 34rem

fragment(
  stack({ direction: 'row', gap: 'sm' },
    button({ variant: 'outline', color: 'neutral', commandfor: 'drawer-narrow', command: 'show-modal' }, 'Schmal'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'drawer-wide', command: 'show-modal' }, 'Breit'),
  ),
  drawer({ id: 'drawer-narrow', width: '14rem', title: 'Schmal' },
    text({ variant: 'small', tone: 'muted' }, 'width: 14rem'),
  ),
  drawer({ id: 'drawer-wide', width: '34rem', title: 'Breit' },
    text({ variant: 'small', tone: 'muted' }, 'width: 34rem'),
  ),
)

Als Navigationsmenü

Das Muster, das die meisten Websites wollen: ein Menü-Button in der Leiste, die Links in einem Drawer.

sitelo

Navigation

fragment(
  appBar({ brand: 'sitelo' },
    appBarSpacer(),
    appBarActions(
      iconButton({
        label: 'Navigation öffnen',
        variant: 'ghost',
        color: 'neutral',
        commandfor: 'drawer-nav', command: 'show-modal',
        icon: icon('menu'),
      }),
    ),
  ),
  drawer({ id: 'drawer-nav', title: 'Navigation' },
    navLink({ href: '#docs', current: true }, 'Doku'),
    navLink({ href: '#ui' }, 'UI'),
    navLink({ href: '#examples' }, 'Beispiele'),
    navLink({ href: '#about' }, 'Über'),
    divider({ spacing: 'sm' }),
    button({ block: true }, 'Loslegen'),
  ),
)

Ein Filter-Panel

Filter

Typ
Tags
fragment(
  button({ variant: 'soft', color: 'neutral', commandfor: 'drawer-filters', command: 'show-modal' }, 'Filter'),
  drawer({ id: 'drawer-filters', title: 'Filter', width: '22rem' },
    stack({ gap: 'lg' },
      choiceGroup({
        legend: 'Typ',
        name: 'drawer-type',
        value: 'guide',
        options: [
          { value: 'guide', label: 'Anleitungen' },
          { value: 'example', label: 'Beispiele' },
          { value: 'all', label: 'Alles' },
        ],
      }),
      choiceGroup({
        legend: 'Tags',
        name: 'drawer-tags',
        type: 'checkbox',
        value: ['routing'],
        options: ['routing', 'data', 'islands'],
      }),
      stack({ direction: 'row', gap: 'sm' },
        button({ variant: 'ghost', color: 'neutral', commandfor: 'drawer-filters', command: 'close' }, 'Abbrechen'),
        button('Anwenden'),
      ),
    ),
  ),
)

Props

PropTypStandardBeschreibung
idstring—Pflicht. Worauf das commandfor eines Auslösers zeigt.
titleChild—Überschrift und zugänglicher Name des Dialogs.
side'start' | 'end''end'An welcher Kante er verankert ist.
widthstring'20rem'Panelbreite, gedeckelt bei 90vw.
closablebooleantrueDas × in der Kopfzeile zeigen.
closeLabelstring'Close'Zugänglicher Name dieses Buttons.