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

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.

Fontes