Vue / 系统课时

使用派生状态

使用派生状态

组件经常需要根据角色、权限和界面状态计算布尔值或集合。把这些计算集中到 Pinia Getter,可以保留单一数据源,减少模板中的重复表达式,并让判断规则更容易测试和修改。

学习目标

  • 区分原始状态与派生状态
  • 使用 Getter 封装角色、权限和布局判断
  • 正确消费返回值与返回函数两类 Getter

识别应该派生的数据

原始状态记录事实,例如当前角色列表、权限编码列表、设备类型和界面密度。是否管理员、能否新增用户、是否采用紧凑布局 都可以由这些事实计算,不应再保存成可独立修改的字段。

派生状态不增加新的事实,只提供稳定的读取接口。当角色或权限变化时,Getter 会重新计算,组件无需手动同步多个布尔值。

Pinia Getter 的派生数据流

定义角色与权限 Getter

下面的 Store 同时展示普通 Getter、集合 Getter 和“返回函数”的参数化 Getter。can 适合在模板中按权限编码执行判断。

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

type DeviceType = 'desktop' | 'mobile'
type UiDensity = 'default' | 'compact'

interface AccessState {
  roles: string[]
  permissions: string[]
  device: DeviceType
  density: UiDensity
}

export const useAccessStore = defineStore('access', {
  state: (): AccessState => ({
    roles: [],
    permissions: [],
    device: 'desktop',
    density: 'default'
  }),
  getters: {
    isAdmin: (state): boolean => state.roles.includes('admin'),
    permissionSet: (state): ReadonlySet<string> =>
      new Set(state.permissions),
    isCompactLayout: (state): boolean =>
      state.device === 'mobile' || state.density === 'compact',
    can(): (permission: string) => boolean {
      // 管理员直接放行,普通用户再检查权限集合
      return (permission) =>
        this.isAdmin || this.permissionSet.has(permission)
    }
  },
  actions: {
    setAccess(roles: string[], permissions: string[]) {
      this.roles = [...roles]
      this.permissions = [...permissions]
    },
    setInterface(device: DeviceType, density: UiDensity) {
      this.device = device
      this.density = density
    }
  }
})

permissionSet 适合频繁执行成员判断;对外暴露只读集合,可以避免组件把派生结果当作原始状态修改。can 使用其他 Getter,因此显式声明返回类型,避免 TypeScript 在 this 推导时丢失类型信息。

在组件中读取 Getter

普通 Getter 可以通过 storeToRefs 解构并保持响应性。参数化 Getter 本质上是函数,直接通过 Store 调用更清楚。

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

const accessStore = useAccessStore()
const { isAdmin, isCompactLayout } = storeToRefs(accessStore)

accessStore.setAccess(
  ['editor'],
  ['dashboard:view', 'user:create']
)
accessStore.setInterface('desktop', 'compact')
</script>

<template>
  <section :class="{ compact: isCompactLayout }">
    <p>管理员:{{ isAdmin ? '是' : '否' }}</p>
    <button
      type="button"
      :disabled="!accessStore.can('user:create')"
    >
      新增用户
    </button>
    <button
      type="button"
      :disabled="!accessStore.can('user:delete')"
    >
      删除用户
    </button>
  </section>
</template>

预期结果

text
“管理员”显示为“否”。
“新增用户”按钮可用,因为权限列表包含 user:create。
“删除用户”按钮禁用,因为当前用户既不是管理员,也没有 user:delete。
容器获得 compact 类,因为界面密度为 compact。

处理缓存与参数边界

不带参数的 Getter 会像计算属性一样缓存,只有依赖状态变化时才重新计算。返回函数的 Getter 可接收参数,但函数调用结果不会针对每个参数单独缓存,因此不要在其中执行排序、大量遍历或网络请求。

权限编码应保持统一格式,并由后端返回或项目常量集中定义。Getter 只负责同步计算,不应修改状态;需要更新角色、权限或界面设置时,应调用 Action。

常见错误

直接写 const { isAdmin } = accessStore 会破坏解构后的响应性,应改用 storeToRefs。另一个常见问题是把 canCreateUser、canDeleteUser 等大量布尔值写入 State,这会造成权限变化后同步困难;参数化 Getter 更适合表达同一类规则。

当 Getter 结果与预期不一致时,先检查原始数组内容和编码大小写,再检查管理员放行规则。不要在组件中增加第二套判断去“修正”Getter,否则规则会再次分散。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用派生状态

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

登录哪都通