CKTIS / JavaScript
HTMLElement.offsetWidth — largeur de mise en page d’un élément
HTMLElement.offsetWidth renvoie la largeur entière d’un élément en pixels CSS. Elle inclut le remplissage et les bordures, mais exclut les marges. Les transformations CSS sont ignorées.
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
element.offsetWidthHTMLElement.offsetWidth est une propriété en lecture seule de CSSOM View, et non une fonction ECMAScript. Elle renvoie un entier en pixels CSS. Pour une boîte ordinaire unique, elle inclut le contenu, le remplissage, les bordures et l’espace occupé par une barre de défilement verticale, mais exclut les marges.
Plus précisément, elle mesure la largeur du rectangle aligné sur les axes qui englobe tous les fragments générés par la boîte principale de l’élément, bordures comprises. Si un descendant de niveau bloc scinde la boîte principale en ligne de l’élément, la mesure inclut aussi les fragments générés par ce descendant dont la largeur et la hauteur sont toutes deux non nulles. Elle ignore les transformations appliquées à l’élément et à ses ancêtres. L’absence de boîte, par exemple avec display: none, donne 0.
Dans l’exemple, box-sizing: content-box signifie que le résultat est 100 + 2 * 10 + 2 * 2 = 124. Ni margin: 30px ni transform: scale(2) ne le modifie. Le code nécessite un document de navigateur ; une version de Node.js à elle seule ne permet pas d’établir la prise en charge de cette API.
Exemples
const box = document.createElement('div');
box.style.cssText = 'all: initial; display: block; position: fixed; box-sizing: content-box; width: 100px; height: 20px; padding: 10px; border: 2px solid; margin: 30px; overflow: hidden; transform: scale(2);';
document.body.append(box);
console.log(box.offsetWidth);
box.style.display = 'none';
console.log(box.offsetWidth);
box.remove();Résultat
124 0
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.