组合式函数 useUnreadBadge 封装标签页未读徽标统计逻辑,支持多消息源监听、自动聚合、响应式更新及手动清零,不依赖 UI,可复用于首页、通知页等场景,并兼容 TypeScript 类型定义与真实数据源对接。

用组合式函数实现标签页未读消息徽标统计,核心是把“监听多个消息源、聚合未读数、响应式更新、支持手动清零”这几件事封装成可复用逻辑。它不依赖 UI 组件,只管状态和行为,适合在多个标签页(如首页、通知页、私信页)中统一管理。
定义 useUnreadBadge 组合式函数
新建 composables/useUnreadBadge.js(或 .ts),返回一个含未读总数、各来源明细、清空方法的对象:
- 用 ref 管理总未读数(
total)和各模块未读数(如notice: ref(0),message: ref(0)) - 用 computed 自动求和,保证响应性:
const total = computed(() => notice.value + message.value + ...) - 提供
clearAll()和clear(module)方法,内部直接修改对应 ref - 可选:支持外部传入初始值或监听后端推送(如通过 eventBus 或 WebSocket)
在组件中使用并绑定到标签页
比如在 Layout.vue 或导航栏组件里:
- 调用
const { total, notice, message, clearAll } = useUnreadBadge() - 模板中给通知标签加徽标:
通知 - 点击标签页时自动清空对应模块:
@click="clear('notice')"
对接真实数据源(如 API 或事件)
组合式函数内部可扩展异步能力:
- 接收一个
fetchUnreads函数作为参数,在onMounted中拉取初始数据 - 监听 WebSocket 消息:
socket.on('new-message', () => message.value++),记得在onUnmounted中取消监听 - 若用 Pinia,可在此函数中读取 store 的 unreadCount,但建议保持组合式函数轻量——仅做聚合与触发,数据获取交给 store 或父组件
类型安全与维护提示
如果是 TypeScript 项目,推荐定义接口明确结构:
interface UnreadCounts { notice: number; message: number; task?: number }function useUnreadBadge(initial?: Partial): { total: Ref ; counts: Reactive ; clear: (key: keyof UnreadCounts) => void; clearAll: () => void } - 避免返回
reactive({}),改用reactive包裹对象 +toRefs解构,或直接返回多个ref,确保解构后仍响应
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










