import { ref, watch } from 'vue'
|
|
/**
|
* 折叠状态这类**纯视图偏好**的读写。
|
*
|
* 为什么不存到数据库:点一下折叠就发一个写请求,既没必要也容易失败
|
* (网络抖一下折叠状态就和眼睛看到的不一致了)。这类状态属于「这台机器的
|
* 这个浏览器窗口」,放 localStorage 正好,刷新后仍然保持。
|
*
|
* key 里会带上用户 id:同一台机器上换账号登录时,两个用户的分组折叠状态
|
* 不该互相影响。
|
*/
|
|
const PREFIX = 'webui_ui_'
|
|
function storageKey(key) {
|
// 从 localStorage 里已保存的用户信息取 id 做后缀。
|
// 不 import authStore:那会形成 utils → store 的反向依赖,
|
// 而这里只需要一个稳定的标识符。
|
let who = 'anon'
|
try {
|
const raw = localStorage.getItem('webui_user')
|
if (raw) {
|
const user = JSON.parse(raw)
|
who = user?.id ?? user?.username ?? 'anon'
|
}
|
} catch {
|
// 解析失败就用 anon,不影响功能
|
}
|
return `${PREFIX}${who}_${key}`
|
}
|
|
/**
|
* 一个会持久化到 localStorage 的布尔开关。
|
*
|
* @param {string} key 状态名(会自动加上用户前缀)
|
* @param {boolean} defaultValue 没有存过时的默认值
|
* @returns {{ collapsed: import('vue').Ref<boolean>, toggle: Function, set: Function }}
|
*/
|
export function usePersistentFlag(key, defaultValue = false) {
|
const storage = storageKey(key)
|
let initial = defaultValue
|
try {
|
const raw = localStorage.getItem(storage)
|
if (raw === '1') initial = true
|
else if (raw === '0') initial = false
|
} catch {
|
// 隐私模式下 localStorage 可能不可用,退回默认值即可
|
}
|
|
const state = ref(initial)
|
watch(state, (value) => {
|
try {
|
localStorage.setItem(storage, value ? '1' : '0')
|
} catch {
|
// 存不进去不影响使用,只是刷新后不记得
|
}
|
})
|
|
return {
|
// 字段名就叫 collapsed:之前这里叫 value,调用方按 `{ collapsed }` 解构,
|
// 拿到的是 undefined,导致「折叠了但界面没反应」——
|
// 名字必须和它的语义一致,别让人猜。
|
collapsed: state,
|
toggle: () => { state.value = !state.value },
|
set: (v) => { state.value = !!v }
|
}
|
}
|
|
/**
|
* 一组「分组各自的折叠状态」,同样持久化。
|
*
|
* 存的是一张 map:{ [groupId]: true/false },
|
* 默认展开 —— 收藏起来的对话列表默认收起会让人以为分组是空的。
|
*/
|
export function usePersistentMap(key) {
|
const storage = storageKey(key)
|
let initial = {}
|
try {
|
const raw = localStorage.getItem(storage)
|
if (raw) initial = JSON.parse(raw) || {}
|
} catch {
|
initial = {}
|
}
|
|
const state = ref(initial)
|
watch(state, (value) => {
|
try {
|
localStorage.setItem(storage, JSON.stringify(value))
|
} catch {
|
// 同上,静默忽略
|
}
|
}, { deep: true })
|
|
return {
|
/**
|
* 默认**展开**:只有显式存过 true 才算收起。
|
*
|
* 这里踩过一次自己的坑:一开始把「收起」定义为存 false,
|
* 而 toggle 写成 `!(next[id] === false)` —— 缺省值 undefined 会让它算出 true,
|
* 也就是「第一次点击反而写入了展开状态」,结果折叠永远不生效。
|
* 判定与写入必须严格互逆:存 true = 收起,缺省 = 展开。
|
*/
|
isCollapsed: (id) => state.value[id] === true,
|
toggle(id) {
|
const next = { ...state.value }
|
next[id] = !(next[id] === true)
|
state.value = next
|
}
|
}
|
}
|