Propriété CSS scroll-timeline-name
Baseline 2026>
Nouvellement disponible
Depuis octobre 2026, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.
La propriété CSS scroll-timeline-name est utilisée pour définir le nom d'une chronologie de progression de défilement nommée.
Syntaxe
/* Valeurs avec un mot-clé */
scroll-timeline-name: none;
/* Chronologie nommée */
scroll-timeline-name: --custom_name_for_timeline;
/* Valeurs globales */
scroll-timeline-name: inherit;
scroll-timeline-name: initial;
scroll-timeline-name: revert;
scroll-timeline-name: revert-layer;
scroll-timeline-name: unset;
Valeurs
Cette propriété est définie comme l'une des valeurs suivantes :
none-
La chronologie n'a pas de nom.
<dashed-ident>-
Un identifiant personnalisé arbitraire définissant un nom pour une chronologie de progression de défilement, qui peut ensuite être référencé dans une propriété
animation-timeline.
Description
La propriété scroll-timeline-name est utilisée pour définir le nom d'une chronologie de progression de défilement nommée, qui progresse lorsque l'on fait défiler un élément défilable (scroller) entre le haut et le bas (ou la gauche et la droite).
Définissez la propriété scroll-timeline-name sur le scroller qui fournit la chronologie. Le nom est ensuite référencé dans une déclaration animation-timeline pour indiquer l'élément du conteneur utilisé pour piloter la progression de l'animation avec l'action de défilement.
Si l'élément ne déborde pas de son conteneur dans la dimension de l'axe ou si le débordement est masqué ou tronqué, aucune chronologie n'est créée.
La propriété scroll-timeline-name, ainsi que la propriété scroll-timeline-axis, peut également être définie en utilisant le raccourci scroll-timeline.
Définition formelle
| Valeur initiale | none |
|---|---|
| Applicabilité | conteneurs d'ascenseurs |
| Héritée | non |
| Valeur calculée | none ou une liste ordonnée d'identifiants |
| Type d'animation | Non animable |
Syntaxe formelle
scroll-timeline-name =
[ none | <dashed-ident> ]#
Exemples
>Créer une animation de chronologie de progression de défilement nommée
Dans cet exemple, une chronologie de progression de défilement nommée --chronologie-du-carre est définie en utilisant la propriété scroll-timeline-name sur l'élément avec l'ID container.
Cette chronologie est ensuite appliquée à l'animation sur l'élément #square en utilisant animation-timeline: --chronologie-du-carre.
HTML
Le HTML pour l'exemple est montré ci-dessous.
<div id="container">
<div id="square"></div>
<div id="stretcher"></div>
</div>
CSS
Le CSS pour le conteneur le définit comme la source d'une chronologie de progression de défilement nommée --chronologie-du-carre en utilisant la propriété scroll-timeline-name. Aucun axe de la barre de défilement n'est défini ici, car l'axe vertical est utilisé par défaut.
La hauteur du conteneur est définie sur 300px, et le conteneur est également configuré pour créer une barre de défilement verticale si son contenu déborde (la règle CSS height sur l'élément stretcher ci-dessous fait en sorte que le contenu déborde de son conteneur).
#container {
height: 300px;
overflow-y: scroll;
scroll-timeline-name: --chronologie-du-carre;
position: relative;
}
Le CSS ci-dessous définit un carré qui tourne en fonction de la chronologie fournie par la propriété animation-timeline, qui est définie sur la chronologie nommée --chronologie-du-carre ci-dessus.
#square {
background-color: deeppink;
width: 100px;
height: 100px;
margin-top: 100px;
animation-name: rotateAnimation;
animation-duration: 1ms; /* Firefox nécessite cela pour appliquer l'animation */
animation-timeline: --chronologie-du-carre;
position: absolute;
bottom: 0;
}
#stretcher {
height: 600px;
background: #dedede;
}
@keyframes rotateAnimation {
from {
transform: rotate(0deg);
}
to {
transform: rotate(360deg);
}
}
La règle CSS stretcher définit la hauteur du bloc à 600px, ce qui crée un contenu qui déborde de l'élément conteneur, créant ainsi des barres de défilement.
Sans cet élément, le contenu ne déborde pas du conteneur, il n'y a pas de barre de défilement et donc aucune chronologie de défilement à associer à la chronologie d'animation.
Résultat
Faites défiler la barre verticale pour voir le carré s'animer au fur et à mesure du défilement.
Spécifications
| Spécification |
|---|
| Scroll-driven Animations> # scroll-timeline-name> |
Compatibilité des navigateurs
Voir aussi
- La propriété
animation-timeline - Les propriétés
scroll-timeline,scroll-timeline-axis - La propriété
timeline-scope - Les chronologies d'animation pilotées par le défilement
- Le module d'animations pilotées par le défilement CSS