今天我们再来实战下官方推荐的新的vue状态管理工具Pinia。
pinia 由 vue 团队中成员所开发的，因此也被认为是下一代的 vuex，即 vuex5.x，在 vue3 的项目中使用也是备受推崇。所以 pinia 的学习迫在眉睫。
下面我们正式开始pinia的学习吧。
yarn add pinia // or npm install pinia
创建一个 pinia 并传递给 vue 应用。
在这一步我们可以发现，我们只需要简单创建一个pinia对象传给vue实例就可以自动收集我们后续创建的新store。并不需要像vuex一样把各个模块聚集在根store里面传递给vue实例。总体来说使用更加简单。
import { createPinia } from 'pinia'
import { createApp } from 'vue'
import App from './app.vue'
createApp(App).use(createPinia()).mount('#app')与vuex不同，pinia没有了根store和modules的概念。在pinia中一个store一个文件，一个store里面包含state、getters、actions三部分。总体来说更简单更清晰。
需要使用defineStore来创建store。
注意第一个参数一定要唯一
import { defineStore } from "pinia";
export const mainStore = defineStore("main", {
state: () => {
return {
name: "randy man",
age: 24,
};
},
getters: {
getterName(state) {
return state.name.toUpperCase() + "-----" + state.age;
},
// 这种方式也可以，不过需要自己手动指定返回值类型
getterAge(): number {
return this.age;
},
},
actions: {
// 直接使用this修改state
changeName(payload: string) {
this.name = payload;
return "success";
},
// 异步action
async fetchData(payload: number) {
const response = await fetch(
`https://jsonplaceholder.typicode.com/todos/${payload}`
);
const res = response.json();
// 调用其他action
// this.changeName("xxx");
return res;
},
},
});下面我们详细介绍下第二个参数。
state就是状态，和vuex一样，就不过多介绍了。只需要注意他是一个方法，返回一个state对象。
state: () => {
return {
name: "randy man",
age: 24,
};
},
getters是计算属性，和vuex中是一样的。但是需要知道它支持两种写法。
通过this修改state的方式需要自己手动指定返回值类型。
getters: {
getterName(state) {
return state.name.toUpperCase() + "-----" + state.age;
},
// 这种方式也可以，不过需要自己手动指定返回值类型
getterAge(): number {
return this.age;
},
},在pinia中没有了mutations，所以同步和异步操作都在action中进行。
并且在pinia中是支持直接调用别的action，或者别的模块的action。
actions: {
// 直接使用this修改state
changeName(payload: string) {
this.name = payload;
return "success";
},
// 异步action
async fetchData(payload: number) {
const response = await fetch(
`https://jsonplaceholder.typicode.com/todos/${payload}`
);
const res = response.json();
// 调用其他action
// this.changeName("xxx");
return res;
},
},在 action 里调用其他 store 里的 action 也比较简单，引入对应的 store 后即可访问其内部的方法了，跟在vue组件中使用是一样的。
// user.ts
import { 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
}
}
})在vue组件中使用也很简单，需要使用哪个store引入哪个store就可以啦。
<template>
<div>
<div>name: {{ name }}</div>
<div>getterName: {{ getterName }}</div>
<div>
<button @click="updateMainName">修改main name</button>
</div>
</div>
</template>
<script lang="ts">
import { defineComponent, computed } from "vue";
import { mainStore } from "@/pinia/main";
import { storeToRefs } from "pinia";
export default defineComponent({
name: "PiniaView",
setup() {
const store = mainStore();
const updateMainName = async () => {
// 直接修改 不建议
// store.name = "demi woman";
// 对象形式修改
// store.$patch({ name: "demi woman" });
// 函数形式修改
// store.$patch((state) => {
// state.name = "demi woman";
// });
// 通过action修改
const result = store.changeName("demi woman");
console.log(result);
// 返回的值不会被Promise包裹
const result2 = await store.fetchData(1);
console.log(result2);
};
// 直接解构不能响应式
// const { name, getterName } = store;
// 这样响应式
const name = computed(() => store.name);
const getterName = computed(() => store.getterName);
// 这样也能响应式
// const { name, getterName } = storeToRefs(store);
return {
name,
getterName,
updateMainName,
};
},
});
</script>跟vuex相比，使用pinia不需要定义state类型，不用定义key就能得到TypeScript的优势。
可以看到我们使用store的时候，它的所有属性和方法state、getters、actions等都会自动提示出来，并且当我们使用了不存在的属性在编码期间会直接报错。
获取state的方式有三种，但是需要注意通过直接解构的方式数据是不会响应式的。如果需要响应式需要使用computed或storeToRefs
import { storeToRefs } from "pinia";
const store = mainStore();
// 直接解构不能响应式
// const { name } = store;
// 这样响应式
const name = computed(() => store.name);
// 这样也能响应式
// const { name } = storeToRefs(store);获取getters的方式也有三种，但是需要注意通过直接解构的方式数据是不会响应式的。如果需要响应式需要使用computed或storeToRefs
import { storeToRefs } from "pinia";
const store = mainStore();
// 直接解构不能响应式
// const { getterName } = store;
// 这样响应式
const getterName = computed(() => store.getterName);
// 这样也能响应式
// const { getterName } = storeToRefs(store);
修改state的方式也有很多种，可以直接修改、还可以使用$patch来传递对象或方法来修改、还可以通过action修改。
const updateMainName = async () => {
// 直接修改 不建议
// store.name = "demi woman";
// 对象形式修改
// store.$patch({ name: "demi woman" });
// 函数形式修改
// store.$patch((state) => {
// state.name = "demi woman";
// });
// 通过action修改
const result = store.changeName("demi woman");
// action 返回啥就是啥 result等于'success'
};
虽然修改方式很多，但是还是在实际开发中推荐使用action来修改state。
使用action的时候还有一点需要注意。我们知道在vuex中，action如果有返回值是会被Promise包裹resolve出来，也就是会返回一个Promise对象。但是在pinia中，action返回啥就是啥不会被Promise包裹resolve出来。
我们知道，vuex和pinia本质上都是对象，都是临时存储，当页面刷新数据都会丢失。
想要刷新不丢失就需要我们手动存储在localStorage或sessionStorage里面。如果不想手动处理，我们也可以使用插件。
vuex使用vuex-persistedstate
pinia使用pinia-plugin-persistedstate
具体怎么使用笔者就不再赘述了大家可以自行查看文档，原理都是一样的，通过配置将指定数据存储到localStorage或sessionStorage里面实现数据持久化。
pinia有完整的 typescript 的支持。不再像使用vuex需要定义key、定义state类型那么麻烦。1.6kb。mutations，只有 state，getters，actions。跟react-redux类似，同步异步都在action里面进行。根简单清晰。store 的概念，store 之间可以自由使用，更好的代码分割。更简单易懂。store，store 一旦创建便会自动添加，我们只需要在vue组件直接引用需要的store使用即可。
