Vue / 系统课时

创建应用状态

创建应用状态

管理后台的侧栏、设备类型、主题和界面密度会同时影响多个页面。把这些值集中到 Pinia 应用状态中,可以避免组件层层传参,并让布局行为拥有统一的修改入口。

学习目标

  • 判断哪些界面信息应该进入全局应用状态
  • 使用 Pinia 定义带类型约束的状态与操作
  • 在布局组件中读取、修改并验证状态

先划定应用状态边界

应用状态适合保存“跨页面共享、刷新前持续存在、由多个组件共同使用”的界面信息。侧栏折叠状态会同时影响导航区和内容区,主题模式会影响整站样式,设备类型会决定布局分支,这些都应由同一个 Store 管理。

页面表单输入、弹窗临时开关和某个列表的筛选条件通常只服务当前页面,优先保留在组件内部。不要因为 Pinia 使用方便,就把所有 ref 都迁入全局状态。

状态 推荐类型 主要使用者
sidebarCollapsed boolean 侧栏、顶部栏、内容布局
device 'desktop' | 'mobile' 响应式布局、抽屉导航
themeMode 'light' | 'dark' 根节点、设置面板
density 'default' | 'compact' 表格、表单、菜单

应用状态在布局组件间的共享关系

建立应用 Store

下面的 Store 使用选项式写法,把状态定义和修改动作放在同一模块。联合类型可以阻止组件写入未约定的主题或密度值。

ts
// src/stores/modules/app.ts
import { defineStore } from 'pinia'

export type DeviceType = 'desktop' | 'mobile'
export type ThemeMode = 'light' | 'dark'
export type UiDensity = 'default' | 'compact'

interface AppState {
  sidebarCollapsed: boolean
  device: DeviceType
  themeMode: ThemeMode
  density: UiDensity
}

const initialState = (): AppState => ({
  sidebarCollapsed: false,
  device: 'desktop',
  themeMode: 'light',
  density: 'default'
})

export const useAppStore = defineStore('app', {
  state: initialState,
  actions: {
    toggleSidebar() {
      this.sidebarCollapsed = !this.sidebarCollapsed
    },
    setDevice(device: DeviceType) {
      this.device = device
      // 移动端默认收起侧栏,避免遮挡主体内容
      if (device === 'mobile') {
        this.sidebarCollapsed = true
      }
    },
    setThemeMode(mode: ThemeMode) {
      this.themeMode = mode
    },
    setDensity(density: UiDensity) {
      this.density = density
    },
    reset() {
      this.$patch(initialState())
    }
  }
})

该文件依赖项目已经安装并在应用入口注册 Pinia。Store 创建后不会主动判断设备类型,窗口监听器或布局组件应通过 setDevice 写入结果,避免在多个组件中重复实现判断规则。

在布局组件中消费状态

storeToRefs 会把响应式状态转换为可解构的引用;Action 仍然直接从 Store 调用。下面的组件可作为最小验证页。

vue
<script setup lang="ts">
import { storeToRefs } from 'pinia'
import { useAppStore } from '@/stores/modules/app'

const appStore = useAppStore()
const { sidebarCollapsed, device, themeMode, density } = storeToRefs(appStore)

function applyMobileMode() {
  appStore.setDevice('mobile')
  appStore.setDensity('compact')
}
</script>

<template>
  <section>
    <p>侧栏:{{ sidebarCollapsed ? '已折叠' : '已展开' }}</p>
    <p>设备:{{ device }}</p>
    <p>主题:{{ themeMode }}</p>
    <p>密度:{{ density }}</p>
    <button type="button" @click="appStore.toggleSidebar()">切换侧栏</button>
    <button type="button" @click="applyMobileMode">模拟移动端</button>
  </section>
</template>

预期结果

text
首次进入:侧栏为“已展开”,设备为 desktop,主题为 light,密度为 default。
点击“切换侧栏”:侧栏文字在“已展开”和“已折叠”之间切换。
点击“模拟移动端”:设备变为 mobile,侧栏变为“已折叠”,密度变为 compact。

避免重复状态与越权修改

不要同时保存 device 和 isMobile,后者可以由前者派生,否则两者可能出现矛盾。组件也不应直接散落地修改多个字段;把有业务含义的组合变化封装为 Action,才能保证移动端切换、重置和后续持久化遵循同一规则。

调试时可在 Vue Devtools 的 Pinia 面板观察字段变化。若点击按钮后界面不更新,优先检查是否遗漏 Pinia 注册、是否错误解构了 Store 状态,以及路径别名是否指向正确文件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建应用状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通