Drawer
Auf dieser Seite
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
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
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.
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.
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
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
| Prop | Typ | Standard | Beschreibung |
|---|---|---|---|
id | string | — | Pflicht. Worauf das commandfor eines Auslösers zeigt. |
title | Child | — | Überschrift und zugänglicher Name des Dialogs. |
side | 'start' | 'end' | 'end' | An welcher Kante er verankert ist. |
width | string | '20rem' | Panelbreite, gedeckelt bei 90vw. |
closable | boolean | true | Das × in der Kopfzeile zeigen. |
closeLabel | string | 'Close' | Zugänglicher Name dieses Buttons. |