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

CKTIS / CSS

view-timeline-name — dar nomes a linhas temporais de progresso da visualização

view-timeline-name atribui nomes a linhas temporais baseadas no movimento de um elemento através de uma área de deslocamento. Uma animação faz referência a um nome através de animation-timeline; o seu progresso depende do deslocamento, não dos segundos decorridos.

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

Sintaxe

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

view-timeline-name declara linhas temporais de progresso da visualização com nome no elemento cuja posição é seguida. O progresso descreve a passagem da sua caixa pela área visível do antecessor mais próximo que seja um contentor de deslocamento. Não corresponde à percentagem de superfície visível nem ao progresso de deslocamento de todo o documento.

O valor é uma lista separada por vírgulas de none ou nomes <dashed-ident>, como --card. none não atribui qualquer nome à posição correspondente na lista. O valor inicial é none; a propriedade aplica-se a todos os elementos, não é herdada e não é animável.

Atribuir um nome não inicia uma animação por si só: liga-a através de animation-timeline: --card. view-timeline-axis seleciona o eixo (inicialmente block), enquanto view-timeline-inset ajusta o intervalo de visibilidade. Em alternativa, a função view() cria uma linha temporal anónima. Coloca animation-timeline depois da abreviatura animation, que repõe essa definição.

No exemplo, o elemento define e utiliza a sua própria linha temporal. A opacidade aumenta à medida que atravessa o contentor e diminui quando se desloca para trás. É necessário verificar localmente o comportamento no navegador de destino.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>view-timeline-name</title>
<style>
  .scroller {
    height: 200px;
    overflow-y: auto;
    border: 2px solid;
    writing-mode: horizontal-tb;
  }
  .space { height: 200px; }
  .subject {
    height: 100px;
    background: royalblue;
    view-timeline-name: --card;
    view-timeline-axis: block;
    view-timeline-inset: 0;
    animation: fade auto linear both;
    animation-timeline: --card;
  }
  @keyframes fade {
    from { opacity: 0.2; }
    to { opacity: 1; }
  }
</style>
<div class="scroller" tabindex="0" aria-label="Scroll demo">
  <div class="space"></div>
  <div class="subject"></div>
  <div class="space"></div>
</div>

Resultado

scrollTop 0 → opacity 0.2; scrollTop 150 → opacity 0.6; scrollTop 300 → opacity 1.

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