Vize

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.