Barra applicazione
In questa pagina
Una barra applicazione è un <header> con dentro una riga. I pezzi sono separati così puoi disporli: appBarNav() per i link, appBarSpacer() per spingere ciò che segue all’estremità opposta, e appBarActions() per i pulsanti finali.
Barra di base
appBar({ brand: 'sitelo' },
appBarSpacer(),
appBarActions(
button({ size: 'sm', variant: 'soft' }, 'Accedi'),
),
)Con la navigazione
navLink() è lo stile di link per una barra; current segna la pagina attiva con aria-current oltre che con il colore.
appBar({ brand: 'sitelo' },
appBarNav(
navLink({ href: '#docs', current: true }, 'Documentazione'),
navLink({ href: '#ui' }, 'UI'),
navLink({ href: '#examples' }, 'Esempi'),
),
appBarSpacer(),
appBarActions(
button({ size: 'sm', variant: 'outline', color: 'neutral' }, 'GitHub'),
button({ size: 'sm' }, 'Inizia'),
),
)Una marca con un simbolo
La marca accetta qualunque markup, e punta a / a meno che href non dica altrimenti.
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')),
)Appiccicata e sfocata
sticky fissa la barra in cima al contenitore che scorre; blur la rende traslucida così il contenuto le passa sotto. Qui sono mostrate entrambe dentro un riquadro che scorre, invece che sulla pagina stessa.
Scorrimi — paragrafo 1.
Scorrimi — paragrafo 2.
Scorrimi — paragrafo 3.
Scorrimi — paragrafo 4.
Scorrimi — paragrafo 5.
Scorrimi — paragrafo 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' }, 'Scorrimi — paragrafo ' + (index + 1) + '.'),
),
),
),
)Che si toglie di mezzo allo scorrimento
sticky: 'auto' tiene la barra fissata, ma la fa scivolare via mentre la pagina scorre verso il basso e la riporta appena scorre verso l’alto o arriva in cima. Resta visibile finché il focus da tastiera è al suo interno o un suo menu è aperto.
In Chromium è tutto CSS, @container scroll-state(scrolled), e non si scarica nulla. Gli altri browser scaricano un piccolo modulo al caricamento della pagina, che osserva lo scorrimento al suo posto. La barra segue la pagina; dentro un riquadro scorrevole tuo, come questo, dai anche al riquadro container-type: scroll-state.
Scorri giù, poi torna su — paragrafo 1.
Scorri giù, poi torna su — paragrafo 2.
Scorri giù, poi torna su — paragrafo 3.
Scorri giù, poi torna su — paragrafo 4.
Scorri giù, poi torna su — paragrafo 5.
Scorri giù, poi torna su — paragrafo 6.
Scorri giù, poi torna su — paragrafo 7.
Scorri giù, poi torna su — paragrafo 8.
Scorri giù, poi torna su — paragrafo 9.
Scorri giù, poi torna su — paragrafo 10.
Scorri giù, poi torna su — paragrafo 11.
Scorri giù, poi torna su — paragrafo 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' }, 'Scorri giù, poi torna su — paragrafo ' + (index + 1) + '.'),
),
),
),
)Con un pannello laterale sugli schermi piccoli
Lo schema consueto: i link nella barra su desktop, un pulsante che apre un drawer() su un telefono. Il pannello è un <dialog> che il pulsante apre con un command, quindi non serve alcuno script.
fragment(
appBar({ brand: 'sitelo' },
appBarSpacer(),
appBarActions(
themeToggle(),
iconButton({
label: 'Apri la navigazione',
variant: 'ghost',
color: 'neutral',
commandfor: 'app-bar-drawer', command: 'show-modal',
icon: icon('menu'),
}),
),
),
drawer({ id: 'app-bar-drawer', title: 'Navigazione' },
navLink({ href: '#docs' }, 'Documentazione'),
navLink({ href: '#ui' }, 'UI'),
navLink({ href: '#examples' }, 'Esempi'),
),
)Props
appBar():
| Prop | Tipo | Predefinito | Descrizione |
|---|---|---|---|
brand | Child | — | Contenuto del link della marca all’inizio. |
href | string | '/' | Dove punta la marca. |
sticky | boolean | 'auto' | false | Fissa la barra in cima durante lo scorrimento. 'auto' la nasconde anche mentre scorri verso il basso. |
blur | boolean | false | Sfondo traslucido con sfocatura dietro. |
as | string | 'header' | Elemento da renderizzare. |
I pezzi:
| Pezzo | Props | Predefinito | Descrizione |
|---|---|---|---|
appBarNav | — | Un elemento nav che contiene i link. | |
appBarSpacer | — | Spazio flessibile; tutto ciò che segue va all’estremità opposta. | |
appBarActions | — | Gruppo di pulsanti in coda. | |
navLink | href, current, color | — | Un link con lo stile della barra; current segna la pagina attiva. |