Szuflada
Na tej stronie
Szuflada to panel pełnej wysokości zakotwiczony do jednej strony. Tak jak modal(), jest elementem <dialog>: przycisk z pasującym commandfor i command: 'show-modal' ją otwiera, a przeglądarka zajmuje się tłem, fokusem, kliknięciem poza i Escape.
Jej najczęstszym zadaniem na witrynie statycznej jest menu nawigacji na telefonie.
Podstawowa szuflada
fragment(
button({ commandfor: 'drawer-basic', command: 'show-modal' }, 'Otwórz szufladę'),
drawer({ id: 'drawer-basic', title: 'Ustawienia' },
stack({ gap: 'md' },
toggle({ label: 'Wyszukiwanie Pagefind', checked: true }),
toggle({ label: 'Optymalizacja obrazów', checked: true }),
toggle({ label: 'Wyspy serwerowe' }),
),
),
)Strony
fragment(
stack({ direction: 'row', gap: 'sm' },
button({ variant: 'outline', color: 'neutral', commandfor: 'drawer-start', command: 'show-modal' }, 'Od początku'),
button({ variant: 'outline', color: 'neutral', commandfor: 'drawer-end', command: 'show-modal' }, 'Od końca'),
),
drawer({ id: 'drawer-start', side: 'start', title: 'Początek' },
text({ variant: 'small', tone: 'muted' }, 'Zakotwiczona do krawędzi początkowej — lewej w języku pisanym od lewej do prawej.'),
),
drawer({ id: 'drawer-end', title: 'Koniec' },
text({ variant: 'small', tone: 'muted' }, 'Domyślnie: zakotwiczona do krawędzi końcowej.'),
),
)Szerokość
Dowolna długość CSS. Jest ograniczona do 90% widocznego obszaru, więc nawet szeroka szuflada zmieści się na telefonie.
fragment(
stack({ direction: 'row', gap: 'sm' },
button({ variant: 'outline', color: 'neutral', commandfor: 'drawer-narrow', command: 'show-modal' }, 'Wąska'),
button({ variant: 'outline', color: 'neutral', commandfor: 'drawer-wide', command: 'show-modal' }, 'Szeroka'),
),
drawer({ id: 'drawer-narrow', width: '14rem', title: 'Wąska' },
text({ variant: 'small', tone: 'muted' }, 'width: 14rem'),
),
drawer({ id: 'drawer-wide', width: '34rem', title: 'Szeroka' },
text({ variant: 'small', tone: 'muted' }, 'width: 34rem'),
),
)Jako menu nawigacji
Wzorzec, jakiego chce większość witryn: przycisk menu w pasku, odnośniki w szufladzie.
fragment(
appBar({ brand: 'sitelo' },
appBarSpacer(),
appBarActions(
iconButton({
label: 'Otwórz nawigację',
variant: 'ghost',
color: 'neutral',
commandfor: 'drawer-nav', command: 'show-modal',
icon: icon('menu'),
}),
),
),
drawer({ id: 'drawer-nav', title: 'Nawigacja' },
navLink({ href: '#docs', current: true }, 'Dokumentacja'),
navLink({ href: '#ui' }, 'UI'),
navLink({ href: '#examples' }, 'Przykłady'),
navLink({ href: '#about' }, 'O projekcie'),
divider({ spacing: 'sm' }),
button({ block: true }, 'Zacznij'),
),
)Panel filtrów
fragment(
button({ variant: 'soft', color: 'neutral', commandfor: 'drawer-filters', command: 'show-modal' }, 'Filtry'),
drawer({ id: 'drawer-filters', title: 'Filtry', width: '22rem' },
stack({ gap: 'lg' },
choiceGroup({
legend: 'Typ',
name: 'drawer-type',
value: 'guide',
options: [
{ value: 'guide', label: 'Przewodniki' },
{ value: 'example', label: 'Przykłady' },
{ value: 'all', label: 'Wszystko' },
],
}),
choiceGroup({
legend: 'Tagi',
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' }, 'Anuluj'),
button('Zastosuj'),
),
),
),
)Przewijanie tła
Strona za otwartą szufladą się nie przewija — ta sama blokada zrobiona wyłącznie w CSS-ie, której używa modal(), bez skryptu i bez niczego do zainicjowania. Podaj lockScroll: false, żeby tło przewijało się jak zwykle.
Propsy
| Prop | Typ | Domyślnie | Opis |
|---|---|---|---|
id | string | — | Wymagane. To, na co wskazuje commandfor wyzwalacza. |
title | Child | — | Nagłówek i dostępna nazwa okna dialogowego. |
side | 'start' | 'end' | 'end' | Do której krawędzi jest zakotwiczona. |
width | string | '20rem' | Szerokość panelu, ograniczona do 90vw. |
closable | boolean | true | Pokaż × w nagłówku. |
closeLabel | string | 'Close' | Dostępna nazwa tego przycisku. |
lockScroll | boolean | true | Blokuje przewijanie strony za nią, gdy jest otwarta. |