Nœud 2.101 · CONCEPTBibliothèque de code08 MIN DE LECTURE
Publié : 6 nov. 2026

Chorégraphier Astro

Cinq motifs dont je suis contente cette semaine : mouvement vanilla, emplacements CSS, ghosts et i18n

Résumé

Un inventaire Concept de motifs de ce site : révélations ligne à ligne, emplacements de grille, lignes ghost et bascule de langue, plus une note rapide sur les transitions de page et le moteur de défilement GSAP réservé à sa propre passe.

Contexte

Cette note est le pendant côté code de Comment ce site a été construit, qui présente la pile de l’extérieur. Ici, j’ouvre des parties précises du code pour voir comment elles fonctionnent vraiment.

Alors, pourquoi Astro ? J’ai traversé plusieurs piles au fil des ans. Le bon vieux HTML et CSS écrits à la main (2006), Jekyll (2017), Next.js (2020), et maintenant Astro. C’est mon framework de prédilection aujourd’hui parce qu’il livre du HTML simple par défaut, et n’ajoute du JavaScript que quand on le lui demande. Ça convient à un site où la difficulté tient au mouvement et à la mise en page, pas aux données.

À côté du HTML, du CSS et de Tailwind, je passe beaucoup de temps dans les timelines (After Effects, Premiere, diaporamas) à séquencer des histoires pour que le timing tombe juste. Cette note lit le code comme je lis une timeline. Que fait un motif à l’écran ? Comment le code sous-jacent le met-il en place ?

Voyez ça comme un inventaire, pas un manuel. Pour chaque motif, j’ai noté :

  • Ce que le site fait : l’effet à l’écran, en mots simples.
  • Ma compréhension actuelle : ma lecture, souvent cadrée par une analogie de montage ou de mouvement (certaines restent provisoires).
  • Questions ouvertes : les fils qui deviendront des approfondissements.

Chaque extrait vient directement du dépôt de ce site. Comme je refactorise en écrivant, quelques snippets peuvent prendre du retard sur le code en ligne jusqu’à la prochaine révision de cette note.

Cette coupe Concept couvre cinq motifs dont je suis contente cette semaine, plus une note rapide sur les transitions de page. Le moteur de défilement est réservé à sa propre passe. D’autres snippets arriveront via le journal des versions, pendant que cette note reste au Concept.

Les motifs

A. Découpe en lignes (splitLines)

index.astroastro
<h2>
  <span class="reveal-line" style="--i: 1">{t('home.role1')}</span>
  <span class="reveal-line" style="--i: 2">{t('home.role2')}</span>
</h2>
<p data-split-lines data-split-start="3">{t('home.description')}</p>
<div class="hero-block" style="--i: 8"><!-- CTAs --></div>
BaseLayout.astro <script>, étapes seulementts
// 1. Envelopper chaque mot dans un <span>.
// 2. Lire l'offsetTop de chaque mot. Un nouveau top = une nouvelle ligne.
// 3. Reconstruire le paragraphe avec une .reveal-line par ligne, numérotée depuis data-split-start.
// 4. Quand la dernière ligne a fini son animation, remettre le paragraphe d'origine.

Ce que le site fait : dans le hero de l’accueil, le texte monte ligne par ligne : titre, paragraphe, puis boutons, dans un seul décalage.

Ma compréhension actuelle : c’est l’animateur de texte d’After Effects, avec « based on: lines » et un décalage. Les lignes du titre sont numérotées à la main (--i: 1, 2), mais les retours à la ligne d’un paragraphe dépendent de la largeur de l’écran, donc le script trouve où le navigateur a coupé les lignes et enveloppe chacune, en continuant le compte à partir de 3. Le CSS les décale ensuite avec --i. Quand c’est fini, le paragraphe redevient du HTML normal, pour se redisposer correctement au redimensionnement.

Questions ouvertes :

  • Pourquoi attendre document.fonts.ready ? Un échange de police tardif déplacerait les coupures de ligne.
  • animationend se déclenche une fois par animation, et chaque ligne en a deux. Comment le code attend-il la dernière ?
  • Avec le mouvement réduit activé, l’animation ne joue pas. Est-ce que ça veut dire que le paragraphe n’est jamais remis en place ?
  • SplitText de est gratuit maintenant. Dans quels cas est-ce que ça vaut encore le coup de coder le sien ?

B. Dessiner une ligne SVG (pathLength="1")

about.astroastro
<svg class="thread-svg" viewBox="0 0 2800 620" preserveAspectRatio="xMidYMid meet" aria-hidden="true">
  <path d={THREAD_PATH} stroke="rgba(224,67,67,0.18)" stroke-width="2" fill="none" />
  <path
    id="thread-draw"
    d={THREAD_PATH}
    stroke="#E04343"
    stroke-width="2"
    fill="none"
    pathLength="1"
    stroke-dasharray="1"
    stroke-dashoffset="1"
  />
</svg>

Ce que le site fait : sur la page À propos, un fil rouge se dessine le long de la timeline pendant que je parcours la piste épinglée. Une copie pâle du tracé entier reste en dessous.

Ma compréhension actuelle : c’est Trim Paths. pathLength="1" fait traiter la ligne par le navigateur comme si elle mesurait une unité, quelle que soit sa vraie longueur. Le tiret mesure aussi une unité, et le décalage le fait glisser. 1 veut dire pas commencé, 0 veut dire entièrement dessiné. La copie pâle en dessous sert de calque de fond qui montre le tracé avant qu’il ne soit encré. La valeur qui pilote le décalage au défilement vient de la scène  ; ce câblage est réservé à sa propre passe.

Questions ouvertes :

  • En mode mouvement réduit, le CSS pose stroke-dashoffset: 0 et écrase l’attribut écrit par le script. Est-ce que le CSS gagne toujours contre les attributs SVG ?
  • Les légendes HTML s’alignent sur les points SVG. Est-ce seulement parce que le rapport d’aspect de la piste correspond au viewBox ?

C. Emplacement de grille (0fr → 1fr)

[slug].astro <style>css
.node-slot {
  display: grid;
  grid-template-rows: 0fr;
  opacity: 0;
  transition:
    grid-template-rows 440ms var(--ease-sheet),
    opacity 300ms var(--ease-sheet);
}
.node-slot-inner {
  min-height: 0;
  overflow: hidden;
  visibility: hidden;
  transition: visibility 0s linear 300ms;
}
.note-card[data-node-state="active"] .node-slot {
  grid-template-rows: 1fr;
  opacity: 1;
}
.note-card[data-node-state="active"] .node-slot-inner {
  visibility: visible;
  transition-delay: 0s;
}

Ce que le site fait : quand une note devient active, sa carte dans le panneau latéral s’étend pour révéler le détail en dessous.

Ma compréhension actuelle : on ne peut pas animer vers height: auto, mais on peut animer une rangée de grille de 0fr (rien) à 1fr (sa taille naturelle). Le script ne change qu’un attribut, data-node-state, et le CSS fait tout le mouvement. Le délai de visibility garde le contenu visible jusqu’à la fin du fondu, puis le cache.

Questions ouvertes :

  • Est-ce que visibility: hidden empêche les utilisateurs du clavier de tabuler dans le contenu replié ? Est-ce pour ça que c’est là ?
  • Pourquoi l’élément intérieur a-t-il besoin de min-height: 0 ?
  • Le contrôle « feeds into » dans l’emplacement est un <span role="button"> à l’intérieur du lien de la carte. Pourquoi cette imbrication pose-t-elle problème, et quelle est la meilleure structure ?

D. Balise polymorphe (notes ghost)

journal/index.astroastro
---
const ghost = entry.data.launchState === 'ghost';
const Tag = ghost ? 'div' : 'a';
---
<Tag
  href={ghost ? undefined : `/${locale}/journal/${slug}`}
  class:list={['journal-row grid …', ghost ? 'journal-ghost' : 'group']}
  data-status={entry.data.status}
  data-tags={(entry.data.tags ?? []).join('|')}
>
  {ghost && (
    <p class="…">
      <svg aria-hidden="true"><!-- cadenas --></svg>
      {statusLabel} · {formatJournalDate(entry.data.date, locale)}
    </p>
  )}
  <!-- commun : numéro de nœud, titre, sous-titre, méta, résumé, tags -->
</Tag>

Ce que le site fait : dans l’index du journal, les notes publiées sont des lignes cliquables. Les notes ghost (prévues, pas encore écrites) leur ressemblent, mais elles montrent un cadenas, leur statut et leur date. Elles ne réagissent ni au survol ni au clic.

Ma compréhension actuelle : un modèle, deux balises HTML possibles. Si le frontmatter de la note dit launchState: "ghost", la ligne est construite comme un <div>. Sinon, c’est un lien <a>. Seules les lignes publiées reçoivent la classe group, donc les styles de survol sautent les ghosts tout seuls. Cette partie, c’est Tailwind. Les attributs data-* alimentent aussi les onglets de filtre.

Questions ouvertes :

  • Pourquoi undefined pour le href, plutôt qu’une chaîne vide ?
  • Est-ce qu’une ligne en <div> est sautée par le clavier et les lecteurs d’écran d’une façon qu’un lien mort ne le serait pas ?

E. Bascule de langue (pointLocale)

[slug].astroastro
---
const enPath = `/en/journal/${entry.data.translationSlug}`;
const frPath = `/fr/journal/${entry.data.translationSlug}`;
---
<div id="journal-stage" data-locale-en={enPath} data-locale-fr={frPath}>
[slug].astro <script>ts
const en = root.dataset.localeEn;
const fr = root.dataset.localeFr;
if (en) document.querySelector('[data-locale-target="en"]')?.setAttribute('href', en);
if (fr) document.querySelector('[data-locale-target="fr"]')?.setAttribute('href', fr);

Ce que le site fait : sur une note du journal, passer à l’anglais m’emmène vers la version anglaise de la même note, pas au début du journal.

Ma compréhension actuelle : la note écrit les deux URL de langue sur la page, en attributs data-. Un petit script les lit et met à jour les liens de langue de l’en-tête. La page et l’en-tête ne s’importent jamais l’un l’autre. Ils partagent deux attributs, comme deux services qui se mettent d’accord sur une convention de nommage de fichiers. Les deux langues utilisent le même slug, et c’est aussi comme ça que le planificateur de transition reconnaît un changement de langue.

Questions ouvertes :

  • Que se passe-t-il si une note n’existe pas encore en français ? Le lien mène-t-il à une 404 ?
  • Si les deux langues partagent un slug, l’en-tête pourrait-il construire le lien lui-même, sans script ?

F. Coupes de page (décision de montage, version légère)

BaseLayout.astro <script>ts
const localeSwap = from.page === to.page && from.slug === to.slug && from.lang !== to.lang;
const noteToNote = from.page === 'journal' && to.page === 'journal'
  && Boolean(from.slug) && Boolean(to.slug)
  && from.lang === to.lang;

const mode = reduce || localeSwap ? 'fade' : noteToNote ? 'article' : 'wipe';
global.csscss
html[data-vt="wipe"]::view-transition-new(site) {
  animation: vt-angled-wipe 720ms var(--ease-in-out) both;
}

@keyframes vt-angled-wipe {
  0%   { clip-path: polygon(0% -40%, 100% 0%, 100% 0%, 0% -40%); }
  100% { clip-path: polygon(0% 0%, 100% 0%, 100% 100%, 0% 100%); }
}

Ce que le site fait : trois sortes de coupe. D’une pièce à l’autre (Accueil, À propos, CV, Journal), on a un balayage en biais. D’une note à l’autre, le panneau latéral reste en place et l’essai s’enchaîne en fondu. Un changement de langue, ou le mouvement réduit, déclenche un simple fondu.

Ma compréhension actuelle : avant chaque navigation, le script étiquette la coupe (wipe, article ou fade) sur <html>. Le CSS lit cette étiquette. Cette partie est une liste de décisions de montage. Le balayage lui-même est un clip-path. La plomberie du planificateur (marquer les deux documents, le loader, l’epoch des clics) est en file d’attente avec l’approfondissement ClientRouter.

G. Scène de défilement (chorégraphie assumée, moteur reporté)

Sur l’accueil, À propos et le CV, le défilement desktop a du poids. Des sections se figent. Couleurs et piliers bougent sur une timeline. Mobile et prefers-reduced-motion retombent sur une simple pile.

J’ai dessiné ces temps : ce qui se fige, quand la couleur bascule, comment le pont Bienvenue atterrit, où le mouvement réduit coupe le spectacle. C’est de la chorégraphie, le même métier que sur Premiere et After Effects.

Le moteur dessous (, ScrollTrigger, , le ticker partagé, le démontage matchMedia) est une couche à part, et je l’ai sorti de cet inventaire. Le site part en production, et ce moteur a sa propre passe. C’est la première prochaine étape ci-dessous.

Premières intuitions

Trois idées apparaissent dans les motifs ci-dessus. Pas encore des principes :

  1. JavaScript écrit l’état, CSS fait le mouvement. data-node-state, data-vt, attributs data- de locale. Le script est la liste de décisions de montage ; la feuille de style est la bibliothèque de transitions.
  2. Le frontmatter décide, le modèle suit. launchState choisit <div> ou <a>. translationSlug oriente la bascule de langue.
  3. Chorégraphie et moteur sont des couches d’écriture distinctes. Je fixe la feuille de temps. Le ticker est maintenant la prochaine couche à apprendre.

Ce ne sont pas encore des détails standard. Ils fonctionnent sur ce site. Ils restent dans le périmètre de ce projet jusqu’à la fermeture des questions ouvertes.

Prochaines étapes

Toujours Concept (01)

  1. Passe d’appropriation / / ScrollTrigger : me plonger dans le code de la scène de défilement et faire entrer le ticker, matchMedia et le nettoyage dans la couche assumée.
  2. Approfondissement du cycle de vie ClientRouter : AbortController, transition:persist, ce qui survit à une coupe. En file d’attente.
  3. Ajouts de snippets plus tard : étoffer cet inventaire via le journal des versions, sans quitter le Concept.

Vers le Schéma (02), plus tard

  1. Intégrer les motifs élucidés sous forme de détails standard réutilisables, une fois les questions ouvertes fermées.

Termes clés

Définitions de travail, en langage simple :

  • pathLength : un attribut SVG qui fixe la longueur d’une ligne au nombre qu’on choisit. La base de Trim Paths dans le navigateur.
  • Unité fr : une part de l’espace dans une grille. 0fr → 1fr anime jusqu’à la taille naturelle du contenu.
  • Balise polymorphe : un modèle qui peut produire différents éléments HTML.
  • translationSlug : slug partagé entre locales pour que la bascule de langue reste sur la même note.
  • Liste de décisions de montage : étiqueter chaque coupe avec son type de transition avant qu’elle joue (wipe / article / fade).

Journal des versions

  • 06 nov. 2026 - Premier inventaire (v1.0) : cinq motifs, une note courte sur les coupes de page, et le moteur de défilement réservé à sa propre passe. Toujours Concept.