html本身不支持组件状态快照，必须借助javascript；需显式读取element.value、checked等运行时属性，而非getattribute；formdata适用于表单但有局限；通用快照函数需依赖name/id/data-state标识控件。
HTML 本身不支持组件状态快照，必须借助 JavaScript
纯 HTML 是声明式标记语言，没有运行时状态、不可变快照或序列化能力。所谓“HTML 实现状态快照”，实际是指在 HTML 容器中嵌入 JS 逻辑，将 form、input、select 等元素的当前值捕获为可存储/还原的数据结构。
常见错误是试图用 innerHTML 或 outerHTML 保存状态——这只会保留初始属性或静态结构，无法反映用户输入后的 value、checked、selected 等运行时状态。
- 表单控件（如
<input type="text">）的当前值必须读取element.value，而非element.getAttribute('value') - 复选框和单选按钮需检查
element.checked；<select multiple></select>需遍历options并读取每个option.selected - 自定义属性（如
data-*）不会自动参与状态快照，需显式读取并纳入序列化逻辑
用 FormData 快速捕获表单状态（仅限 <form></form> 场景）
FormData 是浏览器原生 API，适合标准表单结构，能自动处理 name 属性、文件输入、多选等细节，但不包含非表单元素（如 div 内的 contenteditable 或自定义 UI 组件）的状态。
const form = document.querySelector('form');
const snapshot = Object.fromEntries(new FormData(form));
注意：FormData 会忽略无 name 属性的控件；禁用（disabled）控件默认不被包含；type="checkbox" 或 type="radio" 未勾选时不会出现在结果中（即只返回“已激活”项）。
- 若需包含未选中的布尔控件，得手动补全：遍历所有
input[type="checkbox"]，用element.checked显式设为true/false -
FormData对<select multiple></select>返回多个同名键值对，Object.fromEntries()会覆盖，应改用Array.from(new FormData(form)).reduce(...)处理重复键 - 不支持
date、range等控件的格式化值（如"2024-05-20"会原样返回，但new Date(snapshot.date)可能失败，因字符串未带时区）
通用快照函数：遍历 DOM 节点并提取运行时状态
当组件超出 <form></form> 范围（比如卡片折叠状态、Tab 激活项、拖拽排序位置），就得手动定义状态映射规则。核心是区分“控件节点”和“状态容器”，避免把整个 DOM 树序列化。
function takeSnapshot(root) {
const state = {};
const controls = root.querySelectorAll('input, select, textarea, [data-state]');
controls.forEach(el => {
const key = el.name || el.id || el.dataset.state;
if (!key) return;
switch (el.type) {
case 'checkbox':
case 'radio':
state[key] = el.checked;
break;
case 'select-multiple':
state[key] = Array.from(el.selectedOptions).map(o => o.value);
break;
default:
state[key] = el.value;
}
});
return state;
}
这个函数依赖显式约定：所有需快照的元素必须有 name、id 或 data-state。漏掉任一标识，该控件就永远不会进入快照。
-
data-state是最灵活的方案，可用于非表单元素（如<button data-state="active-tab"></button>），但需配套维护其值更新逻辑 - 不要用
querySelectorAll('*')全局扫描——性能差且易捕获无关节点（如图标<svg></svg>、装饰性<div>）<li>动态生成的控件（如通过 JS 添加的 <code>input）若未插入 DOM 或未设置标识属性，会被跳过 - 还原前先清空原有状态：对
select先设selectedIndex = -1，再逐个匹配option.value - 对
input[type="file"]，无法还原文件内容，只能记录文件名或哈希，在 UI 上提示“上次选择了 XXX”，由用户重新上传 - 触发
change或input事件（如el.dispatchEvent(new Event('input', { bubbles: true }))），确保绑定的 JS 逻辑（如校验、联动）能响应还原动作 - 如果组件使用框架（React/Vue），直接操作 DOM 可能破坏虚拟 DOM 一致性——此时快照/还原必须走框架提供的状态管理路径，而非 DOM 层面
还原快照时，避免直接赋值引发的副作用
还原不是简单循环 for (let [k, v] of Object.entries(snapshot)) { el.value = v }。某些控件（如 type="file"）禁止 JS 设置 value；contenteditable 元素需用 innerText 或 innerHTML；checked 和 selected 是布尔属性，赋值 null 或 undefined 不会取消选中。
状态快照真正的复杂点不在采集，而在语义对齐：同一个 UI 元素，在不同时间点可能承载不同含义（比如按钮从“编辑”变为“保存”，其 data-state 值变了，但快照里还存着旧键）。这类问题没法靠通用函数解决，得靠业务层明确定义状态契约。
