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

CKTIS / JavaScript

Canvas 2D: estilo de relleno, estilo de trazo y grosor de línea

`fillStyle` define el relleno, `strokeStyle` el aspecto del contorno y `lineWidth` su grosor. Son tres propiedades independientes del estado de dibujo de Canvas 2D.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

ctx.fillStyle = paint;
ctx.strokeStyle = paint;
ctx.lineWidth = width;
// paint: CSS color string, CanvasGradient, or CanvasPattern
// width: finite number greater than 0, in canvas coordinate-space units

fillStyle, strokeStyle y lineWidth son propiedades de una instancia del contexto Canvas 2D, como ctx obtenido con canvas.getContext("2d"). Pertenecen a una API de la plataforma web, no a ECMAScript, por lo que no están disponibles en todos los entornos de JavaScript. Una asignación por sí sola no dibuja nada.

fillStyle define el relleno para fill(), fillRect() y fillText(). strokeStyle define el estilo del trazo para stroke(), strokeRect() y strokeText(). Ambos estilos empiezan en negro y aceptan una cadena de color CSS, un CanvasGradient o un CanvasPattern. Una cadena de color no válida no cambia el valor anterior. Al leer la propiedad se obtiene el color serializado (no necesariamente la cadena original) o el objeto asignado. Los cambios en ese objeto afectan a las operaciones de dibujo posteriores.

lineWidth indica el grosor total del trazo en unidades del sistema de coordenadas, no necesariamente en píxeles de pantalla. El trazo queda centrado sobre el trazado y la escala del contexto puede modificar su grosor visible. El valor inicial es 1. Usa un número finito mayor que cero: se ignoran 0, los números negativos, Infinity, -Infinity y NaN.

Estas propiedades se aplican a las operaciones de dibujo posteriores hasta que cambien o hasta que se restaure o reinicie el estado. save() y restore() guardan y restauran el estado de dibujo, no el trazado actual ni los píxeles. Asignar un patrón de una imagen de otro origen sin permiso CORS puede bloquear la lectura de píxeles: en ese caso, getImageData() lanza SecurityError.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D fill and stroke</title>
<script>
(() => {
  const canvas = document.createElement("canvas");
  canvas.width = canvas.height = 32;
  const ctx = canvas.getContext("2d");
  if (!ctx) throw new Error("Canvas 2D is unavailable");

  ctx.fillStyle = "#ff0000";
  ctx.strokeStyle = "#0000ff";
  ctx.lineWidth = 6;
  ctx.lineWidth = 0;
  ctx.fillRect(8, 8, 16, 16);
  ctx.strokeRect(8, 8, 16, 16);

  const rgba = (x, y) => ctx.getImageData(x, y, 1, 1).data.join(", ");
  console.log(`width: ${ctx.lineWidth}`);
  console.log(`fill: ${rgba(16, 16)}`);
  console.log(`stroke: ${rgba(6, 16)}`);
  console.log(`outside: ${rgba(2, 16)}`);
})();
</script>

Resultado

width: 6
fill: 255, 0, 0, 255
stroke: 0, 0, 255, 255
outside: 0, 0, 0, 0

Guarda el ejemplo como archivo HTML y ábrelo en un navegador. El código no añade el lienzo a la página: muestra en la consola del navegador el grosor y los valores RGBA dentro del relleno, en el contorno y fuera del dibujo. Asignar `0` deja el grosor en `6`.

Lecciones relacionadas

  • JavaScript · Lección 12 · Avanzado · Versión: 4

Fuentes