CKTIS / JavaScript
HTMLCanvasElement: anchura y altura del mapa de bits
`canvas.width` y `canvas.height` fijan el tamaño del mapa de bits, no el de visualización en CSS. En 2D, incluso reasignar el valor actual borra el dibujo y restablece el estado de dibujo.
Versión: Current web platform; runtime support varies
Sintaxis
canvas.width
canvas.height
canvas.width = widthInPixels;
canvas.height = heightInPixels;canvas.width y canvas.height son propiedades de lectura y escritura de un elemento canvas. Reflejan los atributos HTML del mismo nombre y fijan la anchura y la altura del mapa de bits en píxeles. Usa enteros no negativos en los atributos HTML. Si un atributo falta o no puede interpretarse como uno de esos enteros, el valor predeterminado es 300 para la anchura o 150 para la altura. Estas propiedades son de la plataforma web, no de ECMAScript.
canvas.style.width y canvas.style.height fijan el tamaño del elemento en la página, no las dimensiones del mapa de bits. Cambiar solo el CSS deja intactos los píxeles y el dibujo. La imagen mostrada puede verse borrosa al ampliarla o deformada si se estira con otras proporciones.
Con un contexto 2d, asignar cualquiera de las dos dimensiones del mapa de bits borra el dibujo y restablece el estado inicial del mismo contexto, aunque se asigne el valor actual. Esto afecta al trazado actual, la transformación y los estilos, entre otros ajustes. Fija las dimensiones antes de dibujar. Si las cambias después, vuelve a configurar el estado necesario y dibuja de nuevo.
No des por hecho que WebGL o WebGPU se restablecen igual que 2d. Tras llamar a transferControlToOffscreen(), el elemento sirve como punto de visualización: asignar un valor a su width o height lanza InvalidStateError. Fija las dimensiones en el objeto OffscreenCanvas.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Canvas bitmap dimensions</title>
</head>
<body>
<script>
(() => {
const canvas = document.createElement('canvas');
console.log(`Default: ${canvas.width} × ${canvas.height}`);
canvas.width = 4;
canvas.height = 2;
const ctx = canvas.getContext('2d');
if (!ctx) throw new Error('Canvas 2D is unavailable.');
ctx.fillRect(0, 0, 1, 1);
ctx.globalAlpha = 0.5;
const pixelAlpha = () => ctx.getImageData(0, 0, 1, 1).data[3];
canvas.style.width = '40px';
canvas.style.height = '20px';
console.log(`After CSS: ${canvas.width} × ${canvas.height}; pixel alpha ${pixelAlpha()}; globalAlpha ${ctx.globalAlpha}`);
canvas.width = canvas.width;
console.log(`After assignment: ${canvas.width} × ${canvas.height}; pixel alpha ${pixelAlpha()}; globalAlpha ${ctx.globalAlpha}`);
})();
</script>
</body>
</html>Resultado
Default: 300 × 150 After CSS: 4 × 2; pixel alpha 255; globalAlpha 0.5 After assignment: 4 × 2; pixel alpha 0; globalAlpha 1
Abre el archivo HTML en un navegador y consulta la salida en su consola. El canvas no se añade a la página. El cambio de CSS deja el píxel opaco (`255`); reasignar la misma anchura lo borra (`0`) y devuelve `globalAlpha` a `1`.
Lecciones relacionadas
- JavaScript · Lección 26 · Intermedio · Versión: 3
- JavaScript · Lección 27 · Intermedio · Versión: 3