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

CKTIS / HTML

Atributo HTML width

O atributo width especifica a largura dos elementos HTML que o suportam. Aceita um número inteiro não negativo sem unidade. Em canvas, controla a largura do bitmap, não apenas o tamanho de apresentação definido por CSS.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

width="<non-negative integer>"

width não é um atributo global. Especifica a dimensão horizontal em píxeis CSS em img, iframe, embed, object, video, input com type="image" e em source cujo elemento pai é picture. O valor é um número inteiro não negativo, como width="240", sem px nem %.

Os atributos de dimensão são indicações para a apresentação; CSS pode alterar o tamanho apresentado. Não se destinam a esticar imagens: um par de width e height deve preservar as proporções naturais dentro da tolerância de arredondamento definida pela norma. picture não suporta width por si só; a imagem é apresentada pelo seu elemento img, e também é possível indicar dimensões nos elementos source relevantes.

Em canvas, o atributo width controla a largura do bitmap. Se o valor estiver em falta ou ocorrer um erro ao analisá-lo, é usado o valor predefinido 300; a altura predefinida é 150. Alterar apenas o tamanho CSS escala a apresentação sem mudar as dimensões do bitmap. Definir width com um contexto 2D limpa o bitmap e repõe o estado de desenho, mesmo que seja atribuído o valor já existente.

O exemplo distingue os dois tamanhos: o bitmap mede 240 × 120, mas é apresentado a 480 × 240 píxeis CSS.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>width attribute</title>
<canvas id="drawing" width="240" height="120" style="width: 480px; height: 240px">Canvas demonstration</canvas>
<pre id="result"></pre>
<script>
  const canvas = document.getElementById('drawing');
  document.getElementById('result').textContent =
    `Bitmap: ${canvas.width} x ${canvas.height}\n` +
    `CSS width: ${getComputedStyle(canvas).width}`;
</script>
</html>

Resultado

Bitmap: 240 x 120
CSS width: 480px

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