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

CKTIS / JavaScript

ResizeObserverEntry : élément observé et rectangle de contenu

Utilisez `target` pour identifier l’élément concerné et `contentRect` pour lire les dimensions signalées, hors marge intérieure et bordure pour un élément HTML.

Version : Current web platform; runtime support varies

Syntaxe

entry.target
entry.contentRect
entry.contentRect.width
entry.contentRect.height

Lors du rendu, le navigateur transmet un tableau d’entrées ResizeObserverEntry à la fonction de rappel de ResizeObserver. La propriété entry.target, en lecture seule, référence l’élément réellement observé, pas une copie. Si vous observez plusieurs éléments, comparez target à une référence connue avec ===.

entry.contentRect est un objet DOMRectReadOnly qui contient la mesure prise pour la notification et ne se met pas à jour en continu. Pour un élément HTML, width et height donnent la largeur et la hauteur physiques de la boîte de contenu en pixels CSS, sans marge intérieure ni bordure. Pour un élément graphique SVG sans boîte de mise en page CSS, la mesure décrit son rectangle englobant. Ne le confondez pas avec getBoundingClientRect() qui, pour HTML, renvoie un rectangle englobant les boîtes de bordure par rapport à la zone d’affichage.

contentRect est conservé pour la rétrocompatibilité. Pour obtenir des dimensions logiques, utilisez contentBoxSize si l’environnement le prend en charge : inlineSize et blockSize suivent le mode d’écriture. L’option box de observe() choisit la boîte dont les changements déclenchent les notifications ; border-box ne fait pas de contentRect une mesure de la boîte de bordure. ECMAScript 2024 indique uniquement la version de référence du langage JavaScript. Ces deux propriétés sont définies par la spécification Resize Observer, et non par ECMAScript ; leur disponibilité dépend de l’environnement d’exécution.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ResizeObserverEntry example</title>
</head>
<body>
<script>
(() => {
  const box = document.createElement('div');
  Object.assign(box.style, {
    boxSizing: 'content-box',
    width: '120px',
    height: '60px',
    padding: '10px',
    border: '2px solid black'
  });
  document.body.append(box);

  const observer = new ResizeObserver(([entry]) => {
    const { width, height } = entry.contentRect;
    console.log(`${entry.target === box}: ${width} × ${height} CSS px`);
    observer.disconnect();
    box.remove();
  });
  observer.observe(box);
})();
</script>
</body>
</html>

Résultat

true: 120 × 60 CSS px

Enregistrez l’exemple dans un fichier `.html` et ouvrez-le dans un navigateur qui prend en charge `ResizeObserver`. Ouvrez la console de développement et rechargez la page. La première notification affiche `true: 120 × 60 CSS px` : `true` confirme l’identité de l’élément, et les dimensions excluent la marge intérieure et la bordure. Le code arrête ensuite l’observation et retire l’élément.

Leçons associées

  • JavaScript · Leçon 32 · Intermédiaire · Version : 3

Sources