Pinia使用方法及持久化存储
一、简介
Pinia
是 Vue
的专属状态管理库,它允许你跨组件或页面共享状态。它跟 Vuex
有一定的相似度,但还是有很大的区别。
愿意看这篇博客的人,想必已经看过了官方文档,官方文档很详细,包含各种使用情景和理论,因此本文不说理论,只说具体的使用方法,想深入研究的建议去看官方文档,本文适合拿来即用。
Pinia 官方文档
二、使用方法
1. 安装
yarn add pinia
# 或者使用 npm
npm install pinia
2. 引入
main.ts
import { createApp } from 'vue'
import { createPinia } from 'pinia'
import App from './App.vue'const pinia = createPinia()createApp(App).use(pinia).mount('#app') // vue3 的简写语法
不熟悉vue3简写语法的可以按照下面的方式去写,效果是一样的
main.ts
import { createApp } from 'vue'
import { createPinia } from 'pinia'
import App from './App.vue'const pinia = createPinia()
const app = createApp(App)app.use(pinia)
app.mount('#app')
3. 创建文件
在 src
文件中,创建 store
文件,里面按模块创建 ts
文件(也可以是 js
)。
注意: pinia
不需要创建 modules
文件来区分模块化,这是它和 vuex
的区别。
以登录后保存用户信息模块举例:
注意: 命名方式建议统一规范 use + id + store
,示例 useUserStore
,id
为 user
。
store/user.ts
import { defineStore } from 'pinia'export const useUserStore = defineStore('user', {state: () => ({userInfo: {}}),actions: {SetUserInfo(data: any) {this.userInfo = data}}
})
4. 使用
先引入模块,再将引入的模块对象赋值给变量 store
(命名随意),如果不需要修改数据,用 const
声明变量,需要修改数据则使用 let
声明。
注意:引入的模块对象名要与模块中 export const
声明的一致。
.ts or .vue
import { useUserStore } from '@/store/user'const store: any = useUserStore()console.log(store.userInfo)
5. 修改数据
修改数据多种方法,可以直接修改,也可以使用 actions 修改。
方法1:直接修改
.ts or .vue
import { useUserStore } from '@/store/user'const store = useUserStore()store.userInfo = obj // obj 指新值
方法2:借助 actions 修改
.ts or .vue
import { useUserStore } from '@/store/user'const store = useUserStore()store.SetUserInfo(obj) // obj 指新值
方法3:多属性修改
store/user.ts
import { defineStore } from 'pinia'export const useUserStore = defineStore('user', {state: () => ({name: null,age: null,sex: null,}),
})
上面的方法都是用来修改单个属性的,如果你需要一次修改多个属性,虽然你可以重复操作上面的方法,但是 pinia 提供了新的方法,我更推荐使用官方推荐的方法。
.ts or .vue
import { useUserStore } from '@/store/user'const store = useUserStore()// 你可以这样去修改(不建议)
store.name = '张三'
store.age = 24
store.sex = '男'// 推荐使用下面这种方式 √
store.$patch({name: '张三',age: 24,sex: '男',
})
修改数据的场景及方法当然不止这些,有些复杂的数据修改仅靠这些是难以实现的,不过本文的目的是简单讲解 pinia
的使用方法,就不多做赘述了,想具体了解推荐去看 Pinia 官方文档。
三、持久化存储
pinia
和 vuex
一样,数据是短时的,只要一刷新页面,数据就会恢复成初始状态,为了避免这个问题,可以对其采用持久化保存方法。
持久化保存的原理是在 pinia
中数据更新时,同步保存到 localStorage
或 sessionStorage
中,刷新后从本地存储中读取数据,你可以选择自己去写,但是实现起来并不像想象中那么容易,当然,也没那么难。
我推荐使用插件去实现持久化存储,这样更便捷,省时省力。推荐插件为 pinia-plugin-persist,当然,实现持久化存储的插件肯定不止这一种,想用别的也无所谓,本文仅对这款插件讲解使用方法。
1. 安装插件
yarn add pinia-plugin-persist
# 或者使用 npm
npm install pinia-plugin-persist
2. 引入插件
和引入 pinia
一样,在 main.ts
中引入。
mian.ts
import { createApp } from 'vue'
import App from './App.vue'
import { createPinia } from 'pinia'
import piniaPersist from 'pinia-plugin-persist'const pinia = createPinia()
pinia.use(piniaPersist)createApp(App).use(pinia).mount('#app')
3. 使用插件
方式1:默认保存
下面这种写法会将当前模块中的所有数据都进行持久化保存,默认保存在 sessionStorage
中, key
为模块 id
,刷新页面不需要手动读取数据,插件会自动读取。
store/user.ts
import { defineStore } from 'pinia'export const useUserStore = defineStore('user', {state: () => ({name: null,age: null,sex: null,}),persist: {enabled: true // true 表示开启持久化保存}
})
方式2:设置 key 、指定保存内容
你可以主动设置 key
名,也可以指定哪些数据保存,默认会保存当前模块全部数据。
store/user.ts
export const useUserStore = defineStore('storeUser', {state: () => ({name: null,age: null,sex: null,}),persist: {enabled: true,strategies: [{key: 'user',storage: localStorage,paths: ['name'] },],},
})
你甚至可以对不同数据设置不同的本地存储方式。
store/user.ts
export const useUserStore = defineStore('storeUser', {state: () => ({name: null,age: null,sex: null,}),persist: {enabled: true,strategies: [{ storage: sessionStorage, paths: ['name'] },{ storage: localStorage, paths: ['age'] },],},
})
方式3:保存到 cookie
保存到 cookie
中当然也是可以的,不过需要手动添加 cookie
的保存方式,同样,此处也是推荐使用插件 js-cookie 来完成。
npm install js-cookie
store/user.ts
import Cookies from 'js-cookie'const cookiesStorage: Storage = {setItem (key, state) {return Cookies.set(key, state.accessToken, { expires: 3 }) // 设置有效期 3 天,不设置默认同 sessionStorage 有效期一致},getItem (key) {return JSON.stringify({accessToken: Cookies.getJSON(key),})},
}export const useUserStore = defineStore('storeUser', {state: () => ({name: null,age: null,sex: null,accessToken: 'xxxxxxxxx',}),persist: {enabled: true,strategies: [{storage: cookiesStorage,paths: ['accessToken'] // cookie 一般用来保存 token},],},
})
文章到此就结束了,如果有需要作者补充或修正的,欢迎在评论区留言。
END