CanvasRenderingContext2D: direction プロパティ

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.

CanvasRenderingContext2D.direction はキャンバス 2D API のプロパティで、テキストを描画する際に使用する現在の書字方向を指定します。

取りうる値は下記の通りです。

"ltr"

テキストの書字方向を左書き (left-to-right) にします。

"rtl"

テキストの書字方向を右書き (right-to-left) にします。

"inherit"

テキストの書字方向を <canvas> 要素または Document から適宜継承します。既定値です。

既定値は "inherit" です。

書字方向の変更

この例では、 2 つのテキストを描画しています。最初のものは左から右へ、 2 番目は右から左へ描画します。ltr の "Hi!" は rtl では "!Hi" になることに注意してください。

HTML

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

JavaScript

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

ctx.font = "48px serif";
ctx.fillText("Hi!", 150, 50);
ctx.direction = "rtl";
ctx.fillText("Hi!", 150, 130);

結果

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser

関連情報