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.

TheCanvasRenderingContext2D.directionproperty 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 theDocument as 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 secondis right-to-left. Note that "Hi!" inltr becomes "!Hi" inrtl.

HTML

html

<canvas></canvas>

JavaScript

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);