aria-valuetext

aria-valuetext 屬性定義了範圍部件 aria-valuenow 的人類可讀文字替代。

描述

數字——甚至百分比——並不總是使用者友好的。輔助技術將 aria-valuenow 顯示為數值。如果進度條處於 8%，這意味著什麼？aria-valuetext 提供了一種以更使用者友好、更易於理解的方式呈現當前值的方法。例如，電池電量計值可能顯示為 aria-valuetext="剩餘 8%（34 分鐘）"。

aria-valuetext 屬性與 aria-valuenow 屬性一起使用，而不是替代它，除非該值未知。

僅當 aria-valuenow 的數值沒有意義時，才需要 aria-valuetext。例如，範圍的值是數值，但可能用於非數值，例如大學課程級別。四年制大學的 aria-valuenow 值可以從 1 到 4，表示每個值在值空間中的位置。在這種情況下，aria-valuetext 可以是以下字串之一：“一年級”、“二年級”、“三年級”和“四年級”。

如果數值有意義，例如一個帶有 aria-valuenow="3" 的微調器，用於表示您想要訂購多少塊披薩，則不需要 aria-valuetext。

當同時包含 aria-valuetext 和 aria-valuenow 時，會宣佈 aria-valuetext。當沒有 aria-valuetext 屬性時，輔助技術將宣佈 aria-valuenow 屬性的當前值。