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 |