animation-range-start
animation-range-start
CSS 属性用于设置动画在其时间轴上的附件范围的开始位置,即动画将从时间轴上的哪个位置开始。
animation-range-start
和 animation-range-end
属性也可以使用 animation-range
简写属性设置。
注意: animation-range-start
包含在 animation
简写中,作为重置值。这意味着包含 animation
将先前声明的 animation-range-start
值重置为 normal
,但不能通过 animation
设置特定值。在创建 CSS 滚动驱动动画 时,需要在声明任何 animation
简写后声明 animation-range-start
,才能使其生效。
语法
/* Keyword or length percentage value */
animation-range-start: normal;
animation-range-start: 20%;
animation-range-start: 100px;
/* Named timeline range value */
animation-range-start: cover;
animation-range-start: contain;
animation-range-start: cover 20%;
animation-range-start: contain 100px;
值
animation-range-start
允许的值为 normal
、<length-percentage>
、<timeline-range-name>
或 <timeline-range-name>
后跟 <length-percentage>
。有关可用值的详细说明,请参见 animation-range
。
还可以查看 视图时间轴范围可视化器,它以简单直观的视觉格式显示了不同值的含义。
正式定义
正式语法
animation-range-start =
[ normal | <length-percentage> | <timeline-range-name> <length-percentage>? ]#
<length-percentage> =
<length> |
<percentage>
示例
使用范围开始创建命名视图进度时间轴
一个名为 --subjectReveal
的视图进度时间轴使用 view-timeline
属性在具有 class
为 animation
的主题元素上定义。然后使用 animation-timeline: --subjectReveal;
将其设置为同一元素的时间轴。结果是主题元素在滚动时向上移动通过文档时进行动画处理。
还设置了 animation-range-start
声明,以使动画比预期晚开始。
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
元素的样式非常简单,文本内容有一些基本字体设置
.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-start
声明,让动画比预期晚开始。
最后,在元素上指定了一个动画,该动画会动画它的不透明度和缩放比例,使其在向上滚动时淡入并放大。
.animation {
view-timeline: --subjectReveal block;
animation-timeline: --subjectReveal;
animation-name: appear;
animation-range-start: entry 25%;
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-start |
浏览器兼容性
BCD 表格仅在浏览器中加载
另请参阅
animation-timeline
animation-range
,animation-range-end
scroll-timeline
,scroll-timeline-axis
,scroll-timeline-name
timeline-scope
view-timeline-inset
- JavaScript 等效项:
rangeStart
属性在Element.animate()
中可用,调用 - CSS 滚动驱动动画