Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes