Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Voľby IntersectionObserver: root, rootMargin a threshold

`root` vyberá referenčnú oblasť, `rootMargin` upravuje jej hranice na účely výpočtu a `threshold` určuje, pri akých podieloch plochy cieľa pozorovateľ odošle oznámenie.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

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

IntersectionObserver je API prehliadača, nie súčasť ECMAScriptu. root vyberá referenčnú oblasť: ak voľbu vynecháš alebo zadáš null, použije sa zobrazovaná oblasť dokumentu najvyššej úrovne. Výslovne môžeš zadať Document alebo Element, napríklad posúvateľný kontajner. Ak je koreňom prvok, cieľ musí byť jeho potomkom v reťazci obsahujúcich blokov rozloženia.

rootMargin je reťazec jednej až štyroch hodnôt zadaných ako absolútne dĺžky CSS alebo percentá, ktoré sa rozdelia ako pri CSS margin: hore, vpravo, dole, vľavo. Podľa špecifikácie sa absolútne dĺžky, napríklad v cm, pri spracovaní reťazca prevádzajú na pixely. Kvôli kompatibilite medzi prehliadačmi používaj px alebo %, pretože niektoré prehliadače iné absolútne jednotky odmietajú. Predvolená hodnota každej strany je 0px. Percentá sa aj hore a dole počítajú zo šírky pôvodného obdĺžnika koreňa. Kladné hodnoty obdĺžnik použitý vo výpočte zväčšujú, záporné ho zmenšujú. Rozloženie sa nemení a orezanie medziľahlými predkami sa neruší. Pri cieľoch z iného pôvodu sa okraj ignoruje a entry.rootBounds je null.

threshold prijíma jedno číslo alebo pole čísel od 0 do 1 vrátane. Vynechanie voľby alebo zadanie prázdneho poľa nastaví prah na 0. Voľba konštruktora sa volá threshold; vlastnosť iba na čítanie observer.thresholds vracia číselne vzostupne zoradené pole. Prah mimo rozsahu vyvolá RangeError; neplatný rootMargin vyvolá DOMException s názvom SyntaxError.

Po observe(target) dostane funkcia spätného volania asynchrónne prvý záznam, aj keď k prieniku nedochádza. Ďalšie záznamy sa zaradia do frontu pri prekročení prahu v ktoromkoľvek smere alebo pri zmene entry.isIntersecting, nie pri každej zmene podielu. 0.5 znamená polovicu plochy ohraničujúceho obdĺžnika cieľa, nie koreňa. Dotyk hrán môže dať isIntersecting: true pri intersectionRatio: 0. Ak má obdĺžnik cieľa nulovú plochu, podiel je 1, ak je isIntersecting pravda, inak 0. Geometrický prienik nedokazuje, že používateľ cieľ vidí.

Voľby sú pevne dané pri vytvorení pozorovateľa. Ak ich chceš zmeniť, vytvor nového pozorovateľa. unobserve(target) ukončí sledovanie jedného cieľa, disconnect() sledovanie všetkých cieľov. Over, či prostredie, v ktorom kód pobeží, podporuje API.

Príklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>IntersectionObserver options</title>
</head>
<body>
<script>
{
  const root = document.createElement("div");
  const spacer = document.createElement("div");
  const target = document.createElement("div");
  root.style.cssText = "width: 120px; height: 100px; overflow: hidden";
  spacer.style.height = "120px";
  target.style.cssText = "height: 40px; background: teal";
  root.append(spacer, target);
  document.body.append(root);

  const observer = new IntersectionObserver(([entry], observer) => {
    console.log(`root matches: ${observer.root === root}`);
    console.log(`rootMargin: ${observer.rootMargin}`);
    console.log(`thresholds: ${JSON.stringify(observer.thresholds)}`);
    console.log(`isIntersecting: ${entry.isIntersecting}`);
    console.log(`intersectionRatio: ${entry.intersectionRatio}`);
    observer.disconnect();
    root.remove();
  }, {
    root,
    rootMargin: "0px 0px 40px",
    threshold: [1, 0, 0.5],
  });
  observer.observe(target);
}
</script>
</body>
</html>

Výsledok

root matches: true
rootMargin: 0px 0px 40px 0px
thresholds: [0,0.5,1]
isIntersecting: true
intersectionRatio: 0.5

Ulož príklad ako súbor HTML, otvor ho v aktívnej karte prehliadača a skontroluj výstup vo vývojárskej konzole. Cieľ začína 20 px pod dolným okrajom koreňa. Dolný okraj rozšírený o 40 px zahrnie polovicu výšky cieľa v celej jeho šírke. Prvý záznam preto uvádza `intersectionRatio: 0.5`. Kód pozorovateľa odpojí a odstráni ukážkové prvky.

Súvisiace lekcie

  • JavaScript · Lekcia 30 · Stredne pokročilá · Verzia: 3

Zdroje