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 属性的当前值。