CKTIS / JavaScript
Canvas 2D: Kontur, Füllung, Schrift und Grundlinie
Lege Konturbreite und Konturstil, Füllstil, Schrift und vertikalen Textbezugspunkt in einem Canvas-2D-Kontext fest.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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 und textBaseline sind Eigenschaften des Kontexts, den canvas.getContext("2d") liefert, nicht des Canvas-Elements selbst. Sie gehören zur Web-API, nicht zu ECMAScript. Ihre Verfügbarkeit hängt von der Laufzeitumgebung ab; getContext() kann null zurückgeben. Zuweisungen ändern den Zustand für spätere Zeichenoperationen, nicht bereits gezeichnete Pixel. save() speichert den Zustand, restore() stellt ihn wieder her, ohne die Zeichnung oder Änderungen am aktuellen Pfad rückgängig zu machen.
lineWidth bestimmt die Konturbreite in Einheiten des Canvas-Koordinatensystems. Eine Skalierung kann die sichtbare Breite verändern. Die Kontur liegt mittig auf dem Pfad. Der Anfangswert ist 1. Null, negative Zahlen, Infinity, -Infinity und NaN werden ignoriert.
strokeStyle bestimmt den Stil der Konturen, etwa bei strokeRect() und strokeText(). fillStyle bestimmt den Stil gefüllter Flächen, etwa bei fillRect() und fillText(). Beide akzeptieren eine CSS-Farbangabe als Zeichenkette, ein CanvasGradient- oder ein CanvasPattern-Objekt. Beide sind zunächst schwarz. Eine ungültige Farbzeichenkette lässt den bisherigen Wert unverändert.
font erwartet eine Zeichenkette in der CSS-Kurzschreibweise für font, etwa "bold 20px sans-serif". Der Anfangswert ist "10px sans-serif". Ungültige Zeichenketten werden ignoriert, und line-height hat hier keine Wirkung. Ist eine Schrift nicht verfügbar oder noch nicht geladen, verwendet der Browser eine Ersatzschrift. Das Aussehen der Glyphen kann je nach Umgebung variieren.
textBaseline wählt den vertikalen Bezugspunkt, den fillText() und strokeText() auf y legen. "top", "middle" und "bottom" beziehen sich auf die Oberkante, Mitte und Unterkante des Em-Quadrats der Schrift, nicht auf die sichtbaren Glyphenränder. Weitere Optionen sind "hanging" (hängende Grundlinie), "alphabetic" (alphabetische Grundlinie, Standard) und "ideographic" (untere ideografische Grundlinie). Andere Zeichenketten werden ignoriert. Die horizontale Ausrichtung regelt separat textAlign.
Beispiele
<!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>Ergebnis
4 | #1d4ed8 | #172554 | 20px sans-serif | top 1 | #000000 | #000000 | 10px sans-serif | alphabetic
Speichere das Beispiel als HTML-Datei, öffne sie im Browser und sieh in die Entwicklerkonsole. Die erste Zeile zeigt die Werte von fünf Kontexteigenschaften vor `restore()`. Die Breite bleibt trotz der Zuweisung von `0` bei `4`. Von den fünf ausgegebenen Eigenschaften verwendet `strokeRect()` `lineWidth` und `strokeStyle` für die Rechteckkontur; `fillText()` verwendet `fillStyle`, `font` und `textBaseline`. Die zweite Zeile zeigt die wiederhergestellten Anfangswerte. Das hellblaue Rechteck mit blauer Kontur und dunklem Text bleibt sichtbar.
Zugehörige Lektionen
- JavaScript · Lektion 26 · Mittlere Stufe · Version: 3