仪表盘草稿需分离存储业务数据与UI状态,用防抖+键名隔离+框架适配恢复;仅存input.value会丢失卡片顺序、折叠状态、图表配置等关键交互信息。

仪表盘页面不是普通表单,自动保存草稿不能只存 input.value —— 它往往含动态渲染的卡片、折叠状态、筛选条件、时间范围选择器、甚至嵌入的图表配置。直接监听 input 事件并写入 localStorage.setItem() 会漏掉 UI 状态,刷新后界面“看起来一样”,但所有交互都失效。
为什么仪表盘草稿比普通表单更难恢复
普通表单字段是静态 DOM 节点,而仪表盘常依赖框架(如 React/Vue)或库(如 Chart.js、Ag-Grid、Ant Design)管理状态。这些状态不会映射到 value 或 checked 属性上:
- 时间范围选择器(如
)值存在组件内部 state,DOM 上只有 placeholder - 可折叠面板(
Accordion)的展开/收起状态不反映在 HTML 属性中 - 图表的缩放、拖拽位置、图例开关等,全靠 JS 对象维护
- 动态加载的卡片列表(如用户自定义看板),其顺序、可见性、配置项需单独序列化
怎么存:必须分离“数据”和“UI 状态”
不能只存表单字段值;得把两类信息分别提取、合并、再存:
-
业务数据:筛选参数(
filterBy: "status=active")、时间范围(dateRange: ["2026-10-01", "2026-10-27"])、搜索关键词(keyword: "payment")—— 这些通常来自 URL query 或 API 请求参数 -
UI 状态:卡片 ID 列表及其
order和visible、每个Accordion的activeKey、图表容器的zoomLevel、表格列宽/排序(columns: [{key:"name",width:200,sort:"asc"}]) - 存前必须做
JSON.stringify(),键名推荐:dashboard-state-${location.pathname}-${dashboardId},避免多个仪表盘页互相覆盖 - 中文输入法下仍要防抖:用
setTimeout+clearTimeout,延迟 800ms 再触发保存,否则频繁操作(如拖动时间滑块)会卡顿
怎么恢复:DOM 就位 + 状态注入 + 手动触发更新
仪表盘恢复失败,八成是因为执行时机错或没走对框架通道:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 原生 JS 项目:等
DOMContentLoaded后再读localStorage.getItem(),但必须确认所有卡片、组件 DOM 已挂载(可用MutationObserver监听容器变化,或加setTimeout(..., 100)等微任务清空) - React 项目:在
useEffect(() => { ... }, [])里恢复,且必须调用对应 hook 的 setter(如setFilters()、setActiveKeys()),不能直接改 DOM - Vue 项目:在
onMounted中执行,用ref拿到组件实例后调用其方法(如chartRef.value.setZoom(zoomLevel)) - 填完状态后,对受控组件必须手动派发事件或触发 re-render,否则校验、联动逻辑不生效
beforeunload 只能提示,不能存最后一版
这个钩子执行窗口极短(约 50ms),且只允许同步返回字符串。它唯一可靠用途是判断是否该弹出浏览器默认提示:
- 定义全局变量
let hasUnsavedState = false - 每次 UI 状态变更时设为
true,每次成功保存后设为false -
beforeunload回调里只写:if (hasUnsavedState) return ""(现代浏览器忽略返回值,只显示统一提示) - 真正的保存动作必须在防抖函数里完成,不能拖到
beforeunload里 —— 任何await、fetch、封装函数调用都会失效
仪表盘草稿最难的不是存,而是“状态建模”:你得清楚哪些 UI 行为会产生可序列化的状态,哪些只是瞬时视觉反馈(比如 hover 高亮)。漏掉一个折叠面板的 key,用户刷新后就得重新点五次才找回原来布局。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










