ARIA:aria-valuetext 屬性
aria-valuetext 屬性為範圍控制元件定義了 aria-valuenow 的人類可讀文字替代。
描述
數字——即使是百分比——並不總是對使用者友好。輔助技術將 aria-valuenow 顯示為數字值。如果進度條是 8%,這意味著什麼?aria-valuetext 提供了一種以更使用者友好、人類可理解的方式呈現當前值的方法。例如,電池電量指示器的值可能透過 aria-valuetext="8% (剩餘 34 分鐘)" 來傳達。
aria-valuetext 屬性與 aria-valuenow 屬性一起使用,而不是替代它,除非該值未知。
只有當 aria-valuenow 的數值沒有意義時,才需要 aria-valuetext。例如,範圍的值是數字的,但可能用於非數字值,例如大學班級級別。4 年制大學的 aria-valuenow 的值可能在 1 到 4 之間,這表示每個值在值空間中的位置。在這種情況下,aria-valuetext 可以是以下字串之一:“first year”(一年級)、“sophomore”(二年級)、“junior”(三年級)和“senior”(四年級)。
如果數值有意義,例如,您想訂購多少片披薩,那麼一個帶有 aria-valuenow="3" 的微調器就不需要 aria-valuetext。
當同時包含 aria-valuetext 和 aria-valuenow 時,會朗讀 aria-valuetext。當沒有 aria-valuetext 屬性時,輔助技術將朗讀 aria-valuenow 屬性以獲取當前值。
值
<string>-
aria-valuenow值的可讀文字替代。
相關介面
Element.ariaValueText-
Element介面的一部分的ariaValueText屬性反映了aria-valuetext屬性的值。 ElementInternals.ariaValueText-
ElementInternals介面的一部分的ariaValueText屬性反映了aria-valuetext屬性的值。
相關角色
用於角色
繼承到角色
規範
| 規範 |
|---|
| 無障礙富網際網路應用程式 (WAI-ARIA) # aria-valuetext |