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

CKTIS / CSS

scroll-timeline-name — dar nomes a linhas temporais de deslocamento

scroll-timeline-name dá nomes às linhas temporais do progresso do deslocamento. animation-timeline associa animações a essas linhas temporais.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

scroll-timeline-name: [ none | <dashed-ident> ]#;

scroll-timeline-name declara nomes de linhas temporais num contentor de deslocamento. none é o valor inicial e não declara nenhuma linha temporal com nome. Um <dashed-ident> começa por --; # indica uma lista separada por vírgulas, como --a, --b. A propriedade não é herdada nem animável.

scroll-timeline-axis seleciona o eixo; o valor predefinido é block. Sem um intervalo deslocável, a linha temporal fica inativa. É o progresso do deslocamento, e não os segundos decorridos, que controla a animação.

animation-timeline faz referência ao nome. Coloca esta declaração depois da abreviatura animation, que a repõe. auto ajusta a duração à linha temporal de deslocamento. O exemplo anima um descendente do contentor, evitando depender da pesquisa de nomes fora da respetiva subárvore.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>scroll-timeline-name</title>
<style>
  .scroller {
    height: 160px;
    overflow-y: auto;
    scroll-timeline-name: --progress;
    scroll-timeline-axis: y;
  }
  .content { height: 640px; }
  .bar {
    position: sticky;
    top: 0;
    height: 12px;
    background: teal;
    transform-origin: left;
    animation: grow auto linear both;
    animation-timeline: --progress;
  }
  @keyframes grow {
    from { transform: scaleX(0); }
    to { transform: scaleX(1); }
  }
</style>
<div class="scroller" tabindex="0" aria-label="Scroll progress 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.

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