通用方法

本小节,分享前端项目的常用方法。

1. 缓存配置

友情提示:

该小节,基于 《vue element plus admin —— 项目配置「缓存配置 」》 的内容修改。

1.1 说明

在项目中,你可以看到很多地方都使用了 wsCache.set 或者 wsCache.get,这是基于 web-storage-cache 进行封装,采用 hook 的形式。

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

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

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

注意:

更改完默认存储方式后,需要清除浏览器缓存并重新登录,以免造成不可描述的问题。

1.2 示例

wsCache 示例

2. message 对象

2.1 说明

message 对象,由 src/hooks/web/useMessage.ts 实现,基于 ElMessage、ElMessageBox、ElNotification 封装,用于做消息提示、通知提示、对话框提醒、二次确认等。

2.2 示例

message 示例

3. download 对象

3.1 说明

$download 对象,由 util/download.ts 实现,用于 Excel、Word、Zip、HTML 等类型的文件下载。

3.2 示例

download 示例

📄 来源: https://doc.iocoder.cn/vue3/util/🕒 爬取时间: 2025-09-26 15:04:05