Laci

Laci adalah panel setinggi penuh yang ditambatkan pada satu sisi. Seperti modal(), ia adalah sebuah <dialog>: tombol dengan commandfor yang cocok dan command: 'show-modal' membukanya, dan peramban menangani latarnya, fokus, klik di luar, serta Escape.

Tugas terseringnya di situs statis adalah menu navigasi di ponsel.

Laci dasar

Pengaturan

fragment(
  button({ commandfor: 'drawer-basic', command: 'show-modal' }, 'Buka laci'),
  drawer({ id: 'drawer-basic', title: 'Pengaturan' },
    stack({ gap: 'md' },
      toggle({ label: 'Pencarian Pagefind', checked: true }),
      toggle({ label: 'Optimasi gambar', checked: true }),
      toggle({ label: 'Island server' }),
    ),
  ),
)

Sisi

Awal

Ditambatkan pada tepi awal — sebelah kiri dalam bahasa yang ditulis kiri ke kanan.

Akhir

Bawaannya: ditambatkan pada tepi akhir.

fragment(
  stack({ direction: 'row', gap: 'sm' },
    button({ variant: 'outline', color: 'neutral', commandfor: 'drawer-start', command: 'show-modal' }, 'Dari awal'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'drawer-end', command: 'show-modal' }, 'Dari akhir'),
  ),
  drawer({ id: 'drawer-start', side: 'start', title: 'Awal' },
    text({ variant: 'small', tone: 'muted' }, 'Ditambatkan pada tepi awal — sebelah kiri dalam bahasa yang ditulis kiri ke kanan.'),
  ),
  drawer({ id: 'drawer-end', title: 'Akhir' },
    text({ variant: 'small', tone: 'muted' }, 'Bawaannya: ditambatkan pada tepi akhir.'),
  ),
)

Lebar

Panjang CSS apa pun. Ia dibatasi pada 90% viewport, jadi laci lebar tetap muat di ponsel.

Sempit

width: 14rem

Lebar

width: 34rem

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

Sebagai menu navigasi

Pola yang diinginkan kebanyakan situs: tombol menu di bilahnya, tautannya di dalam laci.

fragment(
  appBar({ brand: 'sitelo' },
    appBarSpacer(),
    appBarActions(
      iconButton({
        label: 'Buka navigasi',
        variant: 'ghost',
        color: 'neutral',
        commandfor: 'drawer-nav', command: 'show-modal',
        icon: icon('menu'),
      }),
    ),
  ),
  drawer({ id: 'drawer-nav', title: 'Navigasi' },
    navLink({ href: '#docs', current: true }, 'Dokumentasi'),
    navLink({ href: '#ui' }, 'UI'),
    navLink({ href: '#examples' }, 'Contoh'),
    navLink({ href: '#about' }, 'Tentang'),
    divider({ spacing: 'sm' }),
    button({ block: true }, 'Mulai'),
  ),
)

Panel filter

Filter

Jenis
Tag
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: 'Jenis',
        name: 'drawer-type',
        value: 'guide',
        options: [
          { value: 'guide', label: 'Panduan' },
          { value: 'example', label: 'Contoh' },
          { value: 'all', label: 'Semuanya' },
        ],
      }),
      choiceGroup({
        legend: 'Tag',
        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' }, 'Batal'),
        button('Terapkan'),
      ),
    ),
  ),
)

Penggulungan latar

Halaman di belakang laci yang terbuka tidak tergulir — kunci hanya-CSS yang sama dengan yang dipakai modal(), tanpa skrip dan tanpa apa pun yang perlu diinisialisasi. Berikan lockScroll: false agar latarnya tergulir seperti biasa.

Props

PropTipeBawaanDeskripsi
idstring—Wajib. Apa yang ditunjuk commandfor sebuah pemicu.
titleChild—Judul, sekaligus nama dialognya yang dapat diakses.
side'start' | 'end''end'Pada tepi mana ia ditambatkan.
widthstring'20rem'Lebar panel, dibatasi pada 90vw.
closablebooleantrueMenampilkan × di kepalanya.
closeLabelstring'Close'Nama yang dapat diakses untuk tombol itu.
lockScrollbooleantrueMenghentikan penggulungan halaman di belakangnya selagi ia terbuka.