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

CKTIS / CSS

timeline-trigger-activation-range-start

Define o início do intervalo de ativação de um acionador da linha cronológica. É um limiar para acionar uma ação, não uma definição do progresso da animação. A funcionalidade provém de um rascunho de trabalho e tem de ser testada no navegador de destino.

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

Sintaxe

timeline-trigger-activation-range-start: [ normal | <length-percentage> | <timeline-range-name> <length-percentage>? ]#;

timeline-trigger-activation-range-start define o início do intervalo de ativação; timeline-trigger-activation-range-end define o respetivo fim. O intervalo de ativação controla a ativação, enquanto o intervalo ativo controla a desativação. Esta declaração, por si só, não cria uma animação nem a liga a um acionador.

O valor inicial é normal. A propriedade aplica-se a todos os elementos, não é herdada e não é animável. O # na gramática indica uma lista separada por vírgulas e coordenada com timeline-trigger-name. auto não é permitido aqui.

Os valores têm o mesmo significado que em animation-range-start: normal significa o início da linha cronológica, uma percentagem isolada refere-se à linha cronológica inteira e, por exemplo, entry 50% significa metade do intervalo com o nome entry. Um nome de intervalo sem desvio significa 0% desse intervalo. Não se trata de um atraso em segundos nem de uma percentagem da duração da animação.

O exemplo utiliza um intervalo da linha cronológica de deslocamento de 25% a 75%. Com 400px de percurso deslocável, o início fica nos 100px. Depois de acionada, a animação progride com o tempo, não com a posição de deslocamento. A especificação é um rascunho de trabalho; não deduza o suporte apenas pela versão do navegador. O exemplo requer verificação local.

Exemplos

<!doctype html>
<meta charset="utf-8">
<style>
  .scroller { height: 200px; overflow-y: scroll; }
  .track { height: 600px; }
  .box {
    width: 80px;
    height: 80px;
    background: navy;
    animation: reveal 1s linear both;
    timeline-trigger-name: --reveal;
    timeline-trigger-source: scroll(nearest block);
    timeline-trigger-activation-range-start: 25%;
    timeline-trigger-activation-range-end: 75%;
    animation-trigger: --reveal play;
  }
  @keyframes reveal {
    from { transform: translateX(0); }
    to { transform: translateX(120px); }
  }
</style>
<div class="scroller">
  <div class="track"><div class="box"></div></div>
</div>

Resultado

With full feature support, scrolling downward from the top past 100px enters the activation range and starts a one-second movement from translateX(0) to translateX(120px).

Execute o exemplo localmente no navegador de destino. Desloque o conteúdo para baixo a partir do topo e verifique se a animação começa ao ultrapassar o limiar de `100px`.

Fontes