ARIA:aria-multiline 屬性

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

描述

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

當用戶焦點位於多行 <textarea> 中時,按鍵會插入一個換行符。aria-multiline 屬性僅與設定了 textbox 角色的元素相關,它向輔助技術指示該文字框接受多行輸入還是僅接受單行輸入,從而設定使用者輸入何種資料以及按鍵將執行何種操作的預期。

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

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

在設計文字框時,請注意焦點和按鍵。ARIA 僅修改可訪問性樹,因此也會改變輔助技術向用戶呈現文字框的方式。ARIA 不會改變元素的預設功能或行為。當不使用語義 HTML 元素來實現其預期目的和預設功能時,您必須使用 JavaScript 來管理行為和功能,包括響應按鍵事件。

true

文字框接受多行輸入。

false

文字框僅接受單行輸入。

相關介面

Element.ariaMultiLine

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

ElementInternals.ariaMultiLine

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

相關角色

用於角色

繼承至角色

規範

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

另見