WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Canvas 2D: Füllstil, Konturstil und Linienbreite

`fillStyle` bestimmt die Füllung, `strokeStyle` das Aussehen der Kontur und `lineWidth` deren Stärke. Alle drei sind eigenständige Eigenschaften des Canvas-2D-Zeichenzustands.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

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 und lineWidth sind Instanzeigenschaften eines Canvas-2D-Kontexts, etwa ctx aus canvas.getContext("2d"). Sie gehören zur Webplattform-API, nicht zu ECMAScript, und stehen daher nicht in jeder JavaScript-Laufzeit zur Verfügung. Eine Zuweisung allein zeichnet nichts.

fillStyle bestimmt die Füllung bei fill(), fillRect() und fillText(). strokeStyle bestimmt die Kontur bei stroke(), strokeRect() und strokeText(). Beide Stile sind anfangs schwarz und akzeptieren eine CSS-Farbzeichenfolge, ein CanvasGradient- oder ein CanvasPattern-Objekt. Eine ungültige Farbzeichenfolge lässt den bisherigen Wert unverändert. Beim Auslesen erhältst du die serialisierte Farbe (nicht unbedingt die ursprüngliche Zeichenfolge) oder das zugewiesene Objekt. Änderungen an diesem Objekt wirken sich auf spätere Zeichenvorgänge aus.

lineWidth gibt die gesamte Konturstärke in Einheiten des Koordinatensystems an, nicht unbedingt in Bildschirmpixeln. Die Kontur liegt mittig auf dem Pfad; eine Skalierung des Kontexts kann ihre sichtbare Stärke verändern. Der Anfangswert ist 1. Verwende eine endliche Zahl größer als null: 0, negative Zahlen, Infinity, -Infinity und NaN werden ignoriert.

Die Eigenschaften gelten für spätere Zeichenvorgänge, bis sie geändert werden oder der Zustand wiederhergestellt oder zurückgesetzt wird. save() und restore() sichern und laden den Zeichenzustand, nicht den aktuellen Pfad oder die Pixel. Weist du ein Muster aus einem Bild fremder Herkunft ohne CORS-Freigabe zu, kann das Auslesen von Pixeln gesperrt werden: getImageData() löst dann SecurityError aus.

Beispiele

<!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>

Ergebnis

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

Speichere das Beispiel als HTML-Datei und öffne sie in einem Browser. Der Code fügt das Canvas-Element nicht in die Seite ein, sondern gibt in der Browserkonsole die Breite und die RGBA-Werte in der Füllung, auf der Kontur und außerhalb der Zeichnung aus. Die Zuweisung von `0` lässt die Breite bei `6`.

Zugehörige Lektionen

  • JavaScript · Lektion 12 · Fortgeschritten · Version: 4

Quellen