CKTIS / JavaScript
ResizeObserver.observe — observer la taille d’un élément
ResizeObserver.observe enregistre un élément pour recevoir des notifications de taille asynchrones. L’option box sélectionne la zone observée.
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
observer.observe(target, { box: "content-box" });observer.observe(target, options) accepte un Element et renvoie undefined. Les notifications parviennent au callback de l’observateur pendant le rendu, et non de manière synchrone.
box vaut par défaut "content-box" (contenu) ; "border-box" inclut aussi le padding et les bordures, tandis que "device-pixel-content-box" mesure le contenu en pixels d’appareil entiers. Ce choix détermine le déclenchement des notifications, pas les champs disponibles dans l’entrée. Les transformations CSS ne déclenchent pas d’observations.
Dans Chromium, rappeler observe pour le même élément avec la même valeur de box n’a aucun effet. Ne supposez pas qu’un tel appel remplacera l’enregistrement ou réinitialisera son état de notification dans tous les navigateurs. unobserve(target) en supprime un, tandis que disconnect() les supprime tous. Évitez les changements de taille cycliques dans le callback. Il s’agit d’une API Web, et non d’une fonctionnalité ECMAScript ; Node 24 ne permet pas d’établir la prise en charge par les navigateurs.
Exemples
const target = document.createElement("div");
target.style.cssText = "all: initial; display: block; width: 120px; height: 40px;";
document.body.append(target);
const observer = new ResizeObserver(([entry]) => {
console.log(`${entry.contentRect.width} x ${entry.contentRect.height}`);
observer.disconnect();
target.remove();
});
observer.observe(target, { 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.