Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLElement : propriété offsetHeight

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

La propriété en lecture seule offsetHeight de l'interface HTMLElement retourne la hauteur d'un élément, y compris le remplissage vertical (padding) et les bordures, sous forme d'entier.

En général, offsetHeight est une mesure en pixels de la hauteur CSS de l'élément, incluant les bordures, le remplissage et les barres de défilement horizontales (si elles sont affichées). Elle n'inclut pas la hauteur des pseudo-éléments comme ::before ou ::after. Pour l'objet body du document, la mesure inclut la hauteur totale du contenu linéaire au lieu de la hauteur CSS de l'élément. Les éléments flottants qui dépassent sous d'autres contenus linéaires sont ignorés.

Si l'élément est caché (par exemple, en définissant style.display sur l'élément ou l'un de ses ancêtres à "none"), alors la valeur retournée est 0.

Valeur

Un entier.

Exemples

Un élément exemple avec un grand remplissage, une bordure et une marge. offsetHeight est la hauteur de mise en page de l'élément, incluant son remplissage et sa bordure, mais excluant sa marge.

L'image ci-dessus montre une barre de défilement et un offsetHeight qui s'adapte à la fenêtre. Cependant, les éléments non défilants peuvent avoir des valeurs offsetHeight importantes, bien supérieures au contenu visible. Ces éléments sont généralement contenus dans des éléments défilants ; par conséquent, ils peuvent être totalement ou partiellement invisibles, selon la valeur de scrollTop du conteneur défilant.

Spécifications

Specification
CSSOM View Module
# dom-htmlelement-offsetheight

Compatibilité des navigateurs

Voir aussi