Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

HTMLElement.offsetWidth — largura de disposição de um elemento

HTMLElement.offsetWidth devolve a largura inteira de um elemento em píxeis CSS. Inclui o preenchimento e as bordas, mas exclui as margens externas. Ignora transformações CSS.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

element.offsetWidth

HTMLElement.offsetWidth é uma propriedade só de leitura de CSSOM View, não uma função ECMAScript. Devolve um número inteiro em píxeis CSS. Para uma caixa única comum, inclui o conteúdo, o preenchimento, as bordas e o espaço ocupado por uma barra de deslocamento vertical, mas exclui as margens externas.

Mais precisamente, mede a largura do retângulo alinhado com os eixos que engloba todos os fragmentos gerados pela caixa principal do elemento, incluindo as respetivas bordas. Se um descendente de nível de bloco dividir a caixa principal em linha do elemento, a medição inclui também os fragmentos gerados por esse descendente cuja largura e altura sejam ambas diferentes de zero. Ignora as transformações do elemento e dos seus antepassados. A ausência de uma caixa, por exemplo com display: none, resulta em 0.

No exemplo, box-sizing: content-box significa que o resultado é 100 + 2 * 10 + 2 * 2 = 124. Nem margin: 30px nem transform: scale(2) o alteram. O código requer um documento de navegador; uma versão de Node.js, por si só, não comprova o suporte desta API.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes