animation-range-end

有限可用性

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

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

The animation-range-end CSS 属性用于设置动画在其时间线上的附加范围的结束位置,即动画将在时间线上结束的位置。

animation-range-endanimation-range-start 属性也可以使用 animation-range 简写属性设置。

注意: animation-range-end 被包含在 animation 简写中,作为一个仅重置的值。这意味着包含 animation 会将先前声明的 animation-range-end 值重置为 normal,但无法通过 animation 设置特定值。在创建 CSS 滚动驱动动画 时,你需要在声明任何 animation 简写之后声明 animation-range-end 才能使其生效。

语法

css
/* Keyword or length percentage value */
animation-range-end: normal;
animation-range-end: 80%;
animation-range-end: 700px;

/* Named timeline range value */
animation-range-end: cover;
animation-range-end: contain;
animation-range-end: cover 80%;
animation-range-end: contain 700px;

animation-range-end 允许的值为 normal<length-percentage><timeline-range-name> 或带 <length-percentage><timeline-range-name>。有关可用值的详细说明,请参阅 animation-range

还可以查看 视图时间线范围可视化工具,它以简单的可视化格式显示了不同值的含义。

正式定义

初始值normal
应用于所有元素
继承
百分比如果指定了,则相对于指定的命名时间线范围,否则相对于整个时间线
计算值一个列表,其中每个项目可能是 'normal'、长度百分比或时间线范围名称和长度百分比
动画类型不可动画

正式语法

animation-range-end = 
[ normal | <length-percentage> | <timeline-range-name> <length-percentage>? ]#

<length-percentage> =
<length> |
<percentage>

示例

创建具有范围结束的命名视图进度时间线

使用 view-timeline 属性在具有 classanimation 的主题元素上定义一个名为 --subjectReveal 的视图进度时间线。然后使用 animation-timeline: --subjectReveal; 将其设置为同一元素的时间线。结果是,主题元素在滚动时向上移动通过文档时会进行动画。

还设置了 animation-range-end 声明,以使动画比预期更早结束。

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;
}

具有 subject 类别的 <div> 也被赋予了一个 animation 类 - 这是 view-timeline 被设置为定义一个命名视图进度时间线的地方。它也被赋予了一个相同值的 animation-timeline 名称,以声明这将是随着视图进度时间线推进而进行动画的元素。我们还给它一个 animation-range-end 声明,以使动画比预期更早结束。

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

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

  animation-name: appear;
  animation-range-end: contain 50%;
  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);
  }
}

结果

滚动查看主题元素正在进行动画。

规范

规范
滚动驱动的动画
# animation-range-end

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅