Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

scroll-timeline — una línea de tiempo de progreso de desplazamiento con nombre

La propiedad abreviada scroll-timeline define una línea de tiempo con nombre en un contenedor de desplazamiento. Una animación que la utiliza avanza según la posición de desplazamiento, en lugar del tiempo transcurrido.

Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxis

scroll-timeline: [ <'scroll-timeline-name'> <'scroll-timeline-axis'>? ]#;

scroll-timeline combina scroll-timeline-name y scroll-timeline-axis. Los nombres empiezan por --; none no define ninguna línea de tiempo con nombre. Si se omite el eje, se usa block. Las comas separan varias definiciones. La propiedad no se hereda ni es animable.

block e inline dependen del modo de escritura; x e y indican los ejes físicos. Si no hay un rango de desplazamiento en el eje seleccionado, la línea de tiempo está inactiva. El progreso sigue la posición a lo largo de todo el rango de desplazamiento, no la visibilidad de un elemento.

La declaración por sí sola no inicia una animación. En el ejemplo, un descendiente selecciona --progress mediante animation-timeline. Coloca esa declaración después de animation, porque la propiedad abreviada restablece la selección de la línea de tiempo. Desplazarse hacia atrás invierte el efecto. Esta versión exacta del ejemplo superó una comprobación estructural en un navegador aislado. Eso no confirma que se haya medido la anchura de la barra en cada posición de desplazamiento indicada. Comprueba el comportamiento en el navegador de destino antes de implementarlo.

Ejemplos

<!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.

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes