App-Bar
Auf dieser Seite
Eine App-Bar ist ein <header> mit einer Reihe darin. Die Teile sind getrennt, damit du sie anordnen kannst: appBarNav() für Links, appBarSpacer(), um alles Folgende ans andere Ende zu schieben, und appBarActions() für die Buttons am Schluss.
Einfache App-Bar
appBar({ brand: 'sitelo' },
appBarSpacer(),
appBarActions(
button({ size: 'sm', variant: 'soft' }, 'Anmelden'),
),
)Mit Navigation
navLink() ist der Linkstil für eine Leiste; current markiert die aktive Seite nicht nur farblich, sondern auch mit aria-current.
appBar({ brand: 'sitelo' },
appBarNav(
navLink({ href: '#docs', current: true }, 'Doku'),
navLink({ href: '#ui' }, 'UI'),
navLink({ href: '#examples' }, 'Beispiele'),
),
appBarSpacer(),
appBarActions(
button({ size: 'sm', variant: 'outline', color: 'neutral' }, 'GitHub'),
button({ size: 'sm' }, 'Loslegen'),
),
)Eine Marke mit Zeichen
Die Marke nimmt beliebiges Markup und verlinkt auf /, sofern href nichts anderes sagt.
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')),
)Sticky und verwischt
sticky heftet die Leiste an den oberen Rand des Scroll-Containers; blur macht sie durchscheinend, sodass Inhalt darunter durchläuft. Beides wird hier in einer scrollenden Box gezeigt, nicht auf der Seite selbst.
Scroll mich — Absatz 1.
Scroll mich — Absatz 2.
Scroll mich — Absatz 3.
Scroll mich — Absatz 4.
Scroll mich — Absatz 5.
Scroll mich — Absatz 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' }, 'sticky')),
),
container({ size: 'sm', style: 'padding-block: 1rem' },
stack({ gap: 'md' },
...Array.from({ length: 6 }, (unused, index) =>
text({ variant: 'small', tone: 'muted' }, 'Scroll mich — Absatz ' + (index + 1) + '.'),
),
),
),
)Beim Scrollen aus dem Weg
sticky: 'auto' hält die Leiste angeheftet, schiebt sie aber weg, solange die Seite nach unten scrollt, und holt sie zurück, sobald sie nach oben scrollt oder den Anfang erreicht. Sie bleibt sichtbar, solange der Tastaturfokus in ihr liegt oder ein Menü in ihr offen ist.
In Chromium ist das reines CSS, @container scroll-state(scrolled), und es wird nichts geladen. Andere Browser laden beim Seitenaufruf ein kleines Modul, das stattdessen das Scrollen beobachtet. Die Leiste folgt der Seite; in einer eigenen scrollenden Box wie dieser hier braucht die Box zusätzlich container-type: scroll-state.
Nach unten scrollen, dann zurück — Absatz 1.
Nach unten scrollen, dann zurück — Absatz 2.
Nach unten scrollen, dann zurück — Absatz 3.
Nach unten scrollen, dann zurück — Absatz 4.
Nach unten scrollen, dann zurück — Absatz 5.
Nach unten scrollen, dann zurück — Absatz 6.
Nach unten scrollen, dann zurück — Absatz 7.
Nach unten scrollen, dann zurück — Absatz 8.
Nach unten scrollen, dann zurück — Absatz 9.
Nach unten scrollen, dann zurück — Absatz 10.
Nach unten scrollen, dann zurück — Absatz 11.
Nach unten scrollen, dann zurück — Absatz 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' }, 'Nach unten scrollen, dann zurück — Absatz ' + (index + 1) + '.'),
),
),
),
)Mit einem Drawer auf kleinen Bildschirmen
Das übliche Muster: Links in der Leiste am Desktop, ein Button, der am Telefon einen drawer() öffnet. Der Drawer ist ein <dialog>, den der Button per command öffnet — kein Skript nötig.
fragment(
appBar({ brand: 'sitelo' },
appBarSpacer(),
appBarActions(
themeToggle(),
iconButton({
label: 'Navigation öffnen',
variant: 'ghost',
color: 'neutral',
commandfor: 'app-bar-drawer', command: 'show-modal',
icon: icon('menu'),
}),
),
),
drawer({ id: 'app-bar-drawer', title: 'Navigation' },
navLink({ href: '#docs' }, 'Doku'),
navLink({ href: '#ui' }, 'UI'),
navLink({ href: '#examples' }, 'Beispiele'),
),
)Props
appBar():
| Prop | Typ | Standard | Beschreibung |
|---|---|---|---|
brand | Child | — | Inhalt des Marken-Links am Anfang. |
href | string | '/' | Wohin die Marke verlinkt. |
sticky | boolean | 'auto' | false | Heftet die Leiste beim Scrollen nach oben. 'auto' blendet sie zusätzlich beim Herunterscrollen aus. |
blur | boolean | false | Durchscheinender Hintergrund mit Backdrop-Blur. |
as | string | 'header' | Element, das gerendert wird. |
Die Teile:
| Teil | Props | Standard | Beschreibung |
|---|---|---|---|
appBarNav | — | Ein nav-Element, das die Links hält. | |
appBarSpacer | — | Flexible Lücke; alles danach rückt ans andere Ende. | |
appBarActions | — | Button-Gruppe am Ende. | |
navLink | href, current, color | — | Ein Link im Leistenstil; current markiert die aktive Seite. |