Bilah aplikasi
Di halaman ini
Bilah aplikasi adalah sebuah <header> dengan satu baris di dalamnya. Bagian-bagiannya terpisah agar Anda bisa menatanya: appBarNav() untuk tautan, appBarSpacer() untuk mendorong apa pun setelahnya ke ujung terjauh, dan appBarActions() untuk tombol-tombol di ujungnya.
Bilah aplikasi dasar
appBar({ brand: 'sitelo' },
appBarSpacer(),
appBarActions(
button({ size: 'sm', variant: 'soft' }, 'Masuk'),
),
)Dengan navigasi
navLink() adalah gaya tautan untuk sebuah bilah; current menandai halaman aktif dengan aria-current selain dengan warna.
appBar({ brand: 'sitelo' },
appBarNav(
navLink({ href: '#docs', current: true }, 'Dokumentasi'),
navLink({ href: '#ui' }, 'UI'),
navLink({ href: '#examples' }, 'Contoh'),
),
appBarSpacer(),
appBarActions(
button({ size: 'sm', variant: 'outline', color: 'neutral' }, 'GitHub'),
button({ size: 'sm' }, 'Mulai'),
),
)Merek dengan tanda
Merek menerima markup apa pun, dan menaut ke / kecuali href menyatakan lain.
appBar({
href: '#home',
brand: stack({ direction: 'row', gap: 'sm', inline: true, align: 'center' },
avatar({ name: 'S', size: 'sm', square: true, color: 'primary' }),
'sitelo',
),
},
appBarSpacer(),
appBarActions(chip({ size: 'sm', color: 'neutral' }, 'v2.6.3')),
)Lengket dan buram
sticky menyematkan bilahnya di bagian atas wadah gulir; blur membuatnya tembus cahaya sehingga konten lewat di bawahnya. Keduanya ditampilkan di sini dalam kotak bergulir, bukan di halaman itu sendiri.
Gulir saya — paragraf 1.
Gulir saya — paragraf 2.
Gulir saya — paragraf 3.
Gulir saya — paragraf 4.
Gulir saya — paragraf 5.
Gulir saya — paragraf 6.
div({ style: 'height: 12rem; overflow: auto; border: 1px solid var(--su-border); border-radius: 0.6rem' },
appBar({ brand: 'sitelo', sticky: true, blur: true },
appBarSpacer(),
appBarActions(chip({ size: 'sm', color: 'primary' }, 'lengket')),
),
container({ size: 'sm', style: 'padding-block: 1rem' },
stack({ gap: 'md' },
...Array.from({ length: 6 }, (unused, index) =>
text({ variant: 'small', tone: 'muted' }, 'Gulir saya — paragraf ' + (index + 1) + '.'),
),
),
),
)Menyingkir saat menggulir
sticky: 'auto' tetap menyematkan bilahnya, tetapi menggesernya keluar selama halaman digulir ke bawah dan memunculkannya kembali begitu digulir ke atas atau sampai di bagian paling atas. Bilah tetap terlihat selama fokus keyboard ada di dalamnya atau ada menu di dalamnya yang terbuka.
Di Chromium semuanya CSS, @container scroll-state(scrolled), dan tidak ada yang diunduh. Peramban lain mengunduh modul kecil saat halaman dimuat, yang mengamati guliran sebagai gantinya. Bilah mengikuti halaman; di dalam kotak bergulir milik Anda sendiri, seperti yang ini, beri kotaknya container-type: scroll-state juga.
Gulir ke bawah, lalu kembali ke atas — paragraf 1.
Gulir ke bawah, lalu kembali ke atas — paragraf 2.
Gulir ke bawah, lalu kembali ke atas — paragraf 3.
Gulir ke bawah, lalu kembali ke atas — paragraf 4.
Gulir ke bawah, lalu kembali ke atas — paragraf 5.
Gulir ke bawah, lalu kembali ke atas — paragraf 6.
Gulir ke bawah, lalu kembali ke atas — paragraf 7.
Gulir ke bawah, lalu kembali ke atas — paragraf 8.
Gulir ke bawah, lalu kembali ke atas — paragraf 9.
Gulir ke bawah, lalu kembali ke atas — paragraf 10.
Gulir ke bawah, lalu kembali ke atas — paragraf 11.
Gulir ke bawah, lalu kembali ke atas — paragraf 12.
div({ style: 'height: 12rem; overflow: auto; container-type: scroll-state; border: 1px solid var(--su-border); border-radius: 0.6rem' },
appBar({ brand: 'sitelo', sticky: 'auto', blur: true },
appBarSpacer(),
appBarActions(chip({ size: 'sm', color: 'primary' }, 'auto')),
),
container({ size: 'sm', style: 'padding-block: 1rem' },
stack({ gap: 'md' },
...Array.from({ length: 12 }, (unused, index) =>
text({ variant: 'small', tone: 'muted' }, 'Gulir ke bawah, lalu kembali ke atas — paragraf ' + (index + 1) + '.'),
),
),
),
)Dengan laci di layar kecil
Pola yang lazim: tautan di bilah pada desktop, sebuah tombol yang membuka drawer() di ponsel. Lacinya adalah <dialog> yang dibuka tombol lewat command, jadi tidak butuh skrip.
fragment(
appBar({ brand: 'sitelo' },
appBarSpacer(),
appBarActions(
themeToggle(),
iconButton({
label: 'Buka navigasi',
variant: 'ghost',
color: 'neutral',
commandfor: 'app-bar-drawer', command: 'show-modal',
icon: icon('menu'),
}),
),
),
drawer({ id: 'app-bar-drawer', title: 'Navigasi' },
navLink({ href: '#docs' }, 'Dokumentasi'),
navLink({ href: '#ui' }, 'UI'),
navLink({ href: '#examples' }, 'Contoh'),
),
)Props
appBar():
| Prop | Tipe | Bawaan | Deskripsi |
|---|---|---|---|
brand | Child | — | Isi tautan merek di bagian awalnya. |
href | string | '/' | Ke mana mereknya menaut. |
sticky | boolean | 'auto' | false | Menyematkan bilahnya di atas saat menggulir. 'auto' juga menyembunyikannya saat menggulir ke bawah. |
blur | boolean | false | Latar tembus cahaya dengan efek buram di belakangnya. |
as | string | 'header' | Elemen yang dirender. |
Bagian-bagiannya:
| Bagian | Props | Bawaan | Deskripsi |
|---|---|---|---|
appBarNav | — | Elemen nav yang memuat tautannya. | |
appBarSpacer | — | Celah lentur; semua setelahnya pergi ke ujung terjauh. | |
appBarActions | — | Kelompok tombol di bagian akhir. | |
navLink | href, current, color | — | Tautan bergaya untuk bilahnya; current menandai halaman aktif. |