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

另见