← Back to rules

jsx-a11y/no-autofocus 正确性

An auto-fix is available for this rule.

它的作用

强制禁止在元素上使用 autoFocus 属性。

为什么这是不好的？

自动聚焦元素会对视力正常和非视力正常的用户都造成可用性问题。当焦点在没有用户输入的情况下发生转移时，可能会导致用户迷失方向，并干扰辅助技术的正常使用。用户应当自行控制页面中焦点的移动时机与位置。

示例

此规则的 错误 代码示例：

<div autoFocus />
<div autoFocus="true" />
<div autoFocus="false" />
<div autoFocus={undefined} />

此规则的 正确 代码示例：

<div />

配置

此规则接受一个配置对象，包含以下属性：

ignoreNonDOM

type: boolean

默认值: false

决定是否检查开发者创建的组件。

如何使用

要通过配置文件或命令行启用此规则，可以使用：

配置文件 (.oxlintrc.json)

{
  "plugins": ["jsx-a11y"],
  "rules": {
    "jsx-a11y/no-autofocus": "error"
  }
}

CLI

oxlint --deny jsx-a11y/no-autofocus --jsx-a11y-plugin

参考资料

• 规则源码