一、什么是pinia
Pinia 是 Vue 的专属状态管理库,可以实现跨组件或页面共享状态,是 vuex 状态管理工具的替代品,和 Vuex相比,具备以下优势
-
提供更加简单的API (去掉了 mutation )
-
提供符合组合式API风格的API (和 Vue3 新语法统一)
-
去掉了modules的概念,每一个store都是一个独立的模块
-
搭配 TypeScript 一起使用提供可靠的类型推断
二、创建空Vue项目并安装Pini
1. 创建空Vue项目
npm init vue@latest
2. 安装Pinia并注册
npm i pinia
import { createPinia } from 'pinia'
const app = createApp(App)
// 以插件的形式注册
app.use(createPinia())
app.use(router)
app.mount('#app')
三、Counter计算器示例
核心步骤:
定义store
组件使用store
1- 定义store
import { defineStore } from 'pinia'
import { ref } from 'vue'
export const useCounterStore = defineStore('counter', ()=>{
// 数据 (state)
const count = ref(0)
// 修改数据的方法 (action)
const increment = ()=>{
count.value++
}
// 以对象形式返回
return {
count,
increment
}
})
2- 组件使用store
<script setup>
// 1. 导入use方法
import { useCounterStore } from '@/stores/counter'
// 2. 执行方法得到store store里有数据和方法
const counterStore = useCounterStore()
</script>
<template>
<button @click="counterStore.increment">
{
{ counterStore.count }}
</button>
</template>
四、实现getters
getters直接使用计算属性即可实现
// 数据(state)
const count = ref(0)
// getter (computed)
const doubleCount = computed(() => count.value * 2)
五、异步action
思想:action函数既支持同步也支持异步,和在组件中发送网络请求写法保持一致步骤:
store中定义action
组件中触发action
1- store中定义action
const API_URL = 'http://geek.itheima.net/v1_0/channels'
export const useCounterStore = defineStore('counter', ()=>{
// 数据
const list = ref([])
// 异步action
const loadList = async ()=>{
const res = await axios.get(API_URL)
list.value = res.data.data.channels
}
return {
list,
loadList
}
})
2- 组件中调用action
<script setup>
import { useCounterStore } from '@/stores/counter'
const counterStore = useCounterStore()
// 调用异步action
counterStore.loadList()
</script>
<template>
<ul>
<li v-for="item in counterStore.list" :key="item.id">{
{ item.name }}</li>
</ul>
</template>
五、StoreToRefs保持响应式解构
直接基于store进行解构赋值,响应式数据(state和getter)会丢失响应式特性,使用storeToRefs辅助保持响应式
<script setup>
import { storeToRefs } from 'pinia'
import { useCounterStore } from '@/stores/counter'
const counterStore = useCounterStore()
// 使用它storeToRefs包裹之后解构保持响应式
const { count } = storeToRefs(counterStore)
const { increment } = counterStore
</script>
<template>
<button @click="increment">
{
{ count }}
</button>
</template>
六、总结
通过本篇文章,我们了解了 Pinia 的基本用法,包括创建 Vue 项目、安装 Pinia、定义 store、使用 store、实现 getters、定义异步 action 以及使用 StoreToRefs。Pinia 提供了一种简洁且易于理解的方式来管理 Vue 应用的状态,使其成为 Vuex 的强大替代品。在实际项目中,Pinia 可以帮助我们构建清晰、可扩展的状态管理方案,提升开发体验和代码质量。未来,我们可以继续深入研究 Pinia 的高级特性和与其他 Vue 生态系统的集成,以充分利用这一强大的状态管理工具。欢迎大家一起学习交流讨论~