选对属性比写对标签更关键:class用于样式分组,id用于唯一锚点和表单绑定,data-*专存业务数据,alt是图片必要替代文本,title仅作悬停提示,布尔属性存在即生效。

选对属性比写对标签更关键——class、id、data-*、title、alt 这几个属性常被混用,但各自有不可替代的语义边界。用错一个,轻则样式难维护,重则影响可访问性或破坏数据提取逻辑。
什么时候必须用 data-* 而不是 class
当你要存业务分类、状态标识、后端 ID 或筛选依据这类“纯数据”,而不是样式意图时,data-* 是唯一合理选择。
-
class是给 CSS 和 JS 用的“样式分组名”,比如class="note note--urgent"表示“这是一个便签,且当前为紧急态”——它描述呈现方式,不承载业务含义 -
data-category="work"则明确表达“这条数据属于工作类”,JS 导出 JSON 时可以直接取el.dataset.category,CSS 也能用[data-category="work"]精准染色 - 别把中文塞进
class,像class="创意"看似省事,但构建工具可能报错、CSS 选择器要加引号、VS Code 自动补全失效 - 如果用
class存分类,后续想加个“高亮所有创意类便签”,就得写.创意, .creative, .idea多个选择器,而data-category只需一条规则
id 的真实约束和常见误用
id 不是“随便起个唯一名字”,它是 DOM 中的硬性锚点,浏览器强制要求页面内唯一,且一旦被用作 CSS 选择器或 JS 查询目标,就承担了结构稳定性责任。
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图,自动匹配视觉风格。触发场景:文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- 千万别给列表项用
id="item-1"——哪怕你手动保证不重复,动态渲染(如 Vue/React)下极易冲突,document.getElementById('item-1')可能返回任意一个 -
id最适合静态锚点:比如@#@#@#@#@#@#@#@#@#@0配合<h2 id="section2">第二节</h2> - 表单控件绑定
label时必须用id:<label for="email">邮箱</label><input id="email">,这里for和id必须严格匹配 - 想用 JS 批量操作?优先选
querySelectorAll('.item')或getElementsByClassName,而不是靠一堆id拼字符串
alt 和 title 的职责不能互换
这两个属性看起来都“显示提示文字”,但浏览器和辅助技术对它们的处理逻辑完全不同,混用会直接导致可访问性失败。
-
alt是<img>的**必要替代文本**,图片加载失败、屏幕阅读器朗读、SEO 抓取都依赖它。空值alt=""表示“该图无信息价值”(如纯装饰性分割线),绝不能省略 -
title是**悬停提示**,仅鼠标移入时显示,屏幕阅读器默认不读,搜索引擎基本忽略。它适合补充说明,比如<abbr title="HyperText Markup Language">HTML</abbr> - 把操作指引塞进
title(如title="点击下载PDF")是无效设计——触屏设备无法悬停,键盘用户也看不到 - 图标按钮必须同时有
alt(功能描述)和aria-label(可访问性增强),单靠title不够
布尔属性的写法陷阱
HTML 布尔属性(如 disabled、required、checked)只要存在即为 true,值的内容无关紧要——但很多人在 JS 动态设置时踩坑。
- 错误写法:
el.setAttribute('disabled', 'false')—— 这仍然让元素禁用,因为属性存在即生效 - 正确写法:
el.disabled = false(推荐)或el.removeAttribute('disabled') - 检查是否启用:
el.hasAttribute('disabled')比el.disabled === true更可靠,因为后者受 JS 覆盖影响 -
checked和selected同理:DOM 属性(el.checked)反映当前状态,HTML 属性(el.hasAttribute('checked'))只反映初始声明
最易被忽略的一点:所有 data-* 属性值在 JS 中通过 dataset 读取时,连字符会自动转为驼峰(data-user-id → el.dataset.userId),但写入时仍需保持 kebab-case;这个转换规则一旦记错,调试时会卡很久。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










