HTML属性清理需严格限制使用范围:id限JS绑定与表单关联且用camelCase;class须带业务前缀、小写中划线分隔;data-必须带业务前缀和类型标识,禁用模糊命名;aria-须成对显式添加;布尔型data-*用无值写法;须用html-validate等工具自动化拦截违规属性并阻断CI构建。

HTML属性清理不是“删掉不用的属性”这么简单,而是防止团队成员随意添加、拼写错误、语义冲突或可访问性破坏的关键控制点。不清理,class 会堆成 class="btn btn-primary user-btn active is-loading",data- 会变成 data-id、data-item-id、dataProductId 并存,最终导致 JS 查询失效、样式覆盖、CI 校验失败。
哪些 HTML 属性必须严格限制使用范围
不是所有合法属性都该被允许出现在业务 HTML 中。放任自流的结果是:A 团队加 data-track 做埋点,B 团队用 data-analytics 做同样事,C 团队又写了个 data-event——三套逻辑并行,没人敢动。
-
id只允许用于 JS 明确绑定的锚点或表单关联(如for属性),禁止纯样式控制;命名必须用camelCase,如loginForm、searchInput -
class必须带业务前缀且全小写中划线分隔(如user-avatar、product-card),禁用btn、card这类无域前缀的“全局污染名” -
data-属性必须带明确业务前缀和类型标识,如data-product-id、data-user-role;禁用data-id、data-value等模糊命名 -
aria-属性只在必要时显式添加,且必须配对出现(如aria-expanded+aria-controls),不能靠“看起来像无障碍”就乱加
为什么 Prettier 默认配置会放大属性混乱
prettier 默认按字母顺序重排属性,把 data-i18n 排到 class 后面、onclick 前面,会导致屏幕阅读器跳过翻译键;更严重的是,它不校验属性值是否合法(比如 role="buton" 拼错)或是否重复(class="a b" class="c")。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 必须在
.prettierrc中显式设置htmlWhitespaceSensitivity: "css",避免空格差异引发 Git 冲突 - 禁用
prettier处理data-逻辑——它不管命名规范,只管格式;要用html-validate或自定义 ESLint 规则拦截data-userid(应为data-user-id) - 对布尔型
data-属性统一用无值写法:data-loading而非data-is-loading="true",JS 判断更简洁:el.hasAttribute('data-loading')
如何自动化识别和拦截违规属性
靠 Code Review 发现 data-productId 和 data-product-id 并存?太晚了。真正有效的做法是让工具在提交前就报错。
- 用
html-validate配置规则:"attr-name-style": ["error", "dash"]拦截驼峰/下划线写法;"attr-no-unknown"拦截拼错的aria-属性 - CI 流程中跑
npx html-validate --config .htmlvalidate.json src/**/*.html,任何属性违规直接阻断构建 - 配合
lint-staged在 commit 前扫描新增 HTML 文件,自动检测未声明的data-键(如data-order-status出现在 HTML 里,但没在lang/en.json中定义) - 对 SSR 或静态生成项目,额外加一层检查:禁止出现
data-server-rendered以外的data-属性,防止服务端与客户端状态不一致
属性清理最难的不是技术,而是让所有人接受“这个属性不能加”的约束。一旦放开口子,data-temp-fix、class="hacky-fix" 就会悄悄上线,再难清除。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










