CKTIS / JavaScript
ResizeObserver — observer la taille d’un élément
ResizeObserver signale la taille des éléments même lorsque la fenêtre ne change pas de taille. Il permet à un composant de s’adapter à l’espace disponible sans interroger le DOM à répétition.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const observer = new ResizeObserver((entries, observer) => { /* handle sizes */ });
observer.observe(element, { box: "content-box" });
observer.unobserve(element);
observer.disconnect();ResizeObserver est une API du navigateur, et non une fonctionnalité ECMAScript ; Node 24 ne permet pas d’établir sa disponibilité. L’événement resize est déclenché sur Window lorsque la fenêtre change de taille, tandis que ResizeObserver signale les changements de taille d’un élément observé. Les notifications sont asynchrones et regroupées pendant le rendu.
observe() surveille content-box par défaut. border-box inclut le remplissage et les bordures, tandis que device-pixel-content-box mesure le contenu en pixels d’appareil entiers. L’option box sélectionne le déclencheur, et ne filtre pas les champs du résultat.
Le callback reçoit entries et l’observateur. Une entrée contient target, contentRect et des tableaux de tailles tels que contentBoxSize ; leurs inlineSize et blockSize dépendent du mode d’écriture. contentRect.width et contentRect.height décrivent les dimensions physiques du contenu.
Évitez les changements de taille dans le callback qui créent des boucles de rétroaction : le navigateur peut signaler une erreur de boucle d’observation de redimensionnement. Les transformations CSS seules ne déclenchent pas de notifications. unobserve(element) arrête une observation ; disconnect() les arrête toutes. Vérifiez la disponibilité de l’API et des options nécessaires dans les navigateurs ciblés.
Exemples
(() => {
if (typeof ResizeObserver !== "function") {
throw new Error("ResizeObserver unavailable");
}
const box = document.createElement("div");
box.style.cssText = "all: initial; display: block; position: fixed; width: 120px; height: 40px; padding: 0; border: 0; box-sizing: content-box; writing-mode: horizontal-tb;";
document.body.append(box);
const observer = new ResizeObserver(([entry]) => {
console.log(`${entry.contentRect.width} x ${entry.contentRect.height}`);
observer.disconnect();
box.remove();
});
observer.observe(box, { box: "content-box" });
})();Résultat
120 x 40
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.