--- title: dir slug: Web/HTML/Global_attributes/dir tags: - BiDi - Global attributes - HTML - Reference translation_of: Web/HTML/Global_attributes/dir ---
dir
グローバル属性は、要素のテキストの書字方向を示す列挙型属性です。
この対話型サンプルのソースファイルは GitHub リポジトリに格納されています。対話型サンプルプロジェクトに協力したい場合は、 https://github.com/mdn/interactive-examples をクローンしてプルリクエストを送信してください。
次の値を使用することができます。
ltr
: left to right を表し、左書きの言語 (英語など) に対して使用します。rtl
: right to left を表し、右書きの言語 (アラビア語など) に対して使用します。auto
: ユーザーエージェントに決定させます。書字方向が明確な文字が見つかるまで要素内の文字を解釈して、その方向を要素全体に適用する基本的なアルゴリズムを使用します。使用上の注意: この属性は、意味論的な位置づけが異なる場所を示す {{HTMLElement("bdo")}} 要素で必須です。
この属性は {{HTMLElement("bdi")}} 要素に継承されません。属性を設定しない場合の値は auto
になります。
この属性は、 CSS の {{cssxref("direction")}} プロパティや {{cssxref("unicode-bidi")}} プロパティで上書きできます。ただし、 CSS が有効かつ要素がこれらのプロパティに対応する場合に限ります。
テキストの書字方向はその表示ではなく、内容に対して意味論的な関係がありますので、ウェブ開発者には、可能であれば関連する CSS プロパティの代わりにこの属性を使用することを推奨します。これにより、 CSS に対応しないブラウザーや CSS を無効化したブラウザーでもテキストが正しく表示されます。
値 auto
は、ユーザーが入力して最終的にデータベースへ保存するデータなど、書字方向が不定のデータに対して使用してください。
ブラウザーではユーザーが {{ HTMLElement("input") }} や {{ HTMLElement("textarea") }} の書字方向を変更することを許可して、コンテンツの執筆を支援していることがあります。 Chrome と Safari は入力フィールドのコンテキストメニューに書字方向のオプションを提供している一方、 Internet Explorer と Edge はキーバインド Ctrl + Left Shift および Ctrl + Right Shift を使用します。 Firefox は Ctrl/Cmd + Shift + X を使用しますが、 dir
属性の値は変更しません。
仕様書 | 状態 | 備考 |
---|---|---|
{{SpecName('HTML WHATWG', "dom.html#the-dir-attribute", "dir")}} | {{Spec2('HTML WHATWG')}} | 最新のスナップショットである {{SpecName('HTML5.1')}} から変更なし。 |
{{SpecName('HTML5.1', "dom.html#the-dir-attribute", "dir")}} | {{Spec2('HTML5.1')}} | {{SpecName('HTML WHATWG')}} のスナップショットであり、{{SpecName('HTML5 W3C')}} から変更はありません。 |
{{SpecName('HTML5 W3C', "dom.html#the-dir-attribute", "dir")}} | {{Spec2('HTML5 W3C')}} | {{SpecName('HTML WHATWG')}} のスナップショットであり、{{SpecName('HTML4.01')}} の仕様に値 auto を追加、および真にグローバルな属性になりました。 |
{{SpecName('HTML4.01', "dirlang.html#h-8.2", "dir")}} | {{Spec2('HTML4.01')}} | {{HTMLElement("applet")}}, {{HTMLElement("base")}}, {{HTMLElement("basefont")}}, {{HTMLElement("bdo")}}, {{HTMLElement("br")}}, {{HTMLElement("frame")}}, {{HTMLElement("frameset")}}, {{HTMLElement("iframe")}}, {{HTMLElement("param")}}, {{HTMLElement("script")}} を除くすべての要素で対応します。 |
{{Compat("html.global_attributes.dir")}}