CKTIS / JavaScript
Évènement `resize` de `Window`
Écoutez `resize` sur `window` pour réagir aux changements de taille de la zone d’affichage de mise en page. Pour suivre la taille d’un élément précis, utilisez `ResizeObserver`.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
window.addEventListener("resize", handler);
window.removeEventListener("resize", handler);
// Alternative: assign a single handler property.
window.onresize = handler;
window.onresize = null;Le navigateur déclenche resize sur window lorsque la zone d’affichage utilisée pour la mise en page (layout viewport) change de taille. Cette API fait partie de la plateforme web, pas d’ECMAScript. Le navigateur fournit un simple objet Event, sans les nouvelles dimensions. L’évènement ne remonte pas par propagation et ne peut pas être annulé avec preventDefault().
Lisez la largeur et la hauteur actuelles avec window.innerWidth et window.innerHeight. Les valeurs sont en pixels CSS et incluent respectivement la largeur de la barre de défilement verticale et la hauteur de la barre horizontale, si elles sont présentes. Si l’application a besoin des dimensions immédiatement, appelez la fonction de mise à jour à l’initialisation : l’enregistrement de l’écouteur ne l’appelle pas. Le redimensionnement peut déclencher l’évènement plusieurs fois ; évitez donc les traitements coûteux à chaque appel.
addEventListener("resize", handler) permet d’enregistrer plusieurs écouteurs distincts. Quand un écouteur ne sert plus, retirez-le avec removeEventListener() en passant le même type d’évènement, la même référence de fonction et la même valeur de capture. Une affectation à window.onresize remplace uniquement le gestionnaire de cette propriété, sans toucher aux écouteurs ajoutés avec addEventListener() ; affectez null pour retirer ce gestionnaire.
Utilisez ResizeObserver pour surveiller un élément : sa taille peut changer sans que celle de la zone d’affichage de mise en page change. Pour suivre la taille de la partie visible de la page, écoutez l’évènement distinct resize sur window.visualViewport si cette API est disponible.
Exemples
{
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"));
}Résultat
resize: bubbles=false, cancelable=false
Exécutez le code dans la console du navigateur ou avec Node.js 24. Dans le navigateur, le code utilise `window` ; dans Node.js, il utilise un objet `EventTarget` indépendant. Le premier évènement synthétique appelle l’écouteur de façon synchrone et affiche une ligne. Le second est déclenché après le retrait de l’écouteur : le code n’affiche rien de plus. Aucun des deux ne redimensionne la zone d’affichage.
Leçons associées
- JavaScript · Leçon 27 · Intermédiaire · Version : 3