CKTIS / CSS
view-timeline — raccourci pour une chronologie de progression de vue nommée
La propriété view-timeline déclare sur un élément une chronologie de progression nommée, déterminée par sa position dans une zone de défilement. Elle combine le nom, l’axe et les retraits ; une animation s’y raccorde séparément avec animation-timeline.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
view-timeline: [ <'view-timeline-name'> [ <'view-timeline-axis'> || <'view-timeline-inset'> ]? ]#;view-timeline est le raccourci de view-timeline-name, view-timeline-axis et view-timeline-inset. Il déclare une chronologie sur l’élément suivi, mais ne lance pas lui-même d’animation. La progression dépend du passage de l’élément dans la plage de visibilité de son ancêtre défilant le plus proche, et non du temps écoulé.
Le nom est un identifiant commençant par -- ; none ne déclare aucune chronologie nommée. Les valeurs par défaut des composants sont none, block et auto. Le raccourci réinitialise les composants omis. block et inline sélectionnent les axes logiques, tandis que x et y sélectionnent les axes physiques. Les virgules séparent plusieurs chronologies ; dans la grammaire, # désigne une telle liste.
Les retraits facultatifs acceptent une ou deux valeurs : auto ou des longueurs/pourcentages. Une valeur s’applique aux deux extrémités ; deux valeurs précisent le début et la fin. Les valeurs positives réduisent la plage de visibilité, les négatives l’élargissent. Les pourcentages se rapportent à la dimension de la zone de défilement, tandis que auto utilise scroll-padding.
Dans l’exemple, animation-timeline: --card raccorde l’animation à la chronologie déclarée. Placez cette déclaration après animation, qui réinitialise le choix de la chronologie. La plage complète par défaut va de la première entrée à la sortie complète. L’exemple a été exécuté dans un environnement isolé avec Chromium 157.0.8103.51, et la sortie de la console correspondait exactement à celle attendue. Une déclaration CSS ne garantit pas à elle seule la prise en charge par le navigateur : testez aussi l’exemple dans votre navigateur.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Named view progress timeline</title>
<style>
.scroller {
height: 200px;
width: min(100%, 24rem);
overflow-y: auto;
writing-mode: horizontal-tb;
border: 1px solid;
}
.space { height: 300px; }
.subject { min-height: 100px; background: royalblue; color: white; }
@supports (view-timeline: --card block) and (view-timeline-inset: 10% 20%) and (animation-timeline: --card) {
.subject {
view-timeline: --card block;
view-timeline-inset: 10% 20%;
animation: fade linear both;
animation-duration: auto;
animation-timeline: --card;
}
}
@keyframes fade {
from { opacity: 0.35; }
to { opacity: 1; }
}
</style>
</head>
<body>
<p>Scroll the panel to bring the card into view.</p>
<div class="scroller" role="region" aria-label="View timeline demo" tabindex="0">
<div class="space" aria-hidden="true"></div>
<div class="subject">Timeline card</div>
<div class="space" aria-hidden="true"></div>
</div>
<script>
if (CSS.supports('view-timeline', '--card block') &&
CSS.supports('view-timeline-inset', '10% 20%') &&
CSS.supports('animation-timeline', '--card')) {
const style = getComputedStyle(document.querySelector('.subject'));
console.log('Named view timeline syntax: supported');
console.log(`Computed name and axis: ${style.getPropertyValue('view-timeline-name')} ${style.getPropertyValue('view-timeline-axis')}`);
console.log(`Computed inset: ${style.getPropertyValue('view-timeline-inset')}`);
console.log(`Computed animation timeline: ${style.getPropertyValue('animation-timeline')}`);
} else {
console.log('Named view timeline syntax: unsupported');
}
</script>
</body>
</html>Résultat
Named view timeline syntax: supported Computed name and axis: --card block Computed inset: 10% 20% Computed animation timeline: --card
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.