scroll-snap-coordinate

Experimental: 这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

摘要

scroll-snap-coordinate CSS属性结合元素的最近的祖先元素滚动容器的scroll-snap-destination 定义的轴,定义了元素中 x 和 y 坐标偏移的位置。

如果元素已经变型,snap 坐标也以相同的方式进行变型,为了使元素的 snap 点向元素一样被显示。

初始值none
适用元素all elements
是否是继承属性
Percentagesrefer to the element’s border box
计算值as specified, but with relative lengths converted into absolute lengths
Animation typea position

语法

/* 关键值 */
scroll-snap-coordinate: none;

/* <位置>值 */
scroll-snap-coordinate: 50px 50px;                   /* 单坐标 */
scroll-snap-coordinate: 100px 100px, 100px bottom;   /* 多坐标 */

/* 全局值 */
scroll-snap-coordinate: inherit;
scroll-snap-coordinate: initial;
scroll-snap-coordinate: unset;

赋值

none
定义元素不提供一个 snap 点。
<position>
定义从元素核模型边框边缘开始偏移的 snap 坐标。每一对值中,第一个值给定了 snap 坐标的 x 坐标,第二个值为它的 y 坐标。

正式语法

Error: could not find syntax for this item

示例

HTML 内容

<div id="container">
  <div>
    <p>At coordinate (0, 0)</p>
    <div class="scrollContainer coordinate0">
      <div>1</div>
      <div>2</div>
      <div>3</div>
    </div>
  </div>

  <div>
    <p>At coordinate (25, 0)</p>
    <div class="scrollContainer coordinate25">
      <div>1</div>
      <div>2</div>
      <div>3</div>
    </div>
  </div>

  <div>
    <p>At coordinate (50, 0)</p>
    <div class="scrollContainer coordinate50">
      <div>1</div>
      <div>2</div>
      <div>3</div>
    </div>
  </div>
</div>

CSS 内容

#container {
  display: flex;
}

#container > div:nth-child(-n+2) {
  margin-right: 20px;
}

.scrollContainer {
  width: 100px;
  overflow: auto;
  white-space: nowrap;
  scroll-snap-type: mandatory;
  font-size: 0;
}

.scrollContainer > div {
  width: 100px;
  height: 100px;
  display: inline-block;
  line-height: 100px;
  text-align: center;
  font-size: 50px;
}

.coordinate0 > div {
  scroll-snap-coordinate: 0 0;
}

.coordinate25 > div {
  scroll-snap-coordinate: 25px 0;
}

.coordinate50 > div {
  scroll-snap-coordinate: 50px 0;
}

.scrollContainer > div:nth-child(even) {
  background-color: #87ea87;
}

.scrollContainer > div:nth-child(odd) {
  background-color: #87ccea;
}

规范

规范名称 状态 评论
CSS Scroll Snap Module Level 1
scroll-snap-coordinate
Candidate Recommendation Initial definition

浏览器兼容性

BCD tables only load in the browser