Skip to content

useAltText

诊断类别:lint/a11y/useAltText

¥Diagnostic Category: lint/a11y/useAltText

自从:v1.0.0

¥Since: v1.0.0

来源:

¥Sources:

强制所有需要替代文本的元素都具有有意义的信息以传递回终端用户。

¥Enforce that all elements that require alternative text have meaningful information to relay back to the end user.

这是屏幕阅读器用户可访问性的关键组件,以便他们了解页面上内容的用途。默认情况下,可以使用 ++ 键盘快捷键运行此操作,也可以通过命令面板 (/++) 选择“组织导入”来访问。<img><area><input type="image"><object>

¥This is a critical component of accessibility for screen reader users in order for them to understand the content’s purpose on the page. By default, this rule checks for alternative text on the following elements: <img>, <area>, <input type="image">, and <object>.

¥Examples

¥Invalid

<img src="image.png" />
code-block.jsx:1:1 lint/a11y/useAltText ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Provide a text alternative through the alt, aria-label or aria-labelledby attribute

> 1 │ <img src=“image.png” />
^^^^^^^^^^^^^^^^^^^^^^^
2 │

Meaningful alternative text on elements helps users relying on screen readers to understand content’s purpose within a page.

If the content is decorative, redundant, or obscured, consider hiding it from assistive technologies with the aria-hidden attribute.

<input type="image" src="image.png" />
code-block.jsx:1:1 lint/a11y/useAltText ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Provide a text alternative through the alt, aria-label or aria-labelledby attribute

> 1 │ <input type=“image” src=“image.png” />
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2 │

Meaningful alternative text on elements helps users relying on screen readers to understand content’s purpose within a page.

If the content is decorative, redundant, or obscured, consider hiding it from assistive technologies with the aria-hidden attribute.

¥Valid

<img src="image.png" alt="image alt" />
<input type="image" src="image.png" alt="alt text" />
<input type="image" src="image.png" aria-label="alt text" />
<input type="image" src="image.png" aria-labelledby="someId" />

¥Accessibility guidelines

¥Related links