dir グローバル属性 は、要素のテキストの書字方向を示す列挙型属性です。
この対話型サンプルのソースファイルは GitHub リポジトリに格納されています。対話型サンプルプロジェクトに協力したい場合は、 https://github.com/mdn/interactive-examples をクローンしてプルリクエストを送信してください。
次の値を使用することができます。
ltr: left to right を表し、左書きの言語 (英語など) に対して使用します。rtl: right to left を表し、右書きの言語 (アラビア語など) に対して使用します。auto: ユーザーエージェントに決定させます。書字方向が明確な文字が見つかるまで要素内の文字を解釈して、その方向を要素全体に適用する基本的なアルゴリズムを使用します。
使用上のメモ
この属性は、意味論的な位置づけが異なる場所を示す <bdo> 要素で必須です。
-
この属性は
<bdi>要素に継承されません。属性を設定しない場合の値はautoになります。 -
この属性は、 CSS の
directionプロパティやunicode-bidiプロパティで上書きできます。ただし、 CSS が有効かつ要素がこれらのプロパティに対応する場合に限ります。 -
テキストの書字方向はその表示ではなく、内容に対して意味論的な関係がありますので、ウェブ開発者には、可能であれば関連する CSS プロパティの代わりにこの属性を使用することを推奨します。これにより、 CSS に対応しないブラウザーや CSS を無効化したブラウザーでもテキストが正しく表示されます。
-
値
autoは、ユーザーが入力して最終的にデータベースへ保存するデータなど、書字方向が不定のデータに対して使用してください。
仕様書
| 仕様書 | 状態 | 備考 |
|---|---|---|
| HTML Living Standard dir の定義 |
現行の標準 | 最新のスナップショットである HTML 5.1 から変更なし。 |
| HTML 5.1 dir の定義 |
勧告 | HTML Living Standard のスナップショットであり、HTML5 から変更はありません。 |
| HTML5 dir の定義 |
勧告 | HTML Living Standard のスナップショットであり、HTML 4.01 Specification の仕様に値 auto を追加、および真にグローバルな属性になりました。 |
| HTML 4.01 Specification dir の定義 |
勧告 | <applet>, <base>, <basefont>, <bdo>, <br>, <frame>, <frameset>, <iframe>, <param>, <script> を除くすべての要素で対応します。 |
ブラウザーの対応
このページの互換性一覧表は構造化データから生成されています。データに協力したいのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。
Update compatibility data on GitHub
| デスクトップ | モバイル | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
dir | Chrome 完全対応 あり | Edge 未対応 なし | Firefox 完全対応 あり | IE 未対応 なし | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
凡例
- 完全対応
- 完全対応
- 未対応
- 未対応
関連情報
- すべてグローバル属性
HTMLElement.dirは、この属性を反映します。