HTML 本身不处理协作冲突,仅负责安全清晰地渲染后端或前端生成的解决记录;须用 textContent 防 XSS、Intl.DateTimeFormat 格式化时间、data- 属性存结构化元信息、details/summary 折叠历史、严格校验 conflict_resolution 字段存在性。

HTML 里怎么存协作冲突解决记录
HTML 本身不处理协作冲突,它只是静态标记语言;所谓“显示冲突解决历史”,实际是把后端或前端协作系统生成的解决记录,用 HTML 渲染出来。关键不是 HTML 怎么“做”冲突解决,而是怎么安全、清晰地呈现那些已确认的变更点。
常见错误现象:innerHTML 直接插入未清洗的冲突日志,导致 XSS;或把时间戳写成 2024-05-12T14:23:00.123Z 而不格式化,用户看不懂;还有把“已解决”状态硬编码成 status="resolved",但没同步后端真实状态,造成误导。
- 只用
textContent渲染用户输入字段(如解决人、备注),避免执行任意 HTML - 时间字段统一用
Intl.DateTimeFormat格式化,别依赖new Date().toString() - 状态类字段(如
conflict_status)必须来自可信数据源,不能靠 class 名(如class="resolved")判断逻辑
用 details + summary 折叠旧冲突记录
协作笔记常有大量历史冲突,全展开会拖慢页面、干扰当前编辑。原生 details 元素轻量、语义正确、无需 JS 就能收展,比手写 div + click 更可靠。
使用场景:每次解决冲突后追加一条记录,但默认折叠,只显示摘要行(如“张三于 5月10日 解决段落重叠冲突”)。
-
summary里只放确定性信息:解决人、时间、冲突类型("paragraph_overlap"/"list_order_mismatch") -
details内部用pre包裹原始 diff 片段,保留换行和空格,别用p或span - 不要给
details加open属性——除非是最近一次冲突,否则默认关闭
data- 属性存结构化元信息,别塞进 class
要支持前端筛选或导出冲突历史,得把类型、ID、版本号这些信息显式挂载在 DOM 上。用 class 存逻辑数据(比如 class="resolved-v2.3")会导致解析脆弱、正则易错、CSS 意外触发样式。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
参数差异:浏览器对 data- 属性无限制,可存 JSON 字符串;而 class 是空格分隔字符串,无法表达嵌套结构。
- 用
data-conflict-id="abc123"对应后端冲突 ID - 用
data-resolution-hash="sha256:..."标识本次合并结果的唯一哈希,方便校验 - 避免
data-timestamp存毫秒数,改用 ISO 字符串(data-timestamp="2024-05-10T09:12:33Z"),便于排序和时区转换
渲染前检查 conflict_resolution 字段是否存在
很多协作笔记格式(如 Notion API、自研 Markdown 扩展)把冲突解决记录放在顶层字段 conflict_resolution 下,但它可能为空、为 null、或根本不存在。直接遍历 data.conflict_resolution.history 会抛 Cannot read property 'history' of undefined。
性能影响:错误处理缺失会导致整个渲染流程中断,用户看到空白区域而非“暂无冲突记录”。
- 始终先用
Array.isArray(data?.conflict_resolution?.history)做存在性+类型双检 - 如果字段缺失,渲染一个带
aria-live="polite"的提示段落,而不是静默跳过 - 别在模板里写
{{ conflict_resolution.history.length }}这类裸访问,Vue/React 也一样要 guard
真正难的不是怎么显示,是怎么让每条“已解决”记录都经得起回溯——时间戳是否带时区、解决人是否对应有效账户、diff 片段是否真能还原出原始冲突上下文。这些细节漏掉一个,历史记录就从依据变成摆设。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










