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>。角色為 textbox 但沒有該屬性或其值為 false 的元素是簡單的文字框。
在設計文字框時請注意焦點和鍵擊。ARIA 僅修改無障礙樹,因此輔助技術向您的使用者展示文字框的方式會有所不同。ARIA 不會更改元素的預設功能或行為。在不按預期用途和預設功能使用語義 HTML 元素時,您必須使用 JavaScript 來管理行為和功能,包括響應鍵擊事件。
值
關聯介面
Element.ariaMultiLine-
ariaMultiLine屬性是Element介面的一部分,反映aria-multiline屬性的值。 ElementInternals.ariaMultiLine-
ariaMultiLine屬性是ElementInternals介面的一部分,反映aria-multiline屬性的值。
關聯角色
規範
| 規範 |
|---|
| 無障礙富網際網路應用程式 (WAI-ARIA) # aria-multiline |