view-timeline-name

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

view-timeline-name CSS 属性用于定义命名视图进度时间线的名称。该时间线根据可滚动元素(滚动器)内元素(称为主题)的可见性变化而推进。view-timeline 在主题上设置。

主题在滚动器内的可见性被跟踪——默认情况下,当主题首次在滚动器的一边可见时,时间线为0%,当它到达另一边时,时间线为100%。该名称随后在 animation-timeline 声明中被引用,以指示将随时间线推进而动画的元素。这可以是主题元素,但并非必须是——您可以在主题在滚动区域中移动时,为不同的元素设置动画。

注意:如果滚动器元素在其轴维度上未溢出其容器,或者溢出被隐藏或剪裁,则不会创建滚动进度时间线。

view-timeline-nameview-timeline-axisview-timeline-inset 属性也可以通过 view-timeline 简写属性进行设置。

语法

css
view-timeline-name: none;
view-timeline-name: --custom_name_for_timeline;

view-timeline-name 的允许值是:

none

时间线没有名称。

<dashed-ident>

任意自定义标识符,用于定义视图进度时间线的名称,该名称随后可以在 animation-timeline 属性中引用。

注意:<dashed-ident> 值必须以 -- 开头,这有助于避免与标准 CSS 关键字发生名称冲突。

正式定义

初始值none
应用于所有元素
继承性
计算值none 或标识符的有序列表
动画类型不可动画化

正式语法

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

示例

创建命名视图进度时间线

名为 --subject-reveal 的视图进度时间线使用 view-timeline-name 属性在一个带有 animation 类的主题元素上定义。然后,使用 animation-timeline: --subject-reveal; 将其设置为同一元素的时间线。结果是,当滚动文档时,主题元素会随着其向上移动而动画。

HTML

示例的 HTML 如下所示。

html
<div class="content">
  <h1>Content</h1>

  <p>
    Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod
    tempor incididunt ut labore et dolore magna aliqua. Risus quis varius quam
    quisque id. Et ligula ullamcorper malesuada proin libero nunc consequat
    interdum varius. Elit ullamcorper dignissim cras tincidunt lobortis feugiat
    vivamus at augue.
  </p>

  <p>
    Dolor sed viverra ipsum nunc aliquet. Sed sed risus pretium quam vulputate
    dignissim. Tortor aliquam nulla facilisi cras. A erat nam at lectus urna
    duis convallis convallis. Nibh ipsum consequat nisl vel pretium lectus.
    Sagittis aliquam malesuada bibendum arcu vitae elementum. Malesuada bibendum
    arcu vitae elementum curabitur vitae nunc sed velit.
  </p>

  <div class="subject animation"></div>

  <p>
    Adipiscing enim eu turpis egestas pretium aenean pharetra magna ac. Arcu
    cursus vitae congue mauris rhoncus aenean vel. Sit amet cursus sit amet
    dictum. Augue neque gravida in fermentum et. Gravida rutrum quisque non
    tellus orci ac auctor augue mauris. Risus quis varius quam quisque id diam
    vel quam elementum. Nibh praesent tristique magna sit amet purus gravida
    quis. Duis ultricies lacus sed turpis tincidunt id aliquet. In egestas erat
    imperdiet sed euismod nisi. Eget egestas purus viverra accumsan in nisl nisi
    scelerisque. Netus et malesuada fames ac.
  </p>
</div>

CSS

subject 元素及其包含的 content 元素仅应用了最少的样式,文本内容则设置了一些基本的字体样式。

css
.subject {
  width: 300px;
  height: 200px;
  margin: 0 auto;
  background-color: deeppink;
}

.content {
  width: 75%;
  max-width: 800px;
  margin: 0 auto;
}

p,
h1 {
  font-family: "Helvetica", "Arial", sans-serif;
}

h1 {
  font-size: 3rem;
}

p {
  font-size: 1.5rem;
  line-height: 1.5;
}

带有 subject 类的 <div> 也被赋予 animation 类——在这里设置 view-timeline-name 来定义一个命名视图进度时间线。它还被赋予一个具有相同值的 animation-timeline 名称,以声明这将是随着视图进度时间线推进而动画的元素。

最后,在元素上指定了一个动画,该动画使其不透明度和缩放发生变化,从而在它向上移动滚动条时淡入并变大。

css
.animation {
  view-timeline-name: --subject-reveal;
  animation-timeline: --subject-reveal;

  animation-name: appear;
  animation-fill-mode: both;
  animation-duration: 1ms; /* Firefox requires this to apply the animation */
}

@keyframes appear {
  from {
    opacity: 0;
    transform: scaleX(0);
  }

  to {
    opacity: 1;
    transform: scaleX(1);
  }
}

结果

滚动以查看主体元素的动画效果。

规范

规范
滚动驱动动画
# view-timeline-name

浏览器兼容性

另见