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.
rootMarginje reťazec jednej až štyroch hodnôt zadaných ako absolútne dĺžky CSS alebo percentá, ktoré sa rozdelia ako pri CSSmargin: hore, vpravo, dole, vľavo. Podľa špecifikácie sa absolútne dĺžky, napríklad vcm, pri spracovaní reťazca prevádzajú na pixely. Kvôli kompatibilite medzi prehliadačmi používajpxalebo%, pretože niektoré prehliadače iné absolútne jednotky odmietajú. Predvolená hodnota každej strany je0px. 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 aentry.rootBoundsjenull.
thresholdprijíma jedno číslo alebo pole čísel od0do1vrátane. Vynechanie voľby alebo zadanie prázdneho poľa nastaví prah na0. Voľba konštruktora sa voláthreshold; vlastnosť iba na čítanieobserver.thresholdsvracia číselne vzostupne zoradené pole. Prah mimo rozsahu vyvoláRangeError; neplatnýrootMarginvyvoláDOMExceptions názvomSyntaxError.
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 zmeneentry.isIntersecting, nie pri každej zmene podielu.0.5znamená polovicu plochy ohraničujúceho obdĺžnika cieľa, nie koreňa. Dotyk hrán môže daťisIntersecting: truepriintersectionRatio: 0. Ak má obdĺžnik cieľa nulovú plochu, podiel je1, ak jeisIntersectingpravda, inak0. 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
- IntersectionObserver: IntersectionObserver() constructor
- Intersection Observer API
- IntersectionObserver: rootMargin property
- Intersection Observer specification — Parse a margin
- IntersectionObserver: thresholds property
- IntersectionObserver: observe() method
- IntersectionObserverEntry: intersectionRatio property
- IntersectionObserverEntry: isIntersecting property
- IntersectionObserver: disconnect() method
- HTML Standard — Update the rendering