a11y/no-aria-hidden-on-focusable
Disallow aria-hidden="true" on focusable elements.
| Default severity | Presets | Automatic fix | Options |
|---|---|---|---|
error |
happy-path, nuxt, ecosystem, opinionated |
No | None |
Applies to: Vue SFC templates and blocks, with script context where the rule requires it.
Bad
The focusable Close button is hidden from the accessibility tree with aria-hidden="true".
<template>
<button aria-hidden="true" @click="close">Close</button>
</template>
Good
The button remains exposed and receives a Close label instead of being hidden.
<template>
<button aria-label="Close" @click="close">Close</button>
</template>
Configuration (Vite+)
import { defineConfig } from "@vizejs/vite-plugin/vite-plus";
export default defineConfig({}).withVue({
linter: {
"preset": "incremental",
"rules": {
"a11y/no-aria-hidden-on-focusable": "error"
}
},
});
Then run vp run lint.