--- title: 使用 aria-label 属性 slug: Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute tags: - ARIA - 参考 - 可访问性 translation_of: Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute ---

aria-label属性用来给当前元素加上的标签描述，接受字符串作为参数。是用不可视的方式给元素加label（如果被描述元素存在真实的描述元素，可使用 aria-labelledby 属性作为来绑定描述元素和被描述元素来代替）。

aria-label属性可以用在任何典型的HTML元素中，并不需要配合特定的ARIA role才能使用。

Value

string

对于用户代理和辅助技术的可能影响

Edit section

Note: 由于辅助技术处理这一技术的差异导致选项信息可能不同.以上所提供的信息只是其中可能的一种，而非一般情况。.

示例

示例1：多标签（Multiple Labels）

在下面的示例中，按钮（button）元素被定义为一个关闭（close）按钮，按钮中间有一个“X”字符。辅助软件并不能知道X是什么意思，所以需要aria-label标签来为辅助设备提供相应的标识来告诉它这个button是close的作用。

<button aria-label="Close" onclick="myDialog.close()">X</button>

说明： 

最常见的对于标签的可访问性API就是可访问的name属性。

ARIA roles的使用

基本标记中的全部元素。

ARIA 相关技术 

兼容性

有待讨论: 为通常的UA和AT产品组合提供支持信息。

额外资源