Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes