CKTIS / CSS
scroll-timeline — uma linha temporal nomeada de progresso da deslocação
A propriedade abreviada scroll-timeline define uma linha temporal nomeada num contentor de deslocação. Uma animação que use essa linha temporal progride de acordo com a posição de deslocação, em vez do tempo decorrido.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
scroll-timeline: [ <'scroll-timeline-name'> <'scroll-timeline-axis'>? ]#;scroll-timeline combina scroll-timeline-name e scroll-timeline-axis. Os nomes começam por --; none não define nenhuma linha temporal nomeada. Se o eixo for omitido, é usado block. As vírgulas separam várias definições. A propriedade não é herdada nem é animável.
block e inline dependem do modo de escrita; x e y indicam os eixos físicos. Se não existir um intervalo de deslocação no eixo selecionado, a linha temporal fica inativa. O progresso acompanha a posição ao longo de todo o intervalo de deslocação, e não a visibilidade de um elemento.
A declaração, por si só, não inicia uma animação. No exemplo, um descendente seleciona --progress através de animation-timeline. Coloque essa declaração depois de animation, porque a propriedade abreviada repõe a seleção da linha temporal. Deslocar-se para trás inverte o efeito. Esta versão exata do exemplo passou por uma verificação estrutural num navegador isolado. Isso não confirma que a largura da barra tenha sido medida em cada uma das posições de deslocação indicadas. Verifique o comportamento no navegador de destino antes da implementação.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>scroll-timeline</title>
<style>
.scroller {
width: 240px;
height: 160px;
overflow: auto;
scroll-timeline: --progress block;
}
.content { height: 640px; }
.bar {
position: sticky;
top: 0;
height: 12px;
background: teal;
transform-origin: left;
animation: fill linear both;
animation-timeline: --progress;
}
@keyframes fill {
from { transform: scaleX(0); }
to { transform: scaleX(1); }
}
</style>
<div class="scroller" tabindex="0" aria-label="Scroll demo">
<div class="content"><div class="bar"></div></div>
</div>Resultado
Expected visual result: the teal bar has zero width at scrollTop 0, half width at scrollTop 240, and full width at scrollTop 480. Scrolling backward reverses the change.
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.