Barre d’application
Sur cette page
Une barre d’application est un <header> contenant une ligne. Les pièces sont séparées pour que vous puissiez les arranger : appBarNav() pour les liens, appBarSpacer() pour pousser la suite à l’autre bout, et appBarActions() pour les boutons de fin.
Barre de base
appBar({ brand: 'sitelo' },
appBarSpacer(),
appBarActions(
button({ size: 'sm', variant: 'soft' }, 'Se connecter'),
),
)Avec navigation
navLink() est le style de lien d’une barre ; current marque la page active avec aria-current en plus de la couleur.
appBar({ brand: 'sitelo' },
appBarNav(
navLink({ href: '#docs', current: true }, 'Documentation'),
navLink({ href: '#ui' }, 'UI'),
navLink({ href: '#examples' }, 'Exemples'),
),
appBarSpacer(),
appBarActions(
button({ size: 'sm', variant: 'outline', color: 'neutral' }, 'GitHub'),
button({ size: 'sm' }, 'Commencer'),
),
)Une marque avec un logo
La marque accepte n’importe quel balisage, et pointe vers / sauf si href en décide autrement.
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')),
)Collante et floutée
sticky épingle la barre en haut du conteneur de défilement ; blur la rend translucide pour que le contenu passe dessous. Les deux sont montrées ici dans une boîte défilante plutôt que sur la page elle-même.
Faites défiler — paragraphe 1.
Faites défiler — paragraphe 2.
Faites défiler — paragraphe 3.
Faites défiler — paragraphe 4.
Faites défiler — paragraphe 5.
Faites défiler — paragraphe 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' }, 'Faites défiler — paragraphe ' + (index + 1) + '.'),
),
),
),
)Qui s’efface au défilement
sticky: 'auto' garde la barre épinglée, mais la fait glisser hors de vue pendant que la page descend, et la ramène dès qu’elle remonte ou atteint le haut. Elle reste visible tant que le focus clavier est à l’intérieur ou qu’un de ses menus est ouvert.
Dans Chromium, c’est uniquement du CSS, @container scroll-state(scrolled), et rien n’est téléchargé. Les autres navigateurs chargent un petit module au chargement de la page, qui surveille le défilement à la place. La barre suit la page ; dans une boîte défilante à vous, comme celle-ci, donnez aussi à la boîte container-type: scroll-state.
Descendez, puis remontez — paragraphe 1.
Descendez, puis remontez — paragraphe 2.
Descendez, puis remontez — paragraphe 3.
Descendez, puis remontez — paragraphe 4.
Descendez, puis remontez — paragraphe 5.
Descendez, puis remontez — paragraphe 6.
Descendez, puis remontez — paragraphe 7.
Descendez, puis remontez — paragraphe 8.
Descendez, puis remontez — paragraphe 9.
Descendez, puis remontez — paragraphe 10.
Descendez, puis remontez — paragraphe 11.
Descendez, puis remontez — paragraphe 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' }, 'Descendez, puis remontez — paragraphe ' + (index + 1) + '.'),
),
),
),
)Avec un tiroir sur petits écrans
Le schéma habituel : des liens dans la barre sur ordinateur, un bouton qui ouvre un drawer() sur téléphone. Le tiroir est un <dialog> que le bouton ouvre avec un command, donc aucun script n’est nécessaire.
fragment(
appBar({ brand: 'sitelo' },
appBarSpacer(),
appBarActions(
themeToggle(),
iconButton({
label: 'Ouvrir la navigation',
variant: 'ghost',
color: 'neutral',
commandfor: 'app-bar-drawer', command: 'show-modal',
icon: icon('menu'),
}),
),
),
drawer({ id: 'app-bar-drawer', title: 'Navigation' },
navLink({ href: '#docs' }, 'Documentation'),
navLink({ href: '#ui' }, 'UI'),
navLink({ href: '#examples' }, 'Exemples'),
),
)Props
appBar() :
| Prop | Type | Défaut | Description |
|---|---|---|---|
brand | Child | — | Contenu du lien de marque au début. |
href | string | '/' | Vers où pointe la marque. |
sticky | boolean | 'auto' | false | Épingle la barre en haut au défilement. 'auto' la masque aussi quand on descend. |
blur | boolean | false | Fond translucide avec flou d’arrière-plan. |
as | string | 'header' | Élément à rendre. |
Les pièces :
| Pièce | Props | Défaut | Description |
|---|---|---|---|
appBarNav | — | Un élément nav qui porte les liens. | |
appBarSpacer | — | Espace flexible ; tout ce qui suit part à l’autre bout. | |
appBarActions | — | Groupe de boutons en fin de barre. | |
navLink | href, current, color | — | Un lien stylé pour la barre ; current marque la page active. |