必须在脚手架模板中硬编码可访问性结构,如作为唯一顶层容器、强制带值、绑定必传altTextprop,因ESLint和html-validate仅报错无法阻止错误模板生成,且CI拦截滞后于开发体验。

直接在脚手架生成阶段把 、、alt 约束等可访问性要求“焊死”进模板文件里,而不是靠文档或口头提醒——否则 90% 的新项目会在第一版就漏掉 或写错 aria-label。
为什么不能只靠 ESLint 或 html-validate 检查
这些工具只能报错,不能阻止错误模板被创建。比如脚手架生成的 不是加个注释或文档说明,而是让模板本身无法合法写出错误结构。 光有正确模板不够,要堵住常见绕过路径。 最易被忽略的点是:脚手架生成的模板里写了 App.vue 里默认用 根本没出现;又比如 标签生成时缺 alt 属性,html-validate 虽能捕获,但 PR 已经提了,修复成本远高于初始约束。
.vue 或 .tsx 里的模板片段,需额外配 vite-plugin-html-validate 或 html-validate-loader
eslint-plugin-jsx-a11y)对 嵌套、 缺 aria-label 这类结构性问题覆盖有限脚手架模板文件必须硬编码的可访问性结构
必须作为顶层语义容器出现在每个页面级组件根节点,且仅出现一次: —— 不允许用 必须带 aria-label,脚手架生成时固定写成:,不提供空 模板 标签禁止裸写,模板中统一为:,并强制 altText 为必传 prop(TS 接口定义),脚手架生成的 模板自带 id 和 for 绑定逻辑,不提供无 label 的版本如何防止开发者绕过模板约束
innerHTML 直接赋值:在脚手架的 ESLint 配置里启用 eslint-plugin-no-inner-html,拦截 el.innerHTML = ' 类动态 HTML'
字符串:模板字符串里出现 ` 就报错,强制走 template.content.cloneNode(true) + textContent 安全填充v-html 和 dangerouslySetInnerHTML 做白名单控制:脚手架内置的 renderHTML() 工具函数只接受预设安全标签(p、strong、ul),其余一律过滤accessibility.md 文档,但关键条目同步写入 tsconfig.json 的 compilerOptions.types,让类型系统参与约束(例如 type AltText = string & { __brand: 'alt-text' }),但开发者复制粘贴时删掉了它,或者把整个组件塞进另一个 里——这需要配合构建时的静态分析(如 html-validate + 自定义 rule)在 dev server 启动时实时扫描,而不是等到 CI。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











