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.