新一代状态管理工具,Pinia.js 上手指南
本文为转载文前言 Pinia.js 是新一代的状态管理器,由 Vue.js团队中成员所开发的,因此也被认为是下一代的 Vuex,即 Vuex5.x,在 Vue3.0 的项目中使用也是备受推崇。
作者:小学生study
链接: https://juejin.cn/post/704919...
Pinia.js 有如下特点:
- 完整的 typescript 的支持;
- 足够轻量,压缩后的体积只有1.6kb;
- 去除 mutations,只有 state,getters,actions(这是我最喜欢的一个特点);
- actions 支持同步和异步;
- 没有模块嵌套,只有 store 的概念,store 之间可以自由使用,更好的代码分割;
- 无需手动添加 store,store 一旦创建便会自动添加;
npm install pinia --save
复制代码
创建 Store 新建 src/store 目录并在其下面创建 index.ts,导出 store
// src/store/index.tsimport { createPinia } from 'pinia'const store = createPinia()export default store
复制代码
在 main.ts 中引入并使用。
// src/main.tsimport { createApp } from 'vue'
import App from './App.vue'
import store from './store'const app = createApp(App)
app.use(store)
复制代码
State 定义State 【新一代状态管理工具,Pinia.js 上手指南】在 src/store 下面创建一个user.ts
//src/store/user.tsimport { defineStore } from 'pinia'export const useUserStore = defineStore({
id: 'user',
state: () => {
return {
name: '张三'
}
}
})复制代码
获取 state
{{ userStore.name }}
复制代码
也可以结合 computed 获取。
const name = computed(() => userStore.name)
复制代码
state 也可以使用解构,但使用解构会使其失去响应式,这时候可以用 pinia 的 storeToRefs。
import { storeToRefs } from 'pinia'
const { name } = storeToRefs(userStore)
复制代码
修改 state 可以像下面这样直接修改 state
userStore.name = '李四'
复制代码
但一般不建议这么做,建议通过 actions 去修改 state,action 里可以直接通过 this 访问。
export const useUserStore = defineStore({
id: 'user',
state: () => {
return {
name: '张三'
}
},
actions() {
updateName(name) {
this.name = name
}
}
})
复制代码
复制代码
Getters
export const useUserStore = defineStore({
id: 'user',
state: () => {
return {
name: '张三'
}
},
getters: {
fullName: (state) => {
return state.name + '丰'
}
}
})
复制代码
userStore.fullName // 张三丰
复制代码
Actions 异步 action action 可以像写一个简单的函数一样支持 async/await 的语法,让你愉快的应付异步处理的场景。
export const useUserStore = defineStore({
id: 'user',
actions() {
async login(account, pwd) {
const { data } = await api.login(account, pwd)
return data
}
}
})
复制代码
action 间相互调用 action 间的相互调用直接用 this 访问即可。
export const useUserStore = defineStore({
id: 'user',
actions() {
async login(account, pwd) {
const { data } = await api.login(account, pwd)
this.setData(data) // 调用另一个 action 的方法
return data
},
setData(data) {
console.log(data)
}
}
})
复制代码
在 action 里调用其他 store 里的 action 也比较简单,引入对应的 store 后即可方法其 action 的方法了。
// src/store/user.tsimport { useAppStore } from './app'
export const useUserStore = defineStore({
id: 'user',
actions() {
async login(account, pwd) {
const { data } = await api.login(account, pwd)
const appStore = useAppStore()
appStore.setData(data) // 调用 app store 里的 action 方法
return data
}
}
})
复制代码
// src/store/app.tsexport const useAppStore = defineStore({
id: 'app',
actions() {
setData(data) {
console.log(data)
}
}
})
复制代码
数据持久化 插件 pinia-plugin-persist 可以辅助实现数据持久化功能。
安装
npm i pinia-plugin-persist --save
复制代码
使用
// src/store/index.tsimport { createPinia } from 'pinia'
import piniaPluginPersist from 'pinia-plugin-persist'const store = createPinia()
store.use(piniaPluginPersist)export default store
复制代码
接着在对应的 store 里开启 persist 即可。
export const useUserStore = defineStore({
id: 'user',state: () => {
return {
name: '张三'
}
},// 开启数据缓存
persist: {
enabled: true
}
})
复制代码
文章图片
数据默认存在 sessionStorage 里,并且会以 store 的 id 作为 key。
自定义 key 你也可以在 strategies 里自定义 key 值,并将存放位置由 sessionStorage 改为 localStorage。
persist: {
enabled: true,
strategies: [
{
key: 'my_user',
storage: localStorage,
}
]
}
复制代码
文章图片
持久化部分 state 默认所有 state 都会进行缓存,你可以通过 paths 指定要持久化的字段,其他的则不会进行持久化。
state: () => {
return {
name: '张三',
age: 18,
gender: '男'
}
},persist: {
enabled: true,
strategies: [
{
storage: localStorage,
paths: ['name', 'age']
}
]
}
复制代码
上面我们只持久化 name 和 age,并将其改为localStorage, 而 gender 不会被持久化,如果其状态发送更改,页面刷新时将会丢失,重新回到初始状态,而 name 和 age 则不会。
感谢 本次分享到这里就结束了,感谢您的阅读,如果本文对您有什么帮助,别忘了动动手指点个赞??。
本文如果有什么错误或不足,欢迎评论区指正!
结语 我是林三心,一个热心的前端菜鸟程序员。如果你上进,喜欢前端,想学习前端,那咱们可以交朋友,一起摸鱼哈哈,摸鱼群,加我请备注【思否】
文章图片
推荐阅读
- 最有效的时间管理工具(赢效率手册和总结笔记)
- 停下“忙乱”的状态
- Java基础-高级特性-枚举实现状态机
- 老年状态
- Android超简单实现沉浸式状态栏
- 生活最好的状态
- 2019-09-08
- VueX(Vuex|VueX(Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式)
- 新一代Python包管理工具
- 不焦虑