view-timeline-name

有限可用性

此功能不是基线,因为它在一些最常用的浏览器中不起作用。

实验性: 这是一个 实验性技术
在生产环境中使用之前,请仔细查看 浏览器兼容性表

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

主题在滚动器中的可见性将被跟踪——默认情况下,当主题首次出现在滚动器的某一边缘时,时间轴处于 0%,当它到达滚动器的另一边缘时,时间轴处于 100%。然后在 animation-timeline 声明中引用该名称,以指示将在时间轴进行时进行动画的元素。该元素可以是主题元素,但并非必须——当主题在滚动区域中移动时,您可以对另一个元素进行动画处理。

注意:如果元素在轴尺寸上没有溢出其容器,或者溢出被隐藏或剪裁,则不会创建时间轴。

也可以使用 view-timeline 简写属性设置 view-timeline-axisview-timeline-name 属性。

语法

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> ]#

示例

创建命名视图进度时间轴

使用主题元素上的 view-timeline-name 属性定义一个名为 --subjectReveal 的视图进度时间轴,该主题元素的 classanimation。然后使用 animation-timeline: --subjectReveal; 将其设置为该元素的时间轴。结果是主题元素随着滚动向上移动而进行动画处理。

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: Arial, Helvetica, sans-serif;
}

h1 {
  font-size: 3rem;
}

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

<div> 元素的 classsubject,还设置了 animation class——这是 view-timeline-name 设置为定义命名视图进度时间轴的地方。它还使用相同的值设置了 animation-timeline 名称,以声明这将是在视图进度时间轴进行时进行动画处理的元素。

最后,在元素上指定一个动画,该动画将对元素的不透明度和比例进行动画处理,使其在向上移动时淡入并放大。

css
.animation {
  view-timeline-name: --subjectReveal;
  animation-timeline: --subjectReveal;

  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

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参见