view-timeline-inset

可用性有限

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

view-timeline-inset CSS 属性用于指定一个或两个值,表示对滚动视口位置的调整(更多详情请参见滚动容器),在此滚动视口中,命名视图进度时间线动画的主体元素被视为可见。换句话说,这允许您指定起始和/或结束内边距(或外边距)值,以抵消时间线的位置。

此属性可以与 animation-range 及其长手属性结合使用,或替代它们使用,这些属性可用于设置动画沿其时间线的附着范围。更多详情请参见 CSS 滚动驱动动画

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

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

语法

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>

示例

使用内嵌创建命名视图进度时间线

在类名为 animation 的主体元素上,使用 view-timeline 属性定义了一个名为 --subject-reveal 的视图进度时间轴。然后使用 animation-timeline: --subject-reveal; 将其设置为同一元素的时间轴。结果是,当文档被滚动时,主体元素在向上移动的过程中会播放动画。

还设置了 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: "Helvetica", "Arial", 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: --subject-reveal block;
  view-timeline-inset: 70% -100px;
  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-inset

浏览器兼容性

另见