Vue / 系统课时
使用派生状态
使用派生状态
组件经常需要根据角色、权限和界面状态计算布尔值或集合。把这些计算集中到 Pinia Getter,可以保留单一数据源,减少模板中的重复表达式,并让判断规则更容易测试和修改。
学习目标
- 区分原始状态与派生状态
- 使用 Getter 封装角色、权限和布局判断
- 正确消费返回值与返回函数两类 Getter
识别应该派生的数据
原始状态记录事实,例如当前角色列表、权限编码列表、设备类型和界面密度。是否管理员、能否新增用户、是否采用紧凑布局 都可以由这些事实计算,不应再保存成可独立修改的字段。
派生状态不增加新的事实,只提供稳定的读取接口。当角色或权限变化时,Getter 会重新计算,组件无需手动同步多个布尔值。

定义角色与权限 Getter
下面的 Store 同时展示普通 Getter、集合 Getter 和“返回函数”的参数化 Getter。can 适合在模板中按权限编码执行判断。
// 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 调用更清楚。
<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>预期结果
“管理员”显示为“否”。
“新增用户”按钮可用,因为权限列表包含 user:create。
“删除用户”按钮禁用,因为当前用户既不是管理员,也没有 user:delete。
容器获得 compact 类,因为界面密度为 compact。处理缓存与参数边界
不带参数的 Getter 会像计算属性一样缓存,只有依赖状态变化时才重新计算。返回函数的 Getter 可接收参数,但函数调用结果不会针对每个参数单独缓存,因此不要在其中执行排序、大量遍历或网络请求。
权限编码应保持统一格式,并由后端返回或项目常量集中定义。Getter 只负责同步计算,不应修改状态;需要更新角色、权限或界面设置时,应调用 Action。
常见错误
直接写 const { isAdmin } = accessStore 会破坏解构后的响应性,应改用 storeToRefs。另一个常见问题是把 canCreateUser、canDeleteUser 等大量布尔值写入 State,这会造成权限变化后同步困难;参数化 Getter 更适合表达同一类规则。
当 Getter 结果与预期不一致时,先检查原始数组内容和编码大小写,再检查管理员放行规则。不要在组件中增加第二套判断去“修正”Getter,否则规则会再次分散。