jsx-a11y/heading-has-content Correctness
作用
强制要求标题元素(h1、h2 等)具有内容,并且 这些内容可被屏幕阅读器访问。 可访问意味着不会使用 aria-hidden 属性将其隐藏。
为什么这很糟糕?
屏幕阅读器会提醒用户注意标题标签的存在。 如果标题为空,或者文本无法被访问, 这可能会让用户感到困惑,甚至可能阻止他们 获取页面结构中的信息。
示例
以下是此规则的错误代码示例:
jsx
<h1 />以下是此规则的正确代码示例:
jsx
<h1>Foo</h1>配置
此规则接受一个包含以下属性的配置对象:
components
type: string[]
default: null
要额外视为标题元素的自定义组件名称。 这些名称将与标准的 h1-h6 元素一起进行验证。
如何使用
To enable this rule using the config file or in the CLI, you can use:
json
{
"plugins": ["jsx-a11y"],
"rules": {
"jsx-a11y/heading-has-content": "error"
}
}ts
import { defineConfig } from "oxlint";
export default defineConfig({
plugins: ["jsx-a11y"],
rules: {
"jsx-a11y/heading-has-content": "error",
},
});bash
oxlint --deny jsx-a11y/heading-has-content --jsx-a11y-plugin版本
此规则于 v0.0.19 中添加。
