Comment démarrer avec la nouvelle gestion d'état Pinia de Vue, lisez cet article !

Pinia est une nouvelle bibliothèque de gestion d'état développée par Vue, alors comment les novices peuvent-ils démarrer avec Pinia ? L'article suivant vous présentera Pinia et vous présentera ses fonctionnalités de base et son utilisation simple. J'espère qu'il vous sera utile !

Vuex est une ancienne bibliothèque de gestion d'état Vue que tout le monde connaît

Pinia est une toute nouvelle bibliothèque de gestion d'état spécialement développée pour Vue par les membres de l'équipe Vue.js, et a été incluse dans le github officiel

Pourquoi devons-nous développer Pinia alors que nous avons déjà Vuex ?

Prenons d'abord une photo pour regarder la proposition de Vuex5, à quoi devrait ressembler la prochaine génération de Vuex5. [Recommandation associée : Tutoriel vidéo Vuejs]

Pinia est entièrement conforme aux points fonctionnels mentionnés dans sa proposition Vuex5 à l'époque, il n'est donc pas exagéré de dire que Pinia est Vuex5, car son auteur est développeur officiel , et a été officiellement repris, mais actuellement Vuex et Pinia sont toujours deux entrepôts indépendants. Ils pourraient être fusionnés ou développés indépendamment à l'avenir, mais la recommandation officielle est Pinia

car vous devez utiliser Vuex dans Vue3. Vuex4 ne peut l'être. utilisé comme choix de transition et présente de gros défauts. Par conséquent, après la naissance de l'API Componsition, une nouvelle gestion d'état Pinia

Pinia et Vuex

Vuex ont été conçues : State, . Gettes, Mutations (synchrone), Actions (asynchrone)State、Gettes、Mutations(同步)、Actions(异步)

Pinia： State、Gettes、Actions(同步异步都支持)

Vuex 当前最新版是 4.x

• Vuex4 用于 Vue3
• Vuex3 用于 Vue2

Pinia 当前最新版是 2.x

• 即支持 Vue2 也支持 Vue3

就目前而言 Pinia 比 Vuex 好太多了，解决了 Vuex 的很多问题，所以笔者也非常建议直接使用 Pinia，尤其是 TypeScript 的项目

Pinia 核心特性

• Pinia 没有 Mutations
• Actions 支持同步和异步
• 没有模块的嵌套结构
  • Pinia 通过设计提供扁平结构，就是说每个 store 都是互相独立的，谁也不属于谁，也就是扁平化了，更好的代码分割且没有命名空间。当然你也可以通过在一个模块中导入另一个模块来隐式嵌套 store，甚至可以拥有 store 的循环依赖关系
• 更好的 TypeScript 支持
  • 不需要再创建自定义的复杂包装器来支持 TypeScript 所有内容都类型化，并且 API 的设计方式也尽可能的使用 TS 类型推断
• 不需要注入、导入函数、调用它们，享受自动补全，让我们开发更加方便
• 无需手动添加 store，它的模块默认情况下创建就自动注册的
• Vue2 和 Vue3 都支持
  • 除了初始化安装和SSR配置之外，两者使用上的API都是相同的
• 支持 Vue DevTools
  • 跟踪 actions, mutations 的时间线
  • 在使用了模块的组件中就可以观察到模块本身
  • 支持 time-travel 更容易调试
  • 在 Vue2 中 Pinia 会使用 Vuex 的所有接口，所以它俩不能一起使用
  • 但是针对 Vue3 的调试工具支持还不够完美，比如还没有 time-travel 功能
• 模块热更新
  • 无需重新加载页面就可以修改模块
  • 热更新的时候会保持任何现有状态
• 支持使用插件扩展 Pinia 功能
• 支持服务端渲染

Pinia 使用

以 Vue3 + TypeScript 为例

安装

npm install pinia

main.ts 初始化配置

import { createPinia } from 'pinia'createApp(App).use(createPinia()).mount('#app')

在 store 目录下创建一个 user.ts 为例，我们先定义并导出一个名为 user 的模块

import { defineStore } from 'pinia'
export const userStore = defineStore('user', {
    state: () => {
        return { 
            count: 1,
            arr: []
        }
    },
    getters: { ... },
    actions: { ... }
})

defineStore

Pinia
 : État, Gettes code>, <code>Actions (les synchrones et les asynchrones sont pris en charge)

🎜La dernière version de Vuex est 4.x🎜

• Vuex4 est utilisé pour Vue3
• Vuex3 est utilisé pour Vue2

🎜La dernière version de Pinia est 2.x🎜

• Elle prend en charge à la fois Vue2 et Vue3
• li>

🎜Pour l'instant, Pinia est bien meilleur que Vuex et résout de nombreux problèmes de Vuex, je recommande donc fortement d'utiliser Pinia directement, en particulier pour les projets TypeScript🎜

Fonctionnalités principales de Pinia🎜

• Pinia n'a pas de Mutations
• Actions prend en charge la synchronisation et l'asynchrone
Pas de structure imbriquée de modules
• Pinia fournit une structure plate grâce à sa conception, ce qui signifie que chaque magasin est indépendant les uns des autres et que personne n'appartient à personne. Il est plat, avec une meilleure séparation des codes et sans espace de noms. . Bien sûr, vous pouvez également imbriquer implicitement des magasins en important un autre module dans un module, et même avoir des dépendances circulaires des magasins
• Meilleure prise en charge de TypeScript
  • Il n'est pas nécessaire de créer un wrapper complexe personnalisé pour prendre en charge TypeScript. Tout le contenu est typé et l'API est conçue pour utiliser autant que possible l'inférence de type TS
Pas besoin d'injecter, d'importer des fonctions, de les appeler, profitez de la complétion automatique, ce qui rend notre développement plus pratique
• Pas besoin d'ajouter manuellement la boutique, son module est automatiquement enregistré par défaut lors de sa création
• li>
• Vue2 et Vue3 prennent en charge
  • À l'exception de l'installation initiale et de la configuration SSR, l'API utilisée par les deux est la même
• Prend en charge Vue DevTools
  • Suivi de la chronologie des actions et des mutations
  • Le module lui-même peut être observé dans les composants qui utilisent le module
  • Prise en charge du temps- les voyages facilitent le débogage
  • Dans Vue2, Pinia utilisera toutes les interfaces de Vuex, elles ne peuvent donc pas être utilisées ensemble
  • Mais la prise en charge de l'outil de débogage pour Vue3 n'est pas suffisante. Parfait, par exemple, il n'y a pas de fonction de voyage dans le temps
• Mise à jour à chaud des modules
  • Les modules peuvent être modifiés sans recharger la page
  • Mise à jour à chaud Tout existant l'état sera maintenu
• Prend en charge l'utilisation de plug-ins pour étendre les fonctions Pinia
• Prend en charge le rendu côté serveur

Pinia utilise 🎜🎜en prenant Vue3 + TypeScript comme exemple🎜🎜installation🎜

<template>
    <div>{{ user_store.count }}</div>
</template>
<script setup>
import { userStore } from &#39;../store&#39;
const user_store = userStore()
// 解构
// const { count } = userStore()
</script>

🎜main.ts configuration d'initialisation🎜

<template>
    <div>{{ count }}</div>
</template>
<script setup>
import { storeToRefs } from &#39;pinia&#39;
import { userStore } from &#39;../store&#39;
const { count } = storeToRefs(userStore)
</script>

🎜en magasin Créez un user.ts dans le répertoire Par exemple, nous définissons et exportons d'abord un module nommé user 🎜

<template>
    <div>{{ myCount }}</div>
    <div>{{ myCount }}</div>
    <div>{{ myCount }}</div>
</template>

🎜defineStore reçoit. deux paramètres 🎜🎜Le premier paramètre est le nom du module, qui doit être unique. Plusieurs modules ne peuvent pas avoir le même nom. Pinia montera tous les modules sur le conteneur racine 🎜Le deuxième paramètre est un objet et les options à l'intérieur sont. le même que Vuex Almost🎜

• 其中 state 用来存储全局状态，它必须是箭头函数，为了在服务端渲染的时候避免交叉请求导致的数据状态污染所以只能是函数，而必须用箭头函数则为了更好的 TS 类型推导
• getters 就是用来封装计算属性，它有缓存的功能
• actions 就是用来封装业务逻辑，修改 state

访问 state

比如我们要在页面中访问 state 里的属性 count

由于 defineStore 会返回一个函数，所以要先调用拿到数据对象，然后就可以在模板中直接使用了

<template>
    <div>{{ user_store.count }}</div>
</template>
<script setup>
import { userStore } from &#39;../store&#39;
const user_store = userStore()
// 解构
// const { count } = userStore()
</script>

比如像注释中的解构出来使用，是完全没有问题的，只是注意了，这样拿到的数据不是响应式的，如果要解构还保持响应式就要用到一个方法 storeToRefs()，示例如下

<template>
    <div>{{ count }}</div>
</template>
<script setup>
import { storeToRefs } from &#39;pinia&#39;
import { userStore } from &#39;../store&#39;
const { count } = storeToRefs(userStore)
</script>

原因就是 Pinia 其实是把 state 数据都做了 reactive 处理，和 Vue3 的 reactive 同理，解构出来的也不是响应式，所以需要再做 ref 响应式代理

getters

这个和 Vuex 的 getters 一样，也有缓存功能。如下在页面中多次使用，第一次会调用 getters，数据没有改变的情况下之后会读取缓存

<template>
    <div>{{ myCount }}</div>
    <div>{{ myCount }}</div>
    <div>{{ myCount }}</div>
</template>

注意两种方法的区别，写在注释里了

getters: {
    // 方法一，接收一个可选参数 state
    myCount(state){
        console.log('调用了') // 页面中使用了三次，这里只会执行一次，然后缓存起来了
        return state.count + 1
    },
    // 方法二，不传参数，使用 this
    // 但是必须指定函数返回值的类型，否则类型推导不出来
    myCount(): number{
        return this.count + 1
    }
}

更新和 actions

更新 state 里的数据有四种方法，我们先看三种简单的更新，说明都写在注释里了

<template>
    <div>{{ user_store.count }}</div>
    <button @click="handleClick">按钮</button>
</template>
<script setup>
import { userStore } from &#39;../store&#39;
const user_store = userStore()
const handleClick = () => {
    // 方法一
    user_store.count++
    
    // 方法二，需要修改多个数据，建议用 $patch 批量更新，传入一个对象
    user_store.$patch({
        count: user_store.count1++,
        // arr: user_store.arr.push(1) // 错误
        arr: [ ...user_store.arr, 1 ] // 可以，但是还得把整个数组都拿出来解构，就没必要
    })
    
    // 使用 $patch 性能更优，因为多个数据更新只会更新一次视图
    
    // 方法三，还是$patch，传入函数，第一个参数就是 state
    user_store.$patch( state => {
        state.count++
        state.arr.push(1)
    })
}
</script>

第四种方法就是当逻辑比较多或者请求的时候，我们就可以封装到示例中 store/user.ts 里的 actions 里

可以传参数，也可以通过 this.xx 可以直接获取到 state 里的数据，需要注意的是不能用箭头函数定义 actions，不然就会绑定外部的 this 了

actions: {
    changeState(num: number){ // 不能用箭头函数
        this.count += num
    }
}

调用

const handleClick = () => {
    user_store.changeState(1)
}

支持 VueDevtools

打开开发者工具的 Vue Devtools 就会发现 Pinia，而且可以手动修改数据调试，非常方便

模拟调用接口

示例：

我们先定义示例接口 api/user.ts

// 接口数据类型
export interface userListType{
    id: number
    name: string
    age: number
}
// 模拟请求接口返回的数据
const userList = [
    { id: 1, name: '张三', age: 18 },
    { id: 2, name: '李四', age: 19 },
]
// 封装模拟异步效果的定时器
async function wait(delay: number){
    return new Promise((resolve) => setTimeout(resolve, delay))
}
// 接口
export const getUserList = async () => {
    await wait(100) // 延迟100毫秒返回
    return userList
}

然后在 store/user.ts 里的 actions 封装调用接口

import { defineStore } from 'pinia'
import { getUserList, userListType } from '../api/user'
export const userStore = defineStore('user', {
    state: () => {
        return {
            // 用户列表
            list: [] as userListType // 类型转换成 userListType
        }
    },
    actions: { 
        async loadUserList(){
            const list = await getUserList()
            this.list = list
        }
    }
})

页面中调用 actions 发起请求

<template>
    <ul>
        <li v-for="item in user_store.list"> ... </li>
    </ul>
</template>
<script setup>
import { userStore } from &#39;../store&#39;
const user_store = userStore()
user_store.loadUserList() // 加载所有数据
</script>

跨模块修改数据

在一个模块的 actions 里需要修改另一个模块的 state 数据

示例：比如在 chat 模块里修改 user 模块里某个用户的名称

// chat.ts
import { defineStore } from 'pinia'
import { userStore } from './user'
export const chatStore = defineStore('chat', {
    actions: { 
        someMethod(userItem){
            userItem.name = '新的名字'
            const user_store = userStore()
            user_store.updateUserName(userItem)
        }
    }
})

user 模块里

// user.ts
import { defineStore } from 'pinia'
export const userStore = defineStore('user', {
    state: () => {
        return {
            list: []
        }
    },
    actions: { 
        updateUserName(userItem){
            const user = this.list.find(item => item.id === userItem.id)
            if(user){
                user.name = userItem.name
            }
        }
    }
})

（学习视频分享：vuejs教程、web前端）

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!