CanvasRenderingContext2D: strokeStyle-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die CanvasRenderingContext2D.strokeStyle-Eigenschaft der Canvas 2D API gibt die Farbe, den Verlauf oder das Muster an, das für die Umrandungen (Konturen) von Formen verwendet werden soll. Der Standardwert ist #000 (schwarz).

Hinweis: Weitere Beispiele für Umriss- und Füllstile finden Sie unter Anwenden von Stilen und Farben im Canvas-Tutorial.

Wert

Einer der folgenden:

color

Ein String, der als CSS <color>-Wert interpretiert wird.

gradient

Ein CanvasGradient-Objekt (ein linearer oder radialer Verlauf).

pattern

Ein CanvasPattern-Objekt (ein sich wiederholendes Bild).

Beispiele

Ändern der Umrissfarbe einer Form

Dieses Beispiel wendet eine blaue Umrissfarbe auf ein Rechteck an.

HTML

html
<canvas id="canvas"></canvas>

JavaScript

js
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

ctx.strokeStyle = "blue";
ctx.strokeRect(10, 10, 100, 100);

Ergebnis

Erstellen mehrerer Umrissfarben mit Hilfe von Schleifen

In diesem Beispiel verwenden wir zwei for-Schleifen und die Methode arc(), um ein Raster von Kreisen zu zeichnen, von denen jeder eine andere Umrissfarbe hat. Um dies zu erreichen, verwenden wir die beiden Variablen i und j, um eine eindeutige RGB-Farbe für jeden Kreis zu generieren, und ändern nur die grünen und blauen Werte. (Der Rotkanal hat einen festen Wert.)

js
const ctx = document.getElementById("canvas").getContext("2d");

for (let i = 0; i < 6; i++) {
  for (let j = 0; j < 6; j++) {
    ctx.strokeStyle = `rgb(
        0
        ${Math.floor(255 - 42.5 * i)}
        ${Math.floor(255 - 42.5 * j)})`;
    ctx.beginPath();
    ctx.arc(12.5 + j * 25, 12.5 + i * 25, 10, 0, Math.PI * 2, true);
    ctx.stroke();
  }
}

Das Ergebnis sieht so aus:

Spezifikationen

Specification
HTML Standard
# dom-context-2d-strokestyle-dev

Browser-Kompatibilität

BCD tables only load in the browser

In WebKit- und Blink-basierten Browsern ist die nicht standardmäßige und veraltete Methode ctx.setStrokeColor() zusätzlich zu dieser Eigenschaft implementiert.

js
setStrokeColor(color);
setStrokeColor(color, alpha);
setStrokeColor(grayLevel);
setStrokeColor(grayLevel, alpha);
setStrokeColor(r, g, b, a);
setStrokeColor(c, m, y, k, a);

Siehe auch