自动保存与草稿机制
自动保存与草稿机制
编辑器自动保存
轻笺的笔记编辑器采用异步自动保存机制,确保编辑内容不丢失。
保存触发条件
- 内容变更后自动保存:编辑器内容变化后,前端通过
saveData事件通知父组件,父组件调用后端 API 异步写入数据库 - 保存频率:编辑暂停后约 3 秒内触发保存,连续输入时不会频繁请求
- 页面关闭前保存:切换页面或关闭标签页前,会触发最后一次保存请求
- 手动保存:支持 Ctrl+S(Cmd+S)快捷键强制保存
保存流程
编辑器内容变化 → 防抖等待(约3秒) → POST /note/updateNote → 数据库写入 → 状态栏显示"已保存"
保存状态指示
编辑器顶部状态栏实时显示保存状态:
- 未编辑:无指示
- 保存中…:正在写入云端
- 已保存:写入成功
- 保存失败:网络异常时提示,内容保留在编辑器中不丢失
草稿保护机制
本地草稿保留
当网络请求失败或保存异常时:
- 编辑器的内容不会因为保存失败而丢失
- 编辑器保持在可编辑状态,用户可以继续编辑
- 网络恢复后自动重试保存
模式切换备份
笔记在 HTML 和 Markdown 模式之间切换时:
- 切换前自动备份当前内容到
switchBackup状态 - 切换后有撤回按钮可还原到切换前的内容和模式
- 撤回同样需要确认,防止误操作
注意事项
- 自动保存是异步的,极短时间内关闭页面可能导致最后一次修改未保存
- 重要内容建议手动 Ctrl+S 确认保存后再离开
- 网络不稳定时保存可能延迟,但内容不会丢失
- 自动保存不生成版本历史,每次保存覆盖上一次内容