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 属性の titlealt は、 "rtl" としてフォーマットされ、定義されます。

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

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

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

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

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

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

仕様書

Specification
HTML
# dom-dir

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
dir

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

関連情報