CKTIS / JavaScript
HTMLElement.offsetWidth — ancho de diseño de un elemento
HTMLElement.offsetWidth devuelve el ancho entero de un elemento en píxeles CSS. Incluye el relleno y los bordes, pero excluye los márgenes. Ignora las transformaciones CSS.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
element.offsetWidthHTMLElement.offsetWidth es una propiedad de solo lectura de CSSOM View, no una función de ECMAScript. Devuelve un número entero en píxeles CSS. Para una caja única corriente, incluye el contenido, el relleno, los bordes y el espacio ocupado por una barra de desplazamiento vertical, pero excluye los márgenes.
Más concretamente, mide el ancho del rectángulo alineado con los ejes que engloba todos los fragmentos generados por la caja principal del elemento, incluidos sus bordes. Si un descendiente de nivel de bloque divide la caja principal en línea del elemento, la medición incluye también los fragmentos generados por ese descendiente cuyo ancho y alto sean ambos distintos de cero. Ignora las transformaciones del elemento y de sus antecesores. Si no hay caja, por ejemplo con display: none, el resultado es 0.
En el ejemplo, box-sizing: content-box hace que el resultado sea 100 + 2 * 10 + 2 * 2 = 124. Ni margin: 30px ni transform: scale(2) lo modifican. El código requiere un documento de navegador; una versión de Node.js por sí sola no demuestra que esta API sea compatible.
Ejemplos
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();Resultado
124 0
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.