《Vue3 基础知识》Pinia 01 之 基础

2024-06-15 05:36
文章标签 javascript 基础 vue vue3 01 frontend 基础知识 pinia

本文主要是介绍《Vue3 基础知识》Pinia 01 之 基础，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

Pinia 基础知识

前言

说明

  • 本篇更倾向于 选项式 API 写法，因为项目是从 Vue2 升级至 Vue3，为更好且快速适配；
  • Vue2 中，Vuex3 与 Pinia 不能一起使用。因为 Pinia 使用的是 Vuex3 现有接口；
  • Vue3 中，Vuex4 与 Pinia 可以一起使用；

与 Vuex 的差异

  • 参考 从 Vuex ≤4 迁移；
  • Pinia 废弃 mutation；

Store/Pinia 是什么

  • 承载着全局状态；
  • 一个保存状态和业务逻辑的实体，它并不与你的组件树绑定；
  • 可理解为一个永远存在的组件，每个组件都可以读取和写入它；
  • 三个概念：state, getter, action ，可理解为组件中的 data, computed, methods；
  • store 是一个用 reactive 包装的对象，不用在 getter 后面写 .value；
  • store 不能解构，否则失去响应性。使用 storeToRefs() 解构可保持响应性；
<script setup>
import { storeToRefs } from 'pinia'const store useCounterStore()const { name, doubleCount } = storeToRefs(store)
</script>

核心概念

定义 Store

  • 使用 defineStore 定义，变量名建议以 use 开头且以 Store 结尾，例如：useUserStore；
  • 第一个参数要求 独一无二 ，且必传。它用来连接 store 和 devtools；
  • 第二个参数可接受两种类值：Setup 函数或 Option 对象。具体参考此处；
import { defineStore } from 'pinia'export const useUserStore = defineStore('user', {// ...
})

State

  • state 是 store 的核心；
  • state 被定义为一个返回初始化状态的函数。使得其可同步支持服务端和客户端(不理解…)；
  • 为了完整类型推理，推荐使用箭头函数；
// 选项式API方式
import { defineStore } from 'pinia'const userUserStore = defineStore('user', {// 使用箭头函数state: ()=> {return {name: 'admin',age: 30,}}
})

使用

通过实例访问，直接读写；

const store = userUserStore();store.name

重置 state

选项式 API 直接调 $reset() 方法。组合式API 要自己创建，参考此处。

const store = userUserStore();store.$reset()

只读的计算属性

使用 mapState() 辅助函数将 state 映射为只读的计算属性。

import { mapState } from 'pinia'
import { useUserStore } from '../stores/user'export default {computed: {// 直接用 this.name，与 store.name 数据相同...mapState(useUserStore, ['name']),...mapState(useUserStore, {// 与上述相同，但注册为 this.myNamemyName: 'name',// 也可以用函数fullName: store => store.name + 'Liu',// 可以访问 this，但没标注类型UserString(store) {return store.age + this.fullName}})}
}

可修改的计算属性

使用 mapWritableState() 辅助函数，但不能像 mapState() 传递成一个函数

import { mapWritableState } from 'pinia'
import { useUserStore } from '../stores/user'export default {computed: {// 直接用 this.name，与 store.name 数据相同。且能改变 this.name = '123'...mapWritableState(useUserStore, ['name']),...mapWritableState(useUserStore, {// 与上述相同，但注册为 this.myName。但没有函数方式myName: 'name',})}}

变更 state

  • 使用 $patch ，两种方式：对象方式和函数方式；
  • 区别是 p a t c h ( ) 允许你将多个变更归入 d e v t o o l s 的同一个条目中。同时请注意，直接修改 s t a t e ， patch() 允许你将多个变更归入 devtools 的同一个条目中。同时请注意，直接修改 state， patch()允许你将多个变更归入devtools的同一个条目中。同时请注意，直接修改state，patch() 也会出现在 devtools 中，而且可以进行 time travel (在 Vue 3 中还没有)。不理解…
// 方式一：对象方式
store.$patch({count: store.count + 1,age: 120,name: 'DIO',
})// 方式二：函数方式
store.$patch((state) => {state.items.push({ name: 'shoes', quantity: 1 })state.hasChanged = true
})

替换 state

// 这实际上并没有替换`$state`
store.$state = { count: 24 }
// 在它内部调用 `$patch()`：
store.$patch({ count: 24 })

Getter

  • 完全等同于 store 的 state 计算值，使用 getters 属性来定义；
  • 推荐使用箭头函数，并将接收 state 作为第一个参数；
  • 通过 this 访问 store 实例或其它 getter 值；
// 定义
export const useCounterStore = defineStore('counter', {state:() {return {count: 0,}},getters: {// 通过第一个参数 state 访问 countdoubleCount(state) {return state.count * 2},// 通过 this 访问其它 getter 值doublePlusOne() {return this.doubleCount + 1}}
})
// 访问
<script setup>
import { useCounterStore } from './counterStore'const store = useCounterStore()
</script>
<template><p>Double count is {{ store.doubleCount }}</p>
</template>
  • 向 getter 传递参数，getter 是幕后的计算属性，所以不可以向它们传递任务参数。但可以返回一个函数，函数可接受任意参数；
export const useUserListStore = defineStore('userList', {getters: {getUserById(state) {return (useId) => state.userd.find((user) => user.id === userId)}}
})
  • 想要使用另一个 store 的 getter，直接在 getter 内使用即可；
import { useOtherStore } from './other-store'export const useStore = defineStore('main', {state:() => {//...},getters: {otherGetter(state) {const otherStore = useOtherStore()return state.localData + otherStore.data}}
})
  • setup 中使用，直接访问就行，与 state 属性完全一样；
<script setup>
const store = useCounterStore()
store.count = 3
store.doubleCount // 6
</script>
  • 使用 mapState() 函数将其映射为 getters，与 state 用法一致；

Action

  • 相对于组件中的 method，可通过 defineStore() 中的 actions 属性定义；
  • 它们也是定义业务逻辑的完美选择；
  • 类似 getter，action 也可通过 this 访问整个 store 实例；
  • 不同之处，action 可以是异步的，可使用 async 或 Promise；
import { mande } from 'mande'const api = mande('/api/users')export const useUsers = defineStore('users', {state: () => {return {userData: null,}},actions: {async registerUser(login, password) {try {this.userData = await api.post({login, password})} catch(error) {showTooltip(error)}}}
})

调用：可以像函数或通常意义上的方法一样被调用；

<script setup>
const store = useCounterStore();
// 将 action 作为 store 的方法进行调用
store.randomizeCounter()
</script>
<template><!-- 即使在模板中也可以 --><button @click="store.randomizeCounter()"></button>
</template>

  • 访问其它 store 的 action，直接在 action 中调就好了；

  • 选项式API的用法

import { defineStore } from 'pinia'const userCounterStore = defineStore('counter', {state: () => {count: 0},actions: {increment() {this.count++;}}
})
  • 使用 setup()；
  • 不使用 setup()：mapActions 辅助函数将action属性映射为你组件中的方法；

组件外的 Store

单页面应用
  • app.use(pinia) 安装后，对 useStore() 的调用才能正常使用；
  • 为确保 pinia 实例被激活，最简单的方法是将 useStore() 调用放在 pinia 安装之后再执行的函数中；
import { useUserStore } from '@/stores/user'
import { createApp } from 'vue'
import App from './App.vue'// 错误
const userStore = useUserStore()const pinia = createPinia()
const app = createApp(App)
app.use(pinia)// 正确，因为 pinia 实例现在被激活
const userStore = useUserStore()

这篇关于《Vue3 基础知识》Pinia 01 之 基础的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！

原文地址:
本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.chinasem.cn/article/1062562。

相关文章

前端如何通过nginx访问本地端口

前端如何通过nginx访问本地端口

《前端如何通过nginx访问本地端口》：本文主要介绍前端如何通过nginx访问本地端口的问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、nginx安装1、下载（1）下载地址（2）系统选择（3）版本选择2、安装部署（1）解压（2）配置文件修改（3）启动（4）
阅读更多...
HTML中meta标签的常见使用案例(示例详解)

HTML中meta标签的常见使用案例(示例详解)

《HTML中meta标签的常见使用案例(示例详解)》HTMLmeta标签用于提供文档元数据,涵盖字符编码、SEO优化、社交媒体集成、移动设备适配、浏览器控制及安全隐私设置,优化页面显示与搜索引擎索引... 目录html中meta标签的常见使用案例一、基础功能二、搜索引擎优化（seo）三、社交媒体集成四、移动
阅读更多...
HTML input 标签示例详解

HTML input 标签示例详解

《HTMLinput标签示例详解》input标签主要用于接收用户的输入，随type属性值的不同，变换其具体功能,本文通过实例图文并茂的形式给大家介绍HTMLinput标签，感兴趣的朋友一... 目录通用属性输入框单行文本输入框 text密码输入框 password数字输入框 number电子邮件输入编程框
阅读更多...
HTML img标签和超链接标签详细介绍

HTML img标签和超链接标签详细介绍

《HTMLimg标签和超链接标签详细介绍》：本文主要介绍了HTML中img标签的使用，包括src属性（指定图片路径）、相对/绝对路径区别、alt替代文本、title提示、宽高控制及边框设置等，详细内容请阅读本文，希望能对你有所帮助... 目录img 标签src 属性alt 属性title 属性width/h
阅读更多...
CSS3打造的现代交互式登录界面详细实现过程

CSS3打造的现代交互式登录界面详细实现过程

《CSS3打造的现代交互式登录界面详细实现过程》本文介绍CSS3和jQuery在登录界面设计中的应用,涵盖动画、选择器、自定义字体及盒模型技术,提升界面美观与交互性,同时优化性能和可访问性，感兴趣的朋... 目录1. css3用户登录界面设计概述1.1 用户界面设计的重要性1.2 CSS3的新特性与优势1.
阅读更多...
HTML5 中的＜button＞标签用法和特征

HTML5 中的＜button＞标签用法和特征

《HTML5中的＜button＞标签用法和特征》在HTML5中，button标签用于定义一个可点击的按钮，它是创建交互式网页的重要元素之一，本文将深入解析HTML5中的button标签，详细介绍其属... 目录引言<button> 标签的基本用法<button> 标签的属性typevaluedisabled
阅读更多...
HTML5实现的移动端购物车自动结算功能示例代码

HTML5实现的移动端购物车自动结算功能示例代码

《HTML5实现的移动端购物车自动结算功能示例代码》本文介绍HTML5实现移动端购物车自动结算,通过WebStorage、事件监听、DOM操作等技术,确保实时更新与数据同步,优化性能及无障碍性,提升用... 目录1. 移动端购物车自动结算概述2. 数据存储与状态保存机制2.1 浏览器端的数据存储方式2.1.
阅读更多...
基于 HTML5 Canvas 实现图片旋转与下载功能(完整代码展示)

基于 HTML5 Canvas 实现图片旋转与下载功能(完整代码展示)

《基于HTML5Canvas实现图片旋转与下载功能(完整代码展示)》本文将深入剖析一段基于HTML5Canvas的代码，该代码实现了图片的旋转（90度和180度）以及旋转后图片的下载... 目录一、引言二、html 结构分析三、css 样式分析四、JavaScript 功能实现一、引言在 Web 开发中，
阅读更多...
CSS place-items: center解析与用法详解

CSS place-items: center解析与用法详解

《CSSplace-items:center解析与用法详解》place-items:center;是一个强大的CSS简写属性，用于同时控制网格(Grid)和弹性盒(Flexbox)... place-items: center; 是一个强大的 css 简写属性，用于同时控制 网格(Grid) 和 弹性盒(F
阅读更多...
CSS实现元素撑满剩余空间的五种方法

CSS实现元素撑满剩余空间的五种方法

《CSS实现元素撑满剩余空间的五种方法》在日常开发中，我们经常需要让某个元素占据容器的剩余空间，本文将介绍5种不同的方法来实现这个需求，并分析各种方法的优缺点，感兴趣的朋友一起看看吧... css实现元素撑满剩余空间的5种方法 在日常开发中，我们经常需要让某个元素占据容器的剩余空间。这是一个常见的布局需求
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2