aria-multiline

aria-multiline 屬性指示 textbox 是否接受多行輸入或僅接受單行輸入。

描述

EnterReturn 鍵的預設行為在單行和多行文字欄位之間有所不同。當用戶焦點在單行 <input type="text"> 中時,EnterReturn 鍵擊通常會提交表單。

當用戶焦點在多行 <textarea> 中時,鍵擊會插入換行符。僅適用於設定了 textbox 角色的元素,aria-multiline 屬性指示輔助技術該文字框是接受多行輸入還是僅接受單行輸入,從而設定對輸入資料型別的期望以及這些鍵擊將執行的操作。

注意: 儘可能使用 HTML <input><textarea>,因為它們具有內建的語義和行為,不需要 ARIA 屬性或指令碼,並且內建了鍵盤支援。

如果設定了 aria-multiline="true",則表示文字框小部件將接受輸入中的換行符,類似於 HTML <textarea>。角色為 textbox 但沒有該屬性或其值為 false 的元素是簡單的文字框。

在設計文字框時請注意焦點和鍵擊。ARIA 僅修改無障礙樹,因此輔助技術向您的使用者展示文字框的方式會有所不同。ARIA 不會更改元素的預設功能或行為。在不按預期用途和預設功能使用語義 HTML 元素時,您必須使用 JavaScript 來管理行為和功能,包括響應鍵擊事件。

true

文字框接受多行輸入。

false

文字框僅接受單行輸入。

關聯介面

Element.ariaMultiLine

ariaMultiLine 屬性是 Element 介面的一部分,反映 aria-multiline 屬性的值。

ElementInternals.ariaMultiLine

ariaMultiLine 屬性是 ElementInternals 介面的一部分,反映 aria-multiline 屬性的值。

關聯角色

用於的角色

繼承到角色

規範

規範
無障礙富網際網路應用程式 (WAI-ARIA)
# aria-multiline

另請參閱