CanvasRenderingContext2D: direction property
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since May 2022.
The
CanvasRenderingContext2D.direction
property of the Canvas 2D API specifies the current text direction used to draw text.
Value
Possible values:
"ltr"-
The text direction is left-to-right.
"rtl"-
The text direction is right-to-left.
"inherit"-
The text direction is inherited from the
<canvas>element or theDocumentas appropriate. Default value.
The default value is "inherit".
Examples
Changing text direction
This example draws two pieces of text. The first one is left-to-right, and the second
is right-to-left. Note that "Hi!" in ltr becomes "!Hi" in rtl.
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);
Result
Specifications
| Specification |
|---|
| HTML # dom-context-2d-direction-dev |
Browser compatibility
Loading…
See also
- The interface defining this property:
CanvasRenderingContext2D