CKTIS / JavaScript
IntersectionObserver.observe — een element observeren
De methode observe(target) registreert een element om asynchroon bij te houden wanneer het een kruising met root heeft, volgens de configuratie van de observer.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
observer.observe(target)observer.observe(target) accepteert een Element en geeft undefined terug. Hetzelfde element opnieuw registreren verandert niets. Eén observer kan meerdere elementen volgen. Stel root, rootMargin en threshold in de constructor in, niet in observe().
Wanneer de browser het geregistreerde element voor het eerst controleert, zet hij een eerste entry in de wachtrij, ook als er geen kruising is. Entries uit de wachtrij worden asynchroon aan de callback doorgegeven, maar die krijgt de eerste entry niet altijd: unobserve(target) kan de observatie stoppen voordat de entry wordt aangemaakt, en takeRecords() kan de entry uit de wachtrij halen voordat deze wordt doorgegeven. Als de intersectieverhouding een drempel passeert of isIntersecting verandert, kan er een volgende entry in de wachtrij komen. De callback ontvangt een array met entries. Een geometrische kruising bewijst niet dat pixels daadwerkelijk zichtbaar zijn.
unobserve(target) stopt het volgen van één element; disconnect() stopt het volgen van alle elementen. Dit is een Web API van de browser, geen functie van een bepaalde ECMAScript-editie. Controleer de beschikbaarheid in de doelomgeving. Node 24 alleen toont niet aan dat de API wordt ondersteund.
Voorbeelden
(() => {
if (!("IntersectionObserver" in window)) {
throw new Error("IntersectionObserver is unavailable");
}
const target = document.createElement("div");
target.style.display = "none";
document.body.append(target);
const observer = new IntersectionObserver((entries) => {
console.log("initial:", entries[0].isIntersecting);
observer.disconnect();
target.remove();
});
observer.observe(target);
observer.observe(target);
console.log("started");
})();Resultaat
started initial: false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.