CKTIS / JavaScript
HTMLCanvasElement: contexto de renderizado y dimensiones del mapa de bits
Elige un contexto con `getContext()` y dimensiona su mapa de bits con `width` y `height`. A diferencia de CSS, asignar estas propiedades borra el mapa de bits y restablece el estado de dibujo en 2D.
Versión: Current web platform; runtime support varies
Sintaxis
canvas.getContext(contextId)
canvas.getContext(contextId, options)
canvas.width
canvas.height
canvas.width = bitmapWidth
canvas.height = bitmapHeightHTMLCanvasElement es una interfaz del navegador definida por HTML, no por ECMAScript 2024. canvas.getContext(contextId, options) recibe un identificador de texto y opciones que dependen del modo. "2d" selecciona CanvasRenderingContext2D, "bitmaprenderer" selecciona ImageBitmapRenderingContext, "webgl" selecciona WebGLRenderingContext, "webgl2" selecciona WebGL2RenderingContext y "webgpu" selecciona GPUCanvasContext. La disponibilidad de los modos y las opciones depende del entorno de ejecución.
La primera llamada que tiene éxito fija el modo del elemento. Una llamada posterior con el mismo identificador devuelve el mismo objeto sin aplicar nuevas opciones. Un modo no admitido o no disponible, o la solicitud de un modo distinto, devuelve null. Tras una llamada exitosa a transferControlToOffscreen(), el elemento queda como marcador: llamar a getContext() o asignar width o height lanza InvalidStateError.
canvas.width y canvas.height reflejan los atributos HTML del mismo nombre. Indican la anchura y la altura del mapa de bits como enteros no negativos. Si falta un atributo o no se puede interpretar, se usa el valor predeterminado correspondiente: 300 o 150. Cambiar solo canvas.style.width o canvas.style.height modifica el tamaño en pantalla, no la resolución del mapa de bits; al escalar se puede perder nitidez.
En modo 2D, asignar cualquiera de las dimensiones, incluso su valor actual, borra el mapa de bits y restablece el estado de dibujo, incluidos el trazado actual, la transformación y los estilos, sin sustituir el contexto. Fija las dimensiones antes de dibujar; después de redimensionar, restablece el estado que necesites y vuelve a dibujar. No presupongas el mismo comportamiento en otros modos.
Dibujar una imagen de otro origen sin el permiso CORS adecuado puede hacer que el mapa de bits deje de ser origin-clean. Entonces getImageData() lanza SecurityError; redimensionar el mapa de bits 2D descarta su contenido, no expone los píxeles bloqueados.
Ejemplos
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D resize reset</title>
<script>
(() => {
const canvas = document.createElement("canvas");
console.log(`${canvas.width}x${canvas.height}`);
canvas.width = 4;
canvas.height = 3;
console.log(`${canvas.width}x${canvas.height}`);
const ctx = canvas.getContext("2d");
if (ctx === null) throw new Error("2D canvas context unavailable");
ctx.fillRect(0, 0, 1, 1);
ctx.globalAlpha = 0.5;
const alphaAtOrigin = () => ctx.getImageData(0, 0, 1, 1).data[3];
console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);
canvas.width = canvas.width;
console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);
console.log(canvas.getContext("2d") === ctx);
console.log(canvas.getContext("bitmaprenderer") === null);
})();
</script>Resultado
300x150 4x3 255 0.5 0 1 true true
Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta la salida en la consola de desarrollo. Las primeras dos líneas muestran las dimensiones. Reasignar la misma anchura cambia el alfa del píxel de `255` a `0` y devuelve `globalAlpha` de `0.5` a `1`. Los dos resultados `true` muestran que se conserva el contexto y se rechaza otro modo.
Lecciones relacionadas
- JavaScript · Lección 12 · Avanzado · Versión: 4
- JavaScript · Lección 33 · Avanzado · Versión: 4
- JavaScript · Lección 34 · Avanzado · Versión: 4