Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources