scroll-timeline-name

Допустимые значения для scroll-timeline-name:

none

Временной отрезок не имеет имени.

<dashed-ident>

Произвольный пользовательский идентификатор, определяющий имя для временного отрезка прокрутки, которое затем можно использовать в свойстве animation-timeline.

Примечание: Значения <dashed-ident> должны начинаться с --, что помогает избежать конфликтов имён со стандартными ключевыми словами CSS.

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

В этом примере временной отрезок прокрутки с именем --squareTimeline определяется с помощью свойства scroll-timeline-name на элементе с ID container. Затем это применяется к анимации на элементе #square с помощью animation-timeline: --squareTimeline.

HTML

HTML для примера показан ниже.

<div id="container">
  <div id="square"></div>
  <div id="stretcher"></div>
</div>

CSS

CSS для контейнера задаёт его как источник временного отрезка прокрутки с именем --squareTimeline с помощью свойства scroll-timeline-name. Ось скролла (ось скролла) здесь не определена, поскольку используется вертикальная ось по умолчанию.

Высота контейнера установлена в 300px, и контейнер также настроен на создание вертикальной полосы прокрутки, если он выходит за пределы контейнера (правило CSS height на элементе stretcher ниже приводит к тому, что содержимое выходит за пределы контейнера).

#container {
  height: 300px;
  overflow-y: scroll;
  scroll-timeline-name: --squareTimeline;
  position: relative;
}

CSS ниже определяет квадрат, который вращается в соответствии со временным отрезком, предоставленным свойством animation-timeline, которое установлено на временной отрезок --squareTimeline с именем выше.

#square {
  background-color: deeppink;
  width: 100px;
  height: 100px;
  margin-top: 100px;
  animation-name: rotateAnimation;
  animation-duration: 1ms; /* Firefox requires this to apply the animation */
  animation-timeline: --squareTimeline;
  position: absolute;
  bottom: 0;
}

#stretcher {
  height: 600px;
  background: #dedede;
}

@keyframes rotateAnimation {
  from {
    transform: rotate(0deg);
  }

  to {
    transform: rotate(360deg);
  }
}

Правило CSS stretcher задаёт высоту блока в 600px, что создаёт содержимое, выходящее за пределы контейнера, тем самым создавая полосы прокрутки. Без этого элемента содержимое не выходило бы за пределы контейнера, не было бы полосы прокрутки, а значит, и временного отрезка прокрутки для связи с временным отрезком анимации.

Результат

Прокрутите вертикальную полосу, чтобы увидеть, как квадрат анимируется при прокрутке.

• animation-timeline
• scroll-timeline, scroll-timeline-axis
• timeline-scope
• CSS-анимации, управляемые прокруткой