dir グローバル属性は、要素のテキストの書字方向を示す列挙型属性です。以下の値を使用できます:
ltr: left to right を表し、左から右へ記述する言語 (日本語、英語など) に対して使用します。rtl: right to left を表し、右から左へ記述する言語 (アラビア語など) に対して使用します。auto: ユーザエージェントに決定させます。書字方向が明確な文字が見つかるまで要素内の文字をパースして、その方向を要素全体に適用する初歩的なアルゴリズムを使用します。
使用上の注意:
この属性は、セマンティックな位置づけが異なる場所を示す <bdo> 要素で必須です。
- この属性は
<bdi>要素に継承しません。属性を設定しない場合の値はautoになります。 - この属性は、CSS の
directionプロパティやunicode-bidiプロパティでオーバーライドできます。ただし、CSS が有効かつ要素がこれらのプロパティをサポートする場合に限ります。 - テキストの書字方向はその表示ではなく内容に対してセマンティックな関係がありますので、Web 開発者には、可能であれば関連する CSS プロパティの代わりにこの属性を使用することを推奨します。これにより、CSS をサポートしないブラウザや CSS を無効化したブラウザでもテキストが正しく表示されます。
- 値
autoはユーザが入力して最終的にデータベースへ保存するデータなど、書字方向が不定のデータに対して使用してください。
仕様
| 仕様書 | 策定状況 | コメント |
|---|---|---|
| WHATWG HTML Living Standard The definition of 'dir' in that specification. |
Living Standard | 最新のスナップショットである HTML5.1 から変更なし。 |
| HTML5.1 The definition of 'dir' in that specification. |
草案 | WHATWG HTML Living Standard のスナップショットであり、HTML5 から変更はありません。 |
| HTML5 The definition of 'dir' in that specification. |
勧告 | WHATWG HTML Living Standard のスナップショットであり、HTML 4.01 Specification の仕様に値 auto を追加、および真にグローバルな属性になりました。 |
| HTML 4.01 Specification The definition of 'dir' in that specification. |
勧告 | <applet>、<base>、<basefont>、<bdo>、<br>、<frame>、<frameset>、<iframe>、<param>、<script> を除くすべての要素でサポートします。 |
ブラウザ実装状況
| 機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| 基本サポート | (有) | (有) | (有) | (有) | (有) |
| 機能 | Android | Android 版 Chrome | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| 基本サポート | (有) | (有) | (有) | (有) | (有) | (有) |
関連情報
- すべてのグローバル属性。
HTMLElement.dirは、この属性を反映します。