KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

IntersectionObserverEntry: overlapstatus en geobserveerd element

`isIntersecting` geeft aan of het element op het meetmoment het referentiegebied raakt of overlapt. `target` geeft aan welk geobserveerd element de melding beschrijft.

Versie: Current web platform; runtime support varies

Syntax

entry.isIntersecting // boolean
entry.target         // Element

Tot de alleen-lezen instantie-eigenschappen van IntersectionObserverEntry behoren entry.isIntersecting en entry.target. entry.isIntersecting is een booleaanse waarde (true bij intersectie met het referentiegebied, anders false). entry.target is hetzelfde DOM-Element dat je aan observe() hebt doorgegeven, niet de root of een selector. Het referentiegebied kan bijvoorbeeld dat van een scrollcontainer zijn. Als root de standaardwaarde null heeft, is het referentiegebied de viewport van het bovenliggende document op het hoogste niveau. Bij een element in een iframe wordt intersectionRect ook begrensd door de viewport van het frame.

Een melding legt een meting vast en wordt niet live bijgewerkt. Na observe() komt de eerste melding asynchroon binnen, ook als het element niet is verplaatst. Latere meldingen kunnen aangeven dat de overlapstatus is veranderd of dat de overlapverhouding een ingestelde drempel passeert. true op zichzelf betekent dus niet dat het element net is binnengekomen. Verwerk de hele array entries: één callbackaanroep kan meerdere meldingen opleveren.

Contact langs een rand kan als intersectie tellen, ook als intersectionRatio gelijk is aan 0. Wil je weten of de geometrische overlap een positieve oppervlakte heeft, controleer dan zowel entry.intersectionRect.width > 0 als entry.intersectionRect.height > 0. Dat bewijst niet dat de gebruiker het element kan zien: een ander element kan het bedekken.

Deze API hoort bij het webplatform, niet bij ECMAScript 2024. Controleer of de doelomgeving IntersectionObserver biedt. Gebruik unobserve(element) om één element niet meer te volgen of disconnect() om alle observaties van die observer te stoppen.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>IntersectionObserverEntry example</title>
</head>
<body>
<script>
(() => {
  const root = document.createElement('div');
  root.style.cssText = 'position:fixed;top:0;left:0;width:120px;height:60px;overflow:hidden';

  const makeTarget = (left) => {
    const element = document.createElement('div');
    element.style.cssText = `position:absolute;top:8px;left:${left}px;width:16px;height:16px`;
    root.append(element);
    return element;
  };

  const inside = makeTarget(8);
  const outside = makeTarget(150);
  document.body.append(root);

  const states = new Map();
  const observer = new IntersectionObserver((entries, currentObserver) => {
    for (const entry of entries) {
      states.set(entry.target, entry.isIntersecting);
    }
    if (!states.has(inside) || !states.has(outside)) return;

    currentObserver.disconnect();
    root.remove();
    console.log(`inside: ${states.get(inside)}\noutside: ${states.get(outside)}`);
  }, { root });

  observer.observe(inside);
  observer.observe(outside);
})();
</script>
</body>
</html>

Resultaat

inside: true
outside: false

Sla de code op als HTML-bestand, open het bestand in een browser en bekijk de uitvoer in de ontwikkelaarsconsole. Het eerste element staat binnen de referentiecontainer en het tweede staat er helemaal buiten. De code wacht op beide eerste meldingen, toont de statussen in een vaste volgorde en ruimt daarna op.

Gerelateerde lessen

  • JavaScript · Les 30 · Gemiddeld · Versie: 3

Bronnen