aria-label

String

Provides an invisible text label for an element that has no visible text, such as an icon-only button. Screen readers announce this string as the element's accessible name. Prefer a visible label referenced with aria-labelledby where you can, since aria-label text never appears on screen.

aria-label="…"

Value

Any string of text.

Used on

Any HTML element — aria-label is a global property.

Associated roles

Every ARIA role. As a global property, aria-label is supported on all roles.

Example

aria-label="…"

<button aria-label="Close dialog">
  <svg aria-hidden="true">…</svg>
</button>

References

WAI-ARIA 1.2 specification
MDN Web Docs