MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

A propriedade HTMLElement.offsetWidth é de somente leitura e retorna a largura de um elemento no layout.  Normalmente, o offsetWidth é uma medida que inclui as bordas do elemento, seu padding horizontal e o vertical scrollbar (se presente e renderizado) e também a largura CSS do elemento.

Sintaxe 

var offsetWidth =element.offsetWidth;

offsetWidth é uma propriedade somente leitura.

Esta propriedade irá arredondar o valor para um inteiro. se você precisa um valor fracionado, use element.getBoundingClientRect().

 

Exemplo

 

             Image:Dimensions-offset.png

Especificação

Especificação Situação Comentário
CSS Object Model (CSSOM) View Module
The definition of 'offsetWidth' in that specification.
Rascunho atual  

Notas

offsetWidth é uma propriedade do modelo de objeto DHTML que foi primeiro apresentado pelo MSIE. Algumas vezes referenciado como as dimensões físicas/gráficas do elemento, ou a largura do border-box.

Compatibilidade de Browsers

Funcionalidade  Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (Yes) (Yes) ? ? ? ?
Funcionalidade Android Android Webview Edge Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support ? (Yes) (Yes) ? ? ? ? ? (Yes)

De acordo com a especificação. essa propriedade irá retornar null no Webkit se o elemento estiver escondido (o style.display deste elemento ou qualquer um acima dele for "none") ou se style.position do elemento for definido como "fixed".

Esta propriedade irá retornar null no Internet Explorer (9) se style.position do elemento estiver definida como "fixed". (Tendo display:none não afeta este browser).

Veja também

 

Etiquetas do documento e colaboradores

 Colaboradores desta página: gsoldateli
 Última atualização por: gsoldateli,