CanvasRenderingContext2D: textAlign-Eigenschaft
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die CanvasRenderingContext2D.textAlign-Eigenschaft der Canvas 2D API legt die aktuelle Textausrichtung fest, die beim Zeichnen von Text verwendet wird.
Die Ausrichtung bezieht sich auf den x-Wert der fillText()-Methode. Zum Beispiel, wenn textAlign auf "center" gesetzt ist, liegt die linke Kante des Textes bei x - (textWidth / 2).
Wert
Mögliche Werte:
"left"-
Der Text ist linksbündig.
"right"-
Der Text ist rechtsbündig.
"center"-
Der Text ist zentriert.
"start"-
Der Text ist am normalen Anfang der Zeile ausgerichtet (linksbündig für von links nach rechts verlaufende Sprachen, rechtsbündig für von rechts nach links verlaufende Sprachen).
"end"-
Der Text ist am normalen Ende der Zeile ausgerichtet (rechtsbündig für von links nach rechts verlaufende Sprachen, linksbündig für von rechts nach links verlaufende Sprachen).
Der Standardwert ist "start".
Beispiele
>Allgemeine Textausrichtung
Dieses Beispiel demonstriert die drei "physischen" Werte der textAlign-Eigenschaft: "left", "center" und "right".
HTML
<canvas id="canvas"></canvas>
JavaScript
const canvas = document.getElementById("canvas");
canvas.width = 350;
const ctx = canvas.getContext("2d");
const x = canvas.width / 2;
ctx.beginPath();
ctx.moveTo(x, 0);
ctx.lineTo(x, canvas.height);
ctx.stroke();
ctx.font = "30px serif";
ctx.textAlign = "left";
ctx.fillText("left-aligned", x, 40);
ctx.textAlign = "center";
ctx.fillText("center-aligned", x, 85);
ctx.textAlign = "right";
ctx.fillText("right-aligned", x, 130);
Ergebnis
Richtungsabhängige Textausrichtung
Dieses Beispiel demonstriert die zwei richtungsabhängigen Werte der textAlign-Eigenschaft: "start" und "end". Beachten Sie, dass die direction-Eigenschaft manuell als "ltr" angegeben wird, obwohl dies auch der Standard für englischsprachigen Text ist.
HTML
<canvas id="canvas"></canvas>
JavaScript
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
ctx.font = "30px serif";
ctx.direction = "ltr";
ctx.textAlign = "start";
ctx.fillText("Start-aligned", 0, 50);
ctx.textAlign = "end";
ctx.fillText("End-aligned", canvas.width, 120);
Ergebnis
Spezifikationen
| Specification |
|---|
| HTML> # dom-context-2d-textalign-dev> |
Browser-Kompatibilität
Loading…
Siehe auch
- Das Interface, das diese Eigenschaft definiert:
CanvasRenderingContext2D