view-timeline-inset

可用性有限

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

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

view-timeline-inset CSS 属性用于指定一个或两个值,表示对视口位置的调整(有关详细信息,请参阅 滚动容器),其中命名视图进度时间轴动画的主题元素被认为是可见的。换句话说,这允许您指定开始和/或结束内边距(或外边距)值,这些值会抵消时间轴的位置。

这可以与 animation-range 及其完整属性结合使用或代替 animation-range,这些属性可用于设置动画在其时间轴上的附加范围。有关详细信息,请参阅 CSS 滚动驱动动画

语法

css
/* Single value */
view-timeline-inset: auto;
view-timeline-inset: 200px;
view-timeline-inset: 20%;

/* Two values */
view-timeline-inset: 20% auto;
view-timeline-inset: auto 200px;
view-timeline-inset: 20% 200px;

view-timeline-inset 允许的值为

auto

如果设置,则使用视口该边缘的相应 scroll-padding(或等效的完整属性值)。如果未设置(或设置为 auto),则该值通常为 0,尽管某些用户代理可能会在适当情况下使用启发式方法来确定不同的默认值。

<length-percentage>

任何有效的 <length-percentage> 值都作为内边距/外边距值被接受。

  • 如果该值为正数,则动画的开始/结束位置将在视口中向内移动指定的长度或百分比。
  • 如果该值为负数,则动画的开始/结束位置将在视口中向外移动指定的长度或百分比,即它将在出现在视口中之前开始动画,或在离开视口后完成动画。

如果提供了两个值,则第一个值表示相关轴上的开始内边距/外边距(动画开始的位置),第二个值表示结束内边距/外边距(动画结束的位置)。如果只提供了一个值,则开始和结束内边距/外边距都设置为相同的值。

正式定义

初始值auto
应用于所有元素
继承
百分比相对于相关视口的相应尺寸
计算值一个列表,其中每个项目可以是“auto”或长度百分比
动画类型按计算值类型

正式语法

view-timeline-inset = 
[ [ auto | <length-percentage> ]{1,2} ]#

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

示例

创建带内边距的命名视图进度时间轴

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

还设置了 view-timeline-inset 声明,以使动画比预期晚开始,并提前结束。

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 属性被设置为定义一个命名视图进度时间轴的地方。我们还为它添加了 view-timeline-inset 声明,使动画比预期晚开始,并提前结束。它还被赋予了一个与之值相同的 animation-timeline 名称,以声明此元素将在视图进度时间轴推进时被动画化。

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

css
.animation {
  view-timeline: --subjectReveal block;
  view-timeline-inset: 70% -100px;
  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);
  }
}

结果

滚动查看正在动画化的 subject 元素。

规范

规范
滚动驱动的动画
# view-timeline-inset

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅