dirname
<input> は HTML の要素で、ユーザーからデータを受け取るための、ウェブベースのフォーム用の操作可能なコントロールを作成するために使用します。端末とユーザーエージェントによりますが、広範に渡る種類のデータ入力やコントロールウィジェットが利用できます。<input> 要素は入力型と属性の組み合わせの数が非常に多いため、HTML の中で最も強力かつ最も複雑な要素の一つです。
対応ブラウザ
| 機能 | デスクトップ | モバイル | ||||
|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Safari | Chrome Android | Safari iOS | |
| 17 | 79 | 116 | 6 | 18 | 6 | |
| HTML 属性 | ||||||
| dirname 属性は textarea および input 要素で用いることができ、フォームの送信時に要素のテキストの内容の向きを表します。 ブラウザーは、この属性の値をユーザーが入力したテキストが左から右に読むのか、右から左に読むのかを識別するのに用います。 使用された場合、要素のテキストの方向の値がフォームの送信データに含まれ、そのフィールド名は dirname 属性の値になります。 | 17 | 79 | 116 | 6 | 18 | 6 |
| DOM API | ||||||
| dirName は HTMLInputElement インターフェイスのプロパティで、要素の書字方向を示し、その値が送信できるようにします。これは input 要素の dirName 属性の値を反映します。このプロパティは受け取ったり設定したりすることができます。 | 17 | 79 | 116 | 6 | 18 | 6 |
| dirName は HTMLTextAreaElement インターフェイスのプロパティで、この要素の書字方向を示します。これは textarea 要素の dirName 属性の値を反映します。このプロパティは、取得または設定することができます。 | 17 | 79 | 116 | 6 | 18 | 6 |
基本構文
<form action="/submit">
<input type="text" name="comment" dirname="comment.dir">
<button type="submit">Send</button>
</form>
<!-- 送信データ: comment=テキスト&comment.dir=ltr --> ライブデモ
Direction-aware search
Submit both the text value and the writing direction captured by dirname.
Message direction metadata
Track the detected direction for a textarea without adding a separate visible field.
Multiple localized fields
Collect direction metadata for title and summary fields in one submission.
実務での使いどころ
-
dirname の活用
<input> は HTML の要素で、ユーザーからデータを受け取るための、ウェブベースのフォーム用の操作可能なコントロールを作成するために使用します。
注意点
- 古いブラウザでは対応していない場合がある。
アクセシビリティ
- スクリーンリーダーでの読み上げを確認すること。