ARIA:aria-multiline 屬性
aria-multiline 屬性指示 textbox 是否接受多行輸入,還是僅接受單行輸入。
描述
單行和多行文字欄位在按下 Enter 或 Return 鍵時的預設行為不同。當用戶焦點位於單行 <input type="text"> 時,按下 Enter 或 Return 鍵通常會提交表單。
當用戶焦點位於多行 <textarea> 中時,按鍵會插入一個換行符。aria-multiline 屬性僅與設定了 textbox 角色的元素相關,它向輔助技術指示該文字框接受多行輸入還是僅接受單行輸入,從而設定使用者輸入何種資料以及按鍵將執行何種操作的預期。
注意: 儘可能使用 HTML 的 <input> 或 <textarea> 元素,因為它們具有內建的語義和行為,不需要 ARIA 屬性或指令碼,並且內建了鍵盤支援。
如果設定了 aria-multiline="true",則表示該文字框控制元件將接受輸入中的換行符,類似於 HTML 的 <textarea>。角色為 textbox 且沒有該屬性,或值為 false 的元素是簡單的文字框。
在設計文字框時,請注意焦點和按鍵。ARIA 僅修改可訪問性樹,因此也會改變輔助技術向用戶呈現文字框的方式。ARIA 不會改變元素的預設功能或行為。當不使用語義 HTML 元素來實現其預期目的和預設功能時,您必須使用 JavaScript 來管理行為和功能,包括響應按鍵事件。
值
相關介面
Element.ariaMultiLine-
Element介面的一部分ariaMultiLine屬性反映了aria-multiline屬性的值。 ElementInternals.ariaMultiLine-
ElementInternals介面的一部分ariaMultiLine屬性反映了aria-multiline屬性的值。
相關角色
用於角色
繼承至角色
規範
| 規範 |
|---|
| 無障礙富網際網路應用程式 (WAI-ARIA) # aria-multiline |