aria-multiline

Enter または Return キーの既定での動作は、単一行のテキストフィールドと複数行のテキストフィールドで異なります。ユーザーのフォーカスが単一の行の <input type="text"> にあるとき、通常 Enter または Return キーを押すとフォームを送信します。

ユーザーのフォーカスが複数行 <textarea> にあるとき、キー入力は改行を挿入します。 textbox ロールが設定された要素にのみ受け入れられ、 aria-multiline 属性は、テキストボックスが複数行の入力を受け入れるか、単一の行のみを受け入れるかを支援技術に示し、入力するデータの型やキーストロークが何をするかを設定します。

aria-multiline="true" が設定されている場合、テキストボックスウィジェットは HTML の <textarea> のように入力内の改行を受け入れることを意味しています。この属性を持たない、または値が false に設定されている textbox のロールを持つ要素は単純なテキストボックスです。

テキストボックスを設計する際には、フォーカスとキーストロークを意識してください。 ARIA は、アクセシビリティツリーを変更するだけであり、したがって、支援技術がユーザーにテキストボックスをどのように表示しているかを変更するだけです。 ARIA は要素の既定の機能や動作について何らかの変更をするわけではありません。意味づけされた HTML 要素をその意図する通りに既定の機能で使用しない場合、 JavaScript を使用して、キーストロークイベントへの応答を含め、動作や機能を管理しなければなりません。

true

テキストボックスは複数行の入力を受け入れます。

false

テキストボックスは単一の行しか受け入れません。

Element.ariaMultiLine

ariaMultiLine プロパティは Element インターフェイスの一部で、 aria-multiline 属性の値を反映します。

ElementInternals.ariaMultiLine

ariaMultiLine プロパティは ElementInternals インターフェイスの一部で、 aria-multiline 属性の値を反映します。

使用するロール:

• textbox

継承先のロール:

• searchbox

• ARIA textbox ロール
• ARIA searchbox ロール