CKTIS / CSS
view-timeline — abreviatura de uma linha temporal de progresso de visualização com nome
A propriedade view-timeline declara num elemento uma linha temporal de progresso com nome, determinada pela sua posição numa área de deslocamento. Combina o nome, o eixo e os recuos; a animação liga-se separadamente através de animation-timeline.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
view-timeline: [ <'view-timeline-name'> [ <'view-timeline-axis'> || <'view-timeline-inset'> ]? ]#;view-timeline é a abreviatura de view-timeline-name, view-timeline-axis e view-timeline-inset. Declara uma linha temporal no elemento observado, mas não inicia uma animação por si só. O progresso depende da passagem do elemento pelo intervalo de visibilidade do seu antepassado com deslocamento mais próximo, não do tempo decorrido.
O nome é um identificador que começa por --; none não declara nenhuma linha temporal com nome. Os valores predefinidos dos componentes são none, block e auto. A abreviatura repõe os componentes omitidos. block e inline selecionam eixos lógicos, enquanto x e y selecionam eixos físicos. As vírgulas separam várias linhas temporais; # na gramática representa uma lista deste tipo.
Os recuos opcionais aceitam um ou dois valores: auto ou comprimentos/percentagens. Um valor aplica-se a ambas as extremidades; dois especificam o início e o fim. Os valores positivos reduzem o intervalo de visibilidade e os negativos alargam-no. As percentagens referem-se à dimensão da área de deslocamento, enquanto auto utiliza scroll-padding.
No exemplo, animation-timeline: --card liga a animação à linha temporal declarada. Coloca esta declaração depois de animation, que repõe a seleção da linha temporal. O intervalo completo predefinido vai da primeira entrada até à saída completa. O exemplo foi executado num ambiente isolado com Chromium 157.0.8103.51 e o resultado na consola correspondeu exatamente ao esperado. Uma declaração CSS não garante, por si só, que o navegador a suporte, por isso testa o exemplo também no teu navegador.
Exemplos
<!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>Resultado
Named view timeline syntax: supported Computed name and axis: --card block Computed inset: 10% 20% Computed animation timeline: --card
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.