Skip to content
← Back to rules

jsx-a11y/mouse-events-have-key-events Correctness

作用

强制 onMouseOver/onMouseOut 需要配合 onFocus/onBlur 使用。

为什么这不好?

为键盘进行编码对有身体残疾、无法使用鼠标的用户、辅助技术兼容性以及屏幕阅读器用户来说都很重要。

示例

以下是此规则的错误代码示例:

jsx
<div onMouseOver={() => void 0} />

以下是此规则的正确代码示例:

jsx
<div onMouseOver={() => void 0} onFocus={() => void 0} />

配置

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

hoverInHandlers

type: string[]

default: ["onMouseOver"]

需要对应键盘事件处理器的悬停进入鼠标事件处理器列表。

hoverOutHandlers

type: string[]

default: ["onMouseOut"]

需要对应键盘事件处理器的悬停离开鼠标事件处理器列表。

如何使用

To enable this rule using the config file or in the CLI, you can use:

json
{
  "plugins": ["jsx-a11y"],
  "rules": {
    "jsx-a11y/mouse-events-have-key-events": "error"
  }
}
ts
import { defineConfig } from "oxlint";

export default defineConfig({
  plugins: ["jsx-a11y"],
  rules: {
    "jsx-a11y/mouse-events-have-key-events": "error",
  },
});
bash
oxlint --deny jsx-a11y/mouse-events-have-key-events --jsx-a11y-plugin

版本

此规则在 v0.1.1 中添加。

参考资料