HTMLElement: dir プロパティ

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.

HTMLElement.dir プロパティは、現在の要素のコンテンツのテキストを書く書字方向を取得または設定します。

要素のテキストを書く書字方向 (text writing directionality) は、テキストが向かう方向です（様々な言語体系に対応するため）。アラビア語とヘブライ語は、 RTL 書字方向を使用する典型的な言語です。

画像の dir プロパティを "rtl" に設定できます。 この場合、 HTML 属性の title と alt は、 "rtl" としてフォーマットされ、定義されます。

表の dir が "rtl" に設定されている場合、列の順序は右から左に配置されます。

要素の dir が "auto" に設定されている場合、要素の方向は、最初の強い書字方向文字 (strong directionality character)、または既定では親要素の書字方向に基づいて決定されます。

メモ: ブラウザーは、コンテンツの作成を支援するために、ユーザーが <input> と <textarea> の書字方向を変更することを許可する場合があります。 Chrome と Safari は入力フィールドのコンテキストメニューで書字方向のオプションを提供しており、 Chromium になる前の Edge は Ctrl + 左 Shift と Ctrl + 右 Shift のキーバインドを使用しています。 Firefox は Ctrl/Cmd + Shift + X を使用しますが、 dir 属性の値は更新しません。

値

以下のうちの何れかです。

  • ltr: 左書き（左から右へ）
  • rtl: 右書き（右から左へ）
  • auto: 要素の内容に基づいて方向を決定しなければならないことを指定するためのものです。

例

js
const parg = document.getElementById("para1");
parg.dir = "rtl";
// "para1" として識別される段落のテキストの方向を変更します

仕様書

Specification
HTML Standard
# dom-dir

ブラウザーの互換性

BCD tables only load in the browser

関連情報