FIELD_CONFIG_CACHE_README.md 2.2 KB

字段配置本地缓存功能说明

功能概述

本功能为职位详情页面的字段显示配置提供了本地缓存支持,用户可以在页面刷新或重新访问时保持之前的配置设置。

主要特性

1. 自动缓存

  • 当用户修改字段配置时,系统会自动在1秒后保存到本地缓存
  • 使用防抖机制,避免频繁保存操作
  • 缓存有效期:7天

2. 手动缓存操作

  • 保存到本地:手动将当前配置保存到本地缓存
  • 清除缓存:清除本地存储的配置缓存

3. 智能加载

  • 页面初始化时优先从本地缓存读取配置
  • 如果没有缓存或缓存已过期,则使用默认配置
  • 支持按职位ID区分不同职位的配置

使用方法

基本操作

  1. 在字段配置面板中调整各个字段的显示/隐藏状态
  2. 系统会自动保存配置到本地缓存
  3. 也可以点击"保存到本地"按钮手动保存

缓存管理

  • 点击"保存到本地":立即保存当前配置
  • 点击"清除缓存":清除本地存储的配置

技术实现

缓存键值

const FIELD_CONFIG_CACHE_KEY = 'position_field_config_cache';

缓存数据结构

{
  positionId: "职位ID",
  config: "字段配置对象",
  timestamp: "保存时间戳"
}

主要函数

  • saveFieldConfigToCache(config, positionId): 保存配置到缓存
  • loadFieldConfigFromCache(positionId): 从缓存读取配置
  • clearFieldConfigCache(): 清除缓存
  • handleSaveFieldConfigToCache(): 手动保存缓存

注意事项

  1. 浏览器兼容性:使用localStorage,需要现代浏览器支持
  2. 存储限制:localStorage有存储大小限制(通常5-10MB)
  3. 隐私模式:在隐私模式下可能无法正常使用
  4. 数据安全:缓存数据仅存储在本地,不会上传到服务器

错误处理

  • 缓存操作失败时会显示相应的错误提示
  • 控制台会输出详细的错误日志
  • 即使缓存失败,也不会影响正常的字段配置功能

扩展功能

未来可以考虑添加的功能:

  • 配置导入/导出
  • 多职位配置管理
  • 云端配置同步
  • 配置版本管理