<del>和<ins>标签能语义化标记日志中删除与新增内容,提升可访问性及自动化处理能力;支持datetime属性标注时间,宜组合使用体现替换逻辑,并辅以适度视觉优化增强可读性。

用 <del> 和 <ins> 标签,能直观呈现日志中“删了什么”和“加了什么”,比纯文字或颜色标记更语义化、更易被屏幕阅读器识别,也方便后续自动化处理。
用 标记已移除的内容
当某项功能、参数或说明在新版本中被正式废弃或删除时,用 <del> 包裹原内容。浏览器默认渲染为带删除线的文本,语义上明确表示“此内容不再有效”。
- 不要只写“已删除 API”,而要具体标出被删的代码或文字,例如:
<del>getUserInfo()</del> - 可配合
datetime属性注明删除时间:<del datetime="2024-06-15">oldConfigOption</del> - 避免嵌套使用,也不要在
<del>里放链接或交互元素(如按钮),以免行为不一致
用 标记新增的内容
<ins> 表示插入的新内容,浏览器通常显示为带下划线的文本(部分样式可能不同)。它适合标注新增接口、字段、配置项或文档说明。
- 新增内容应完整、独立可读,例如:
<ins>fetchUserData(id, { cache: true })</ins> - 同样支持
datetime属性,便于追溯上线时间:<ins datetime="2024-07-01">support dark mode</ins> - 若新增的是多行内容(如一段配置示例),可用
<pre><ins>...</ins></pre>保持格式,但注意语义合理性
组合使用,体现修改全过程
很多变动本质是“替换”——旧内容删掉、新内容加上。把 <del> 和 <ins> 相邻使用,能清晰还原修改逻辑,比单写“改为XXX”更精确。
立即学习“前端免费学习笔记(深入)”;
- 例如参数变更:
请求参数由 <del>user_id</del> 改为 <ins>userId</ins> - 再如行为调整:
错误提示从 <del>"Invalid key"</del> 更新为 <ins>"API key is missing or expired"</ins> - 不建议用 CSS 覆盖默认样式来“隐藏删除线”或“取消下划线”,这会破坏语义和可访问性
增强可读性与兼容性的实用建议
基础语义有了,再稍作优化,能让日志对开发者更友好:
- 用 灰色 或 浅灰 给
<del>加底色(非覆盖删除线),视觉上弱化已淘汰内容 - 给
<ins>添加轻微背景色(如 淡绿色)并保留下划线,突出新增重点 - 在构建工具(如 Markdown 转 HTML 流程)中,可将
[del]xxx[/del]自动转为<del>xxx</del>,降低撰写门槛 - 确保日志页面的 CSS 中未全局重置
del和ins的text-decoration,否则语义失效



















