SnapEvent: snapTargetBlock property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Thuộc tính chỉ đọc snapTargetBlock của giao diện SnapEvent trả về tham chiếu đến phần tử được snap trong hướng block khi sự kiện kích hoạt.

Cụ thể:

  • Đối với sự kiện scrollsnapchanging, thuộc tính này đề cập đến snap target đang chờ theo hướng block (tức là nó sẽ được chọn khi cử chỉ cuộn hiện tại kết thúc).
  • Đối với sự kiện scrollsnapchange, thuộc tính này đề cập đến snap target theo hướng block mới được chọn.

Các giá trị thuộc tính có trên SnapEvent tương ứng trực tiếp với giá trị của thuộc tính CSS scroll-snap-type được đặt trên scroll container. snapTargetBlock chỉ trả về tham chiếu phần tử nếu trục snap được chỉ định là block (hoặc giá trị trục vật lý tương đương block trong chế độ viết hiện tại) hoặc both.

Giá trị

Một Node đại diện cho phần tử đã snap, hoặc null nếu scroll snapping chỉ xảy ra theo hướng inline và không có phần tử nào được snap trong hướng block.

Nếu phần tử được snap là một pseudo-element, Node được trả về sẽ là phần tử chủ sở hữu của pseudo-element đó.

Ví dụ

Xem trang chính SnapEvent để biết các ví dụ ngắn, và hướng dẫn Sử dụng các sự kiện scroll snap để biết các ví dụ đầy đủ và giải thích.

Thông số kỹ thuật

Specification
CSS Scroll Snap Module Level 2
# dom-snapevent-snaptargetblock

Tương thích trình duyệt

Xem thêm