IntersectionObserverEntry: hàm tạo IntersectionObserverEntry()
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.
Hàm tạo IntersectionObserverEntry() tạo và trả về một đối tượng IntersectionObserverEntry mới.
Note:
Trong cách dùng thông thường, bạn không cần tự gọi hàm tạo này. Các đối tượng IntersectionObserverEntry được trình duyệt tạo tự động và chuyển đến callback IntersectionObserver khi có giao nhau, hoặc được trả về bởi IntersectionObserver.takeRecords().
Cú pháp
new IntersectionObserverEntry(intersectionObserverEntryInit)
Tham số
intersectionObserverEntryInit-
Một đối tượng có các thuộc tính sau, tất cả đều bắt buộc:
boundingClientRect-
Đối tượng chỉ định vị trí và kích thước của hình chữ nhật biên của phần tử đích, với các thuộc tính
x,y,width, vàheight. Đây là hình chữ nhật doElement.getBoundingClientRect()trả về. intersectionRatio-
Một số biểu thị tỷ lệ diện tích
intersectionRectso với diện tíchboundingClientRect. Nếu diện tíchboundingClientRectbằng 0, giá trị này là 1 khiisIntersectinglàtrue, và 0 nếu không. intersectionRect-
Đối tượng chỉ định vị trí và kích thước vùng hiển thị của target trong hình chữ nhật giao nhau của root, với các thuộc tính
x,y,width, vàheight. isIntersecting-
Giá trị boolean là
truenếu phần tử đích giao nhau với root của intersection observer, hoặcfalsenếu không. isVisible-
Giá trị boolean là
truenếu phần tử đích được xác định là hiển thị đầy đủ và không bị che khuất, không có hiệu ứng hình ảnh nào làm thay đổi cách nó hiển thị trên màn hình.falsenghĩa là target có khả năng hiển thị bị ảnh hưởng, hoặc không thể xác định điều đó. rootBounds-
Đối tượng chỉ định vị trí và kích thước của hình chữ nhật giao nhau của root, với các thuộc tính
x,y,width, vàheight, hoặcnull. target-
Elementmà phần giao nhau với root đã thay đổi. time-
Một
DOMHighResTimeStampcho biết thời điểm thay đổi giao nhau được ghi nhận, tính tương đối với time origin củaIntersectionObserver.
Giá trị trả về
Một đối tượng IntersectionObserverEntry mới với các thuộc tính được khởi tạo theo giá trị trong intersectionObserverEntryInit.
Ví dụ
>Tạo IntersectionObserverEntry
Ví dụ này tạo một IntersectionObserverEntry cơ bản mô tả một phần tử hiển thị hoàn toàn. Trong thực tế, các đối tượng này do trình duyệt tạo và chuyển vào callback IntersectionObserver tự động.
const entry = new IntersectionObserverEntry({
time: performance.now(),
rootBounds: { x: 0, y: 0, width: 1024, height: 768 },
boundingClientRect: { x: 10, y: 20, width: 200, height: 100 },
intersectionRect: { x: 10, y: 20, width: 200, height: 100 },
isIntersecting: true,
isVisible: false,
intersectionRatio: 1.0,
target: document.body,
});
Thông số kỹ thuật
| Specification |
|---|
| Intersection Observer> # dom-intersectionobserverentry-intersectionobserverentry> |