项目代码同步至码云 weiz-vue3-template
pina 是 vue3 官方推荐的状态管理库，由 Vue 核心团队维护，旨在替代 vuex。pina 的更多介绍，可从 pina官网 查看
特点
- 更简洁直接的 API，提供组合式风格的 API
- 支持模块热更新和服务端渲染
- 对TS支持更为友好
安装
npm i pinia 使用
1. 创建实例
src目录下新建store文件夹，并新建index.ts文件
import { createPinia } from 'pinia' const store = createPinia() export default store 2. 使用实例
在main.ts里引入并使用
import { createApp } from 'vue' import pinia from '@/store' import './style.css' import App from './App.vue' import router from '@/router/index' createApp(App).use(router).use(pinia).mount('#app') 3. 创建store
types文件夹下创建store.ts类型声明
export interface UserState { token: string userInfo: { name?: string; phone?: string } } store目录下新建modules文件夹，并新建user.ts文件
import { defineStore } from 'pinia' import { UserState } from 'types/store' // 第一个参数是id，唯一 export const useUserStore = defineStore('user', { state: () => { return { token: 'EFA68205747CB561BB7C0F85D5689856', userInfo: { name: 'weizwz', phone: '18392016879' } } }, getters: { namePic: (state) => state.userInfo.name.substring(0, 1) }, actions: { setToken(token: string) { this.token = token }, setUserInfo(userInfo: UserState['userInfo']) { this.userInfo = { ...this.userInfo, ...userInfo } } } }) 4. 使用store
修改view文件夹下的home.vue来获取store
<script setup lang="ts"> import { computed } from 'vue' import { storeToRefs } from 'pinia' import { useUserStore } from '@store/user' defineOptions({ name: 'V-home' }) const userStore = useUserStore() // 获取state使用computed或者使用storeToRefs，直接使用不具备响应式（拿到的永远是初次的值） const username = computed(() => userStore.userInfo.name) // 获取getter使用storeToRefs，或者直接使用，在模板里 userStore.namePic const { namePic, token } = storeToRefs(userStore) </script> <template> <div>Hello: {{ namePic }}, your name is {{ username }}, your token is {{ token }}</div> </template> <style scoped></style> 修改view文件夹下的login.vue来设置store
<script setup lang="ts"> import { ref } from 'vue' import { storeToRefs } from 'pinia' import { useUserStore } from '@store/user' defineOptions({ name: 'V-login' }) const userStore = useUserStore() const { userInfo, token } = storeToRefs(userStore) const userName = ref(userInfo.value.name) const userToken = ref(token) const updateUserName = () => { userStore.setUserInfo({ name: userName.value }) } const updateUserToken = () => { userStore.setToken(userToken.value) } </script> <template> <div>login page</div> name: <input type="text" v-model="userName" @input="updateUserName" /> <br /> token: <input type="text" v-model="userToken" @input="updateUserToken" /> </template> <style scoped></style> 如果@store/user不能识别，请在tsconfig.json中的paths里加入此路径
"paths": { "@store/*": ["src/store/modules/*"], }, 持久化
由于刷新界面会导致store重置，所以一般通过将store存储到cookie或者storage里使其持久化。cookie方面的插件，我这里推荐使用js-cookie
1. 安装
npm i js-cookie -S npm i @types/js-cookie -S 2.封装
在src下新建utils文件夹，并新建auth.ts
import Cookies from 'js-cookie' export const TokenKey = 'weiz-token' type ExpiresData = Date | number export interface TokenInfo { token: string expires: ExpiresData } export function getToken() { return Cookies.get(TokenKey) } export function setToken(data: TokenInfo) { const { token, expires } = data return expires ? Cookies.set(TokenKey, token, { expires: expires }) : Cookies.set(TokenKey, token) } export function removeToken() { return Cookies.remove(TokenKey) } 3. 使用
修改store下的user.ts
import { getToken, setToken } from '@/utils/auth' // 省略 state: () => { return { token: getToken() || 'EFA68205747', userInfo: { name: 'weizwz', phone: '18392016879' } } } // 省略 setToken(token: string) { this.token = token setToken({ token, expires: 30 }) } 效果展示
