通用方法

## 1. 缓存配置
<span style="font-family:楷体">友情提示：
> 该小节，基于 [《vue element plus admin —— 项目配置「缓存配置 」》](https://element-plus-admin-doc.cn/guide/settings.html "《vue element plus admin —— 项目配置「缓存配置 」》") 内容修改。</span>

### 1.1 说明
在项目中，你可以看到很多地方都使用了 wsCache.set 或者 wsCache.get，这是基于 web-storage-cache (opens new window)进行封装，采用 hook 的形式。

该插件对HTML5 localStorage 和 sessionStorage 进行了扩展，添加了超时时间，序列化方法。可以直接存储 json 对象，同时可以非常简单的进行超时时间的设置。

本项目默认是采用 sessionStorage 的存储方式，如果更改，可以直接在 useCache.ts (opens new window)中把 type: CacheType = 'sessionStorage' 改为 type: CacheType = 'localStorage'，这样项目中的所有用到的地方，都会变成该方式进行数据存储。

如果只想单个更改，可以传入存储类型 const { wsCache } = useCache('localStorage')，既可只适用当前存储对象。

> <span style="font-family:楷体">#1.1 说明
在项目中，你可以看到很多地方都使用了 wsCache.set 或者 wsCache.get，这是基于 web-storage-cache (opens new window)进行封装，采用 hook 的形式。

该插件对HTML5 localStorage 和 sessionStorage 进行了扩展，添加了超时时间，序列化方法。可以直接存储 json 对象，同时可以非常简单的进行超时时间的设置。

本项目默认是采用 sessionStorage 的存储方式，如果更改，可以直接在 useCache.ts (opens new window)中把 type: CacheType = 'sessionStorage' 改为 type: CacheType = 'localStorage'，这样项目中的所有用到的地方，都会变成该方式进行数据存储。

如果只想单个更改，可以传入存储类型 const { wsCache } = useCache('localStorage')，既可只适用当前存储对象。</span>

### 1.2 示例

## 2. message 对象
### 2.1 说明
message 对象，由 src/hooks/web/useMessage.ts (opens new window)实现，基于 ElMessage、ElMessageBox、ElNotification 封装，用于做消息提示、通知提示、对话框提醒、二次确认等。

### 2.2 示例
![](/media/202409/2024-09-02_112254_549845.png)

3. download 对象
### 3.1 说明
$download 对象，由 util/download.ts实现，用于 Excel、Word、Zip、HTML 等类型的文件下载。

### 3.2 示例

![](/media/202409/2024-09-02_112354_701167.png)