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

CKTIS / JavaScript

ResizeObserverEntry — l’élément observé et sa taille

ResizeObserverEntry décrit un élément dans une notification ResizeObserver. Sa propriété target désigne l’élément, tandis que contentRect en fournit les dimensions. Découvrez la différence entre la boîte de contenu d’un élément HTML et la boîte englobante d’un SVG.

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

new ResizeObserver((entries) => {
  for (const entry of entries) {
    const element = entry.target;
    const { width, height } = entry.contentRect;
  }
}).observe(element);

ResizeObserverEntry est un enregistrement fourni dans le tableau entries au rappel d’un ResizeObserver. Un appel peut fournir des enregistrements pour plusieurs éléments observés ; parcourez donc le tableau au lieu de supposer qu’il ne contient qu’un seul résultat.

ResizeObserverEntry.target est une propriété en lecture seule qui référence l’Element ou le SVGElement observé. Elle permet d’associer une mesure au bon élément. La référence elle-même est en lecture seule, mais l’élément référencé peut toujours être modifié.

ResizeObserverEntry.contentRect est une propriété en lecture seule qui renvoie un DOMRectReadOnly. Pour un élément HTML, elle décrit la boîte de contenu, sans marges intérieures ni bordures. Pour un élément graphique SVG auquel aucune boîte de mise en page CSS n’est associée, elle décrit sa boîte englobante. Pour un élément <svg> externe doté d’une boîte de mise en page CSS, elle peut décrire à la place sa boîte de contenu CSS. width et height sont des dimensions, et non la taille extérieure de l’élément HTML. Cette propriété historique est conservée pour des raisons de compatibilité ; les propriétés plus récentes, comme contentBoxSize et borderBoxSize, ont des exigences de prise en charge distinctes.

Il s’agit d’une interface d’API Web, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. MDN indique que la prise en charge de base est largement disponible depuis juillet 2020 ; la disponibilité des propriétés supplémentaires peut varier. Node 24 ne prouve pas la prise en charge par les navigateurs. Les notifications sont asynchrones. Évitez les changements de taille dans le rappel qui déclenchent sans fin d’autres notifications.

Exemples

(() => {
  if (typeof ResizeObserver === "undefined") {
    throw new Error("ResizeObserver is not supported");
  }

  const box = document.createElement("div");
  box.id = "resize-demo";
  box.style.cssText = "display: block; box-sizing: content-box; width: 120px; height: 60px; padding: 10px; border: 2px solid black;";
  document.body.append(box);

  const observer = new ResizeObserver((entries) => {
    for (const entry of entries) {
      const { width, height } = entry.contentRect;
      console.log(`${entry.target.id}: ${width} x ${height}`);
    }
    observer.disconnect();
    box.remove();
  });

  observer.observe(box);
})();

Résultat

resize-demo: 120 x 60

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