CKTIS / JavaScript
De `resize`-gebeurtenis van `Window`
Luister op `window` naar `resize` om te reageren op veranderingen in de afmetingen van de layoutviewport. Volg de afmetingen van een afzonderlijk element met `ResizeObserver`.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
window.addEventListener("resize", handler);
window.removeEventListener("resize", handler);
// Alternative: assign a single handler property.
window.onresize = handler;
window.onresize = null;De browser activeert resize op window wanneer de afmetingen van de layoutviewport veranderen. Dat is het gebied waarop de browser de pagina-indeling baseert. Dit is een webplatform-API, geen onderdeel van ECMAScript. De browser geeft een gewoon Event zonder de nieuwe afmetingen door. De gebeurtenis bubbelt niet en is niet te annuleren met preventDefault().
Lees de huidige breedte en hoogte uit window.innerWidth en window.innerHeight. De waarden zijn in CSS-pixels en omvatten respectievelijk de breedte van de verticale en de hoogte van de horizontale schuifbalk, als die aanwezig zijn. Heeft je app de afmetingen meteen nodig, roep de updatefunctie dan aan tijdens de initialisatie: de listener registreren roept de functie niet aan. Tijdens het wijzigen van de afmetingen kan de gebeurtenis meerdere keren optreden, dus vermijd kostbaar werk bij elke aanroep.
Met addEventListener("resize", handler) kun je meerdere verschillende listeners registreren. Verwijder een listener die je niet meer nodig hebt met removeEventListener() en gebruik daarbij hetzelfde gebeurtenistype, dezelfde functiereferentie en dezelfde capture-waarde. Toewijzen aan window.onresize vervangt alleen de handler die via die eigenschap is ingesteld, niet de listeners die je met addEventListener() hebt toegevoegd. Met null verwijder je de handler van de eigenschap.
Gebruik ResizeObserver om een afzonderlijk element te volgen: het kan van afmetingen veranderen zonder dat de layoutviewport verandert. Wil je de afmetingen van het zichtbare deel van de pagina volgen, luister dan naar de afzonderlijke resize-gebeurtenis op window.visualViewport als die API beschikbaar is.
Voorbeelden
{
const target = typeof window === "undefined" ? new EventTarget() : window;
function reportResize(event) {
console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
}
target.addEventListener("resize", reportResize);
target.dispatchEvent(new Event("resize"));
target.removeEventListener("resize", reportResize);
target.dispatchEvent(new Event("resize"));
}Resultaat
resize: bubbles=false, cancelable=false
Voer de code uit in de browserconsole of met Node.js 24. In de browser gebruikt de code `window`; in Node.js gebruikt de code een afzonderlijk `EventTarget`-object. De eerste synthetische gebeurtenis roept de listener synchroon aan en schrijft één regel naar de console. De tweede wordt na verwijdering van de listener verstuurd, dus de code schrijft niets meer. Geen van beide verandert de afmetingen van de viewport.
Gerelateerde lessen
- JavaScript · Les 27 · Gemiddeld · Versie: 3