CKTIS / JavaScript
Canvas 2D: trazo, relleno, fuente y línea base
Configura el grosor y el estilo del trazo, el relleno, la fuente y la referencia vertical del texto en un contexto Canvas 2D.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
const ctx = canvas.getContext("2d");
// After checking that ctx is not null:
ctx.lineWidth = 4;
ctx.strokeStyle = "#1d4ed8";
ctx.fillStyle = "#dbeafe";
ctx.font = "20px sans-serif";
ctx.textBaseline = "top";
// Read any of these properties with ctx.propertyName.lineWidth, strokeStyle, fillStyle, font y textBaseline son propiedades del contexto devuelto por canvas.getContext("2d"), no del propio elemento canvas. Pertenecen a las API web, no a ECMAScript. Su disponibilidad depende del entorno de ejecución y getContext() puede devolver null. Las asignaciones cambian el estado para las operaciones de dibujo posteriores, no los píxeles ya dibujados. save() guarda ese estado y restore() lo recupera sin deshacer el dibujo ni los cambios en el trazado actual.
lineWidth fija el grosor del trazo en unidades del sistema de coordenadas del canvas; una transformación de escala puede cambiar el grosor visible. El trazo se centra sobre el trazado. El valor inicial es 1. Se ignoran el cero, los números negativos, Infinity, -Infinity y NaN.
strokeStyle fija el estilo de los contornos, por ejemplo con strokeRect() y strokeText(). fillStyle fija el estilo del relleno, por ejemplo con fillRect() y fillText(). Ambos admiten una cadena con un color CSS, un objeto CanvasGradient o un objeto CanvasPattern. Ambos empiezan en negro. Una cadena de color no válida conserva el valor anterior.
font acepta una cadena con la sintaxis abreviada de la propiedad CSS font, como "bold 20px sans-serif". Su valor inicial es "10px sans-serif". Las cadenas no válidas se ignoran y line-height no tiene efecto aquí. Si la fuente no está disponible o aún no se ha cargado, el navegador usa otra; el aspecto de los glifos puede variar entre entornos.
textBaseline elige la referencia vertical que fillText() y strokeText() sitúan en y. "top", "middle" y "bottom" corresponden a la parte superior, al centro y a la parte inferior del cuadro em de la fuente, no a los bordes de los glifos visibles. Las demás opciones son "hanging" (línea base colgante), "alphabetic" (línea base alfabética, predeterminada) e "ideographic" (línea base ideográfica inferior). Otras cadenas se ignoran. La alineación horizontal se controla por separado con textAlign.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Canvas 2D drawing styles</title>
</head>
<body>
<canvas id="demo" width="240" height="80"></canvas>
<script>
const canvas = document.getElementById("demo");
const ctx = canvas.getContext("2d");
if (!ctx) throw new Error("Canvas 2D is unavailable");
const readStyles = () => [
ctx.lineWidth, ctx.strokeStyle, ctx.fillStyle, ctx.font, ctx.textBaseline
].join(" | ");
ctx.save();
ctx.lineWidth = 4;
ctx.lineWidth = 0;
ctx.strokeStyle = "#1d4ed8";
ctx.fillStyle = "#dbeafe";
ctx.fillRect(10, 10, 220, 60);
ctx.strokeRect(10, 10, 220, 60);
ctx.fillStyle = "#172554";
ctx.font = "20px sans-serif";
ctx.textBaseline = "top";
ctx.fillText("Canvas 2D", 22, 20);
console.log(readStyles());
ctx.restore();
console.log(readStyles());
</script>
</body>
</html>Resultado
4 | #1d4ed8 | #172554 | 20px sans-serif | top 1 | #000000 | #000000 | 10px sans-serif | alphabetic
Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta la consola de desarrollo. La primera línea muestra los valores de cinco propiedades del contexto antes de `restore()`. El grosor sigue siendo `4` aunque se asigne `0`. De las cinco propiedades mostradas, `strokeRect()` usa `lineWidth` y `strokeStyle` para el contorno del rectángulo, mientras que `fillText()` usa `fillStyle`, `font` y `textBaseline`. La segunda línea muestra los valores iniciales restaurados. El rectángulo azul claro, su contorno azul y el texto oscuro siguen visibles.
Lecciones relacionadas
- JavaScript · Lección 26 · Intermedio · Versión: 3