SnapEvent: snapTargetBlock 属性

可用性有限

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

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

SnapEvent 接口的只读属性 snapTargetBlock 返回一个引用,该引用指向事件触发时在块方向上吸附到的元素。

具体而言:

  • scrollsnapchanging 事件的情况下,这指的是一个待定的块方向吸附目标(即,它将在当前滚动姿势结束时被选中)。
  • scrollsnapchange 事件的情况下,这指的是一个新选中的块方向吸附目标。

SnapEvent 上可用的属性值直接对应于在滚动容器上设置的 scroll-snap-type CSS 属性的值。仅当吸附轴指定为 block(或在当前书写模式下等同于 block 的物理轴值)或 both 时,snapTargetBlock 才返回元素引用。

一个代表吸附元素的 Node,或者如果滚动吸附仅发生在内联方向,因此在块方向上没有吸附到任何元素,则返回 null

如果吸附的元素是伪元素,则返回的 Node 将是该伪元素的拥有元素。

示例

请参阅主 SnapEvent 页面以获取简短示例,并参阅我们的 使用滚动吸附事件 指南以获取完整示例和说明。

规范

规范
CSS 滚动捕捉模块级别 2
# dom-snapevent-snaptargetblock

浏览器兼容性

另见