Navigation de collection
La navigation de collection est la liste de fin d’article qui relie les entrées d’une même collection éditoriale. Elle apparaît seulement lorsque l’entrée de blogue ou d’AJA courante déclare collection: et qu’au moins une entrée sœur possède la même valeur collection: ou la liste sous collections:. C’est une séquence locale, non une liste de lectures connexes générique.
Quand l’utiliser#
- Un ensemble de billets de blogue ou de notes AJA porte un sujet ou une séquence éditoriale durable et les lecteurs bénéficient de circuler entre ses entrées
- Le nom de collection est assez stable pour apparaître dans les métadonnées d’une entrée et servir de clé de données
- Utilisez
related:pour un petit ensemble intentionnel de pages adjacentes qui ne sont pas membres d’une même collection - N’utilisez pas une collection seulement pour ajouter un badge ou pour grouper du contenu temporairement; une collection vide ou d’une seule entrée ne rend rien
Implémentation#
collection: accessibilityUne entrée peut aussi appartenir à plus d’une collection :
collections:
- accessibility
- web-performance{{ partial "post-collection.html" . }}<aside class="flow-section border-t border-line pt-[var(--space-s-m)]" aria-labelledby="collection-heading">
<h2 id="collection-heading" class="meta m-0">Collection: Accessibilité</h2>
<div class="mt-[var(--space-xs)] grid gap-0 border-t border-line">
<a class="index-row sm:grid-cols-[minmax(0,1fr)_7rem]" href="/fr/blog/example/">
<span class="collection-row-title">Entrée exemple</span>
<time class="collection-row-date sm:text-right" datetime="2026-08-19">2026.08.19</time>
</a>
</div>
</aside>layouts/partials/post-collection.html parcourt les pages régulières de la section courante, exclut la page courante et cherche collection: ou collections:. Il ordonne les résultats par poids, puis date et titre, et ne rend rien sans entrée sœur. Les layouts uniques de blogue et d’AJA appellent le partial après le corps de l’article. Le CSS réutilise les traitements d’index-row et de métadonnées du site; il n’y a pas de JavaScript.
Options#
| Front matter | Rôle |
|---|---|
collection | Une clé de collection principale sur la page courante; elle fournit aussi le nom de collection visible |
collections | Clés supplémentaires dans les pages sœurs qui doivent apparaître dans la navigation de la collection principale |
weight | Ordre principal dans une collection; les dates et titres rendent les égalités déterministes |
Manifeste d’interface
- Nature
- Composant
- Catégorie
- Navigation
- Statut
- Implémenté
- Implémentation
- Partial:
layouts/partials/post-collection.htmllayouts/blog/single.htmllayouts/til/single.htmlCSS:assets/css/site.cssi18n:collection
Accessibilité#
- Le composant est un
<aside>nommé par son propre<h2>: les technologies d’assistance annoncent donc le contexte de collection avant ses liens. - Chaque entrée est un lien ordinaire avec un titre visible et une date
<time>lisible par machine. Tab atteint les entrées dans l’ordre affiché et Entrée en suit une. - Le composant ne rend pas de point de repère vide. Une entrée unique n’a aucune destination sœur et ne rend donc rien non plus.
- Gardez un libellé de collection significatif sans vous fier au badge de métadonnées; le titre fournit le contexte à tous les lecteurs.