ARIA:aria-placeholder 屬性

aria-placeholder 屬性用於定義一個簡短的提示(一個詞或短語),旨在當表單控制元件沒有值時,幫助使用者進行資料輸入。該提示可以是一個示例值,也可以是對預期格式的簡要說明。

描述

佔位符是當表單控制元件沒有設定值時顯示的文字。HTML 的 placeholder 屬性允許為幾種 HTML <input> 型別和 <textarea> 提供示例值或對預期格式的簡要說明。

如果您使用除語義化標籤外的其他元素建立 textbox,則 placeholder 不受支援。這時 aria-placeholder 就派上用場了。aria-placeholder 屬性可以用來定義一個簡短的提示,幫助使用者理解在非語義化表單控制元件沒有值時,預期輸入什麼型別的資料。

html
<span id="date-of-birth">Birthday</span>
<div
  contenteditable
  role="textbox"
  aria-labelledby="date-of-birth"
  aria-placeholder="MM-DD-YYYY">
  MM-DD-YYYY
</div>

佔位符提示應在控制元件的值為空時顯示給使用者,包括當值被刪除時。

注意: ARIA 僅修改元素的輔助功能樹,從而影響輔助技術如何向用戶呈現內容。ARIA 不會改變元素的任何功能或行為。當不將語義化 HTML 元素用於其預期目的和預設功能時,您必須使用 JavaScript 來管理行為。

aria-placeholder 應與標籤一起使用,而不是替代標籤。它們有不同的目的和不同的功能。標籤解釋了期望什麼樣的資訊。佔位符文字提供對預期值的提示。

警告: 使用佔位符代替可見標籤會損害許多使用者的可訪問性和可用性,包括老年使用者以及有認知、行動、精細運動技能和視力障礙的使用者。標籤更好:它們始終可見,並且提供了更大的可聚焦區域來聚焦控制元件。佔位符有幾個缺點:當控制元件有任何值(包括僅僅是空格)時它們會消失;它們可能讓使用者誤以為值已預先填充;並且預設顏色對比度不足。

注意: 佔位符僅應用於顯示應輸入表單的資料型別示例;它們不能替代正確的標籤。

<string>

當控制元件沒有值時,將在控制元件中顯示的詞或短語。

相關介面

Element.ariaPlaceholder

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

ElementInternals.ariaPlaceholder

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

相關角色

用於角色

繼承到角色

規範

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

另見