Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

IntersectionObserver: opazovanje presekov elementov

IntersectionObserver asinhrono sporoča geometrijski presek med elementom in referenčnim območjem. Spoznajte možnosti root, rootMargin in threshold ter razlikujte med presekom in dejansko vidnostjo.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

new IntersectionObserver(callback, { root: null, rootMargin: "0px", threshold: 0 })

IntersectionObserver je spletni API brskalnika, ne funkcija ECMAScripta. Razpoložljivost v Node 24 ne potrjuje podpore v brskalniku; preverite ciljno okolje.

root določa referenčno območje; privzeta vrednost null pomeni vidno polje. rootMargin razširi ali zoži njegove meje z 1–4 vrednostmi v slikovnih pikah ali odstotkih. Ti odmiki veljajo samo za ciljne elemente z isto izvorno domeno (same-origin-domain); pri ciljnih elementih z drugo izvorno domeno (cross-origin-domain) se ne upoštevajo. threshold sprejme število ali polje v obsegu [0, 1]; privzeta vrednost je 0. Lastnost thresholds, ki je samo za branje, razkrije urejena razmerja površine ciljnega elementa.

Po začetku opazovanja povratni klic običajno prejme začetni vnos za ciljni element, vendar dostava ni zagotovljena. Opazovanje se lahko konča, še preden vnos nastane, takeRecords() pa ga lahko odstrani iz čakalne vrste, preden ga prejme povratni klic. Nadaljnji vnosi se dodajo v čakalno vrsto ob prehodu čez prag ali spremembi isIntersecting. Geometrijski presek ne dokazuje dejanske vidnosti; stik robov lahko povzroči isIntersecting === true, čeprav je površina preseka enaka nič.

observe(target) začne opazovanje, unobserve(target) ga ustavi za en cilj, disconnect() pa za vse. Primer preveri začetni popolni presek in nato počisti uporabljene vire.

Primeri

(() => {
  if (!("IntersectionObserver" in window)) {
    throw new Error("IntersectionObserver unavailable");
  }
  const root = document.createElement("div");
  root.style.cssText = "position:fixed;top:0;left:0;width:100px;height:100px;overflow:hidden;padding:0;border:0;";
  const target = document.createElement("div");
  target.style.cssText = "width:20px;height:20px;margin:0;";
  root.append(target);
  document.body.append(root);

  const observer = new IntersectionObserver((entries) => {
    console.log(entries[0].intersectionRatio === 1);
    observer.disconnect();
    root.remove();
  }, { root, rootMargin: "0px", threshold: [0, 1] });

  observer.observe(target);
})();

Rezultat

true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri