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-valuetextaria-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

另見