CKTIS / HTML
Atributo HTML width
El atributo width indica el ancho de los elementos HTML que lo admiten. Acepta un entero no negativo sin unidad. En canvas, controla el ancho del mapa de bits, no solo el tamaño de visualización establecido con CSS.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
width="<non-negative integer>"width no es un atributo global. Indica la dimensión horizontal en píxeles CSS en img, iframe, embed, object, video, input con type="image" y en source cuyo elemento padre es picture. Su valor es un entero no negativo, como width="240", sin px ni %.
Los atributos de dimensiones son indicaciones para el renderizado; CSS puede cambiar el tamaño de visualización. No están pensados para estirar las imágenes: un par de width y height debería conservar la proporción natural dentro de la tolerancia de redondeo definida por el estándar. picture no admite width por sí mismo; su elemento img muestra la imagen, y también se pueden indicar dimensiones en los elementos source correspondientes.
En canvas, el atributo width controla el ancho del mapa de bits. Si falta el valor o se produce un error al analizarlo, se usa el valor predeterminado 300; la altura predeterminada es 150. Cambiar solo el tamaño CSS escala la presentación sin modificar las dimensiones del mapa de bits. Establecer width con un contexto 2D borra el mapa de bits y restablece el estado de dibujo, incluso si se asigna el valor que ya tenía.
El ejemplo separa los dos tamaños: el mapa de bits mide 240 × 120, pero se muestra a 480 × 240 píxeles CSS.
Ejemplos
<!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
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.