SnapEvent: snapTargetBlock 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

SnapEvent 介面的只讀屬性 snapTargetBlock 返回一個引用,該引用指向事件觸發時在塊方向上吸附到的元素。

具體而言:

  • scrollsnapchanging 事件的情況下,這指的是一個待定的塊方向吸附目標(即,它將在當前滾動姿勢結束時被選中)。
  • scrollsnapchange 事件的情況下,這指的是一個新選中的塊方向吸附目標。

SnapEvent 上可用的屬性值直接對應於在滾動容器上設定的 scroll-snap-type CSS 屬性的值。僅當吸附軸指定為 block(或在當前書寫模式下等同於 block 的物理軸值)或 both 時,snapTargetBlock 才返回元素引用。

一個代表吸附元素的 Node,或者如果滾動吸附僅發生在內聯方向,因此在塊方向上沒有吸附到任何元素,則返回 null

如果吸附的元素是偽元素,則返回的 Node 將是該偽元素的擁有元素。

示例

請參閱主 SnapEvent 頁面以獲取簡短示例,並參閱我們的 使用滾動吸附事件 指南以獲取完整示例和說明。

規範

規範
CSS 滾動捕捉模組級別 2
# dom-snapevent-snaptargetblock

瀏覽器相容性

另見