aria-multiline
aria-multiline 属性は textbox が複数行の入力を受け入れるか、単一の行のみを受け入れるかを示します。
解説
Enter または Return キーの既定での動作は、単一行のテキストフィールドと複数行のテキストフィールドで異なります。ユーザーのフォーカスが単一の行の <input type="text"> にあるとき、通常 Enter または Return キーを押すとフォームを送信します。
ユーザーのフォーカスが複数行 <textarea> にあるとき、キー入力は改行を挿入します。 textbox ロールが設定された要素にのみ受け入れられ、 aria-multiline 属性は、テキストボックスが複数行の入力を受け入れるか、単一の行のみを受け入れるかを支援技術に示し、入力するデータの型やキーストロークが何をするかを設定します。
メモ:
可能な場合は、 HTML の <input> または <textarea> を使用してください。これらは意味づけと動作が組み込まれており、 ARIA 属性やスクリプトを必要とせず、キーボード対応が組み込まれているからです。
aria-multiline="true" が設定されている場合、テキストボックスウィジェットは HTML の <textarea> のように入力内の改行を受け入れることを意味しています。この属性を持たない、または値が false に設定されている textbox のロールを持つ要素は単純なテキストボックスです。
テキストボックスを設計する際には、フォーカスとキーストロークを意識してください。 ARIA は、アクセシビリティツリーを変更するだけであり、したがって、支援技術がユーザーにテキストボックスをどのように表示しているかを変更するだけです。 ARIA は要素の既定の機能や動作について何らかの変更をするわけではありません。意味づけされた HTML 要素をその意図する通りに既定の機能で使用しない場合、 JavaScript を使用して、キーストロークイベントへの応答を含め、動作や機能を管理しなければなりません。
値
関連インターフェイス
Element.ariaMultiLine-
ariaMultiLineプロパティはElementインターフェイスの一部で、aria-multiline属性の値を反映します。 ElementInternals.ariaMultiLine-
ariaMultiLineプロパティはElementInternalsインターフェイスの一部で、aria-multiline属性の値を反映します。
関連付けられたロール
仕様書
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-multiline |