亲宝软件园·资讯

展开

TypeScript Pinia

​ 苏苏同学   ​ 人气:0

简介

今天我们再来实战下官方推荐的新的vue状态管理工具Pinia

pinia 由 vue 团队中成员所开发的,因此也被认为是下一代的 vuex,即 vuex5.x,在 vue3 的项目中使用也是备受推崇。所以 pinia 的学习迫在眉睫。

下面我们正式开始pinia的学习吧。

安装

yarn add pinia
// or 
npm install pinia

创建pinia并传递给vue实例

创建一个 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')

创建store

vuex不同,pinia没有了根storemodules的概念。在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

state就是状态,和vuex一样,就不过多介绍了。只需要注意他是一个方法,返回一个state对象。

state: () => {
  return {
    name: "randy man",
    age: 24,
  };
},

getters

getters是计算属性,和vuex中是一样的。但是需要知道它支持两种写法。

通过this修改state的方式需要自己手动指定返回值类型。

getters: {
  getterName(state) {
    return state.name.toUpperCase() + "-----" + state.age;
  },
  // 这种方式也可以,不过需要自己手动指定返回值类型
  getterAge(): number {
    return this.age;
  },
},

actions

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组件使用

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

获取state的方式有三种,但是需要注意通过直接解构的方式数据是不会响应式的。如果需要响应式需要使用computedstoreToRefs

import { storeToRefs } from "pinia";
const store = mainStore();
// 直接解构不能响应式
// const { name } = store;
// 这样响应式
const name = computed(() => store.name);
// 这样也能响应式
// const { name } = storeToRefs(store);

获取getters

获取getters的方式也有三种,但是需要注意通过直接解构的方式数据是不会响应式的。如果需要响应式需要使用computedstoreToRefs

import { storeToRefs } from "pinia";
const store = mainStore();
// 直接解构不能响应式
// const { getterName } = store;
// 这样响应式
const getterName = computed(() => store.getterName);
// 这样也能响应式
// const { getterName } = storeToRefs(store);

修改state

修改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出来。

数据持久化

我们知道,vuexpinia本质上都是对象,都是临时存储,当页面刷新数据都会丢失。

想要刷新不丢失就需要我们手动存储在localStoragesessionStorage里面。如果不想手动处理,我们也可以使用插件。

vuex使用vuex-persistedstate

pinia使用pinia-plugin-persistedstate

具体怎么使用笔者就不再赘述了大家可以自行查看文档,原理都是一样的,通过配置将指定数据存储到localStoragesessionStorage里面实现数据持久化。

总结

加载全部内容

相关教程
猜你喜欢
用户评论