Vue3快速上手指南
Vue3简介
官⽹地址: https://vuejs.org/ 。
中⽂官⽹ https://cn.vuejs.org/
Vue是什么?
易学易⽤,性能出⾊,适⽤场景丰富的 Web 前端框架。
Vue2已经于2023年12⽉31⽇停⽌维护。建议升级到Vue.js3.0版本。打包更⼩,内存更少,渲染更快。 好消 息是,vue3向下兼容vue2的语法
Vue3于2020年9⽉18⽇发布, 久经磨砺 Vue3新特性:组合式API(重点),更好的⽀持TypeScript(熟悉),状态存储框架Pinia(重点),新组件(了 解)
⼀、整体认识Vue3项⽬
1、创建Vue3⼯程
前置:安装NodeJS。NodeJS版本18.0以上。
使⽤官⽅脚⼿架创建Vue⼯程[推荐]。
# 使⽤官⽅脚⼿架
npm create vue@latest# 按照脚⼿架要求选择是否启⽤相关组件
Vue.js - The Progressive JavaScript Framework✔ 请输⼊项⽬名称: … myVue3✔ 请输⼊包名称: … myvue3✔ 是否使⽤ TypeScript 语法? … 否 / 是 # 选是
✔ 是否启⽤ JSX ⽀持? … 否 / 是
✔ 是否引⼊ Vue Router 进⾏单⻚⾯应⽤开发? … 否 / 是
✔ 是否引⼊ Pinia ⽤于状态管理? … 否 / 是
✔ 是否引⼊ Vitest ⽤于单元测试? … 否 / 是
✔ 是否要引⼊⼀款端到端(End to End)测试⼯具? › 不需要
✔ 是否引⼊ ESLint ⽤于代码质量检测? … 否 / 是 # 选是
✔ 是否引⼊ Prettier ⽤于代码格式化? … 否 / 是
✔ Add Vue DevTools extension for debugging? (experimental) … 否 / 是# 启动项⽬
npm installnpm run dev
#
#
# VITE v5.1.6 ready in 315 ms➜ Local: http://localhost:5173/➜ Network: use --host to expose➜ press h + enter to show help
1、所有功能组件都可以后续⼿动添加。
关于TypeScript,在Vue中的TypeScript可以认为是在JS的基础上,增加⾯向对象的能⼒。可以定义接⼝、 类、抽象类等。
2、npm install过程中会去node仓库下载很多依赖库,放到项⽬本地node_modules⽬录。建议将npm源设 定为淘宝提供的国内镜像,可以下载快⼀点。
npm config get registry https://registry.npmmirror.com
补充:vue2时提供了另外⼀个脚⼿架vue-cli,也可以⽤来创建vue3项⽬。但是vue-cli已经处于停⽌维护状态。
# 安装或者升级脚⼿架
npm install -g @vue/cli# 查看脚⼿架版本,确保版本在4.5.0以上
vue --version# 创建应⽤
vue create vue_test2.x# 启动
cd vue_testnpm run serve
另外,官⽅还有其他⼀些集成vue的⽅法,⾃⾏参考。
2、主要⼯程结构
官⽅建议开发IDE: vscode。提供了辅助开发插件 vue-official。 主要代码结构如下图 在这之前有个插件叫volar,现在已经停⽤
典型的Vue项⽬,都是在index.html这⼀个单⻚⾯⾥形成各种交互,这也就是所谓的SPA(Single Page Application)
Vue3的核⼼是通过createApp函数创建⼀个应⽤实例,在这个实例中构建各种应⽤。(main.ts中)
每个vue⽂件就是⼀个⻚⾯上的组件,组件可以嵌套使⽤。 vue中的组件分为
vue中的组件分为<template>⻚⾯模板,<script>脚本和<style>样式三个部分。Vue2中要求<template>下必
须有⼀个唯⼀的根元素,Vue3中则没有了这个限制。
⼆、数据双向绑定
双向绑定是Vue最为核⼼的功能。简单理解就是<template>中的⻚⾯数据和<script>中的脚本数据进⾏绑定,其
中任何⼀个数据发⽣了变化,另⼀个数据也随之发⽣变化。
1、vue2语法的双向绑定
<template><div>
姓名:<input v-model="userName" /> {{ userName }} <br />
薪⽔:<input type="number" v-model="salary" /> <button @click="addSalary">薪⽔加
1000</button> {{ salary }}</div></template><script lang="ts">export default{//数据data() {return {userName:"王⼀",salary:15000}},//⽅法
methods:{addSalary(){this.salary += 1000}}}</script><style scoped></style>
数据双向绑定可以说是整个Vue的核⼼。例如,我们可以⽤数据双向绑定实现⼀些更为复杂的表单。
<template><div>
姓名:<input v-model="userName"/> {{ userName }}<br />
薪⽔:<input type="number" v-model="salary"/> {{ salary }}<br /><button v-on:click="addSalary">提交</button> <button @click="changeUserInfo">查看个⼈信
息</button></div><hr /><div class="userInfo" v-if="showUserInfo"><h2>个⼈信息</h2>
年龄:<input type="number" v-model="userInfo.age" /><br />
性别:<input type="radio" value="1" v-model="userInfo.sex">男<input type="radio"
value="2" v-model="userInfo.sex">⼥<br/>
岗位:<select v-model="userInfo.department"><option value="dev">开发</option><option value="test">测试</option><option value="maintain">运维</option></select><br />
技术: <span v-for="skill in userInfo.skills" :key="skill">{{ skill }}</span><br />
学习新技术: <input v-model="newSkill" /> <button @click="learnSkill">学习</button><br
/>
个⼈信息汇总:{{ userInfo }}</div></template>
<script lang="ts">export default{data(){return{userName:'roy',salary:15000,userInfo:{age:0,sex:1,skills:['java','vue','python'],department:''},newSkill:'',showUserInfo:false}},methods:{addSalary(){this.salary +=1000 },learnSkill(){if(this.newSkill)this.userInfo.skills.push(this.newSkill)},changeUserInfo(){this.showUserInfo= !this.showUserInfo}}}</script><style scoped>.userInfo{background-color: bisque;width: 80%;}.userInfo span{background-color: yellow;margin-left: 10px;border: 1px;border-radius: 5px;}</style>
这样的表单,如果要⽤纯JS实现,就会相当困难。但是,⽤双向绑定就简单很多。
2、OptionsAPI和CompositionAPI
Vue2中常⽤的这种编写⽅式称为OptionsAPI,配置式。其实现⽅式是⽤⼀个统⼀的配置对象来实现全部代码逻 辑。在这个对象中,通过data、methods、computed等配置选项来控制逻辑。
OptionsAPI是Vue2时的标准API编写⽅式。Vue3向下兼容了Vue2的API。因此,Vue2的⽼项⽬,在Vue3中基本 可以⽆缝迁移。 实际上,OptionsAPI是在CompositionAPI的基础上实现的。关于Vue的基础概念和知识,在这两种API 之间是通⽤的。另外,官⽅建议,如果采⽤Vue构建完整的SPA应⽤,那么更建议使⽤CompositionAPI。
但是,OptionsAPI所有逻辑都混在⼀起,不便于维护和复⽤。 Vue3另外通过了⼀种更⽅便的API,Composition API,混合式API。
上⾯同样的示例,⽤Composition API的写法如下:
<template><div>
姓名:<input v-model="userName" /> {{ userName }} <br />
薪⽔:<input type="number" v-model="salary" /> <button @click="addSalary">薪⽔加
1000</button> {{ salary }}</div></template><script lang="ts">export default{setup(){//现在声明的变量还不具备双向绑定let userName="王⼀"let salary=15000function addSalary(){salary += 1000console.log("salary = " + salary)}//模板要⽤哪些,就返回哪些return {userName,salary,addSalary}}}</script><style scoped></style>
1、setup是Vue3中的⼀个⽣命周期函数,他会在组件加载时执⾏。后⾯会细讲⽣命周期。
2、setup可以返回对象或者函数。如果是⼀个对象,则对象中的属性、⽅法等,可以在模板中直接使⽤(常
⽤)。如果返回⼀个函数,则通过函数的返回值直接渲染⻚⾯,不经过模板。例如 setup(){return ()=>"直接渲染"}
3、setup是⼀个普通的函数,不能使⽤this。
OptionsAPI中可以通过this访问脚本本身的数据 同时setup中不处理this,意味着setup编写可以更灵活,不需要依赖当前⻚⾯上下⽂
4、此时声明的userName, salary等变量不具备双向绑定。Vue3对双向绑定做了重新设计,后⾯会详细分
享。
5、setup有⼀种简写的⽅式<script setup lang="ts">。这样就不需要写函数了,标签内部直接写函数体。在
标签内部声明的对象,函数等,都会直接return出去。项⽬中常⽤
<script setup lang="ts">//现在声明的变量还不具备双向绑定let userName="王⼀"let salary=15000function addSalary(){salary += 1000console.log("salary = " + salary)}</script>
在CompositionAPI中,由于setup是⼀个不同的函数,不需要处理this。这也意味着setup函数编写可以更加灵 活,不需要依赖当前⻚⾯上下⽂。例如:将示例中的脚本单独写到⼀个ts⽂件中。
// MySalary.tsimport { onMounted, ref } from "vue"export default function(){//现在声明的变量还不具备双向绑定。添加ref函数才能具备响应式const userName=ref("王⼀")const salary=ref(15000)function addSalary(){salary.value += 1000console.log("salary = " + salary.value)}onMounted(()=>{console.log("加载了外部脚本")});}return {userName,salary,addSalary}
然后,在App.vue中就可以直接引⽤脚本
<template><div>
姓名:<input v-model="userName" /> {{ userName }} <br />
薪⽔:<input type="number" v-model="salary" /> <button @click="addSalary">薪⽔加
1000</button> {{ salary }}</div></template><script setup lang="ts">import MySalary from './components/MySalary';let {userName,salary,addSalary} = MySalary()</script><style scoped></style>
如果App.vue的逻辑越来越复杂,通过这种⽅式,就更易于将相关的属性和⽅法整理到⼀起,从⽽实现⼀个特定 的业务功能。
1、ref函数让变量具备了双向绑定功能。后⾯详细分析。
2、复杂⻚⾯可以⽤这种⽅式。⼀般情况下,显然是将MySalary的模板和脚本封装到⼀起,这就是⾃定义组 件了。
3、Vue3中的数据双向绑定
3.1 ref定义基础类型响应式数据
语法: let userName=ref(初始值)。
返回值:⼀个RefImpl的实例对象,值被包裹在对象的value属性中。
注意点:
脚本中要⽤ref对象的value属性访问值,例如userName.value。但是模板中可以直接⽤。
ref对象本身不是响应式的,value属性是响应式的。例如js中修改值,要通过userName.value=“xxx”, ⽽不能userName=“xxx”。
vue-official插件中可以选择⾃动添加value属性。(需要⼿动勾选
<template><div>
姓名:<input v-model="userName" /> <button @click="changeName">名字后⾯加1</button> {{
userName }} <br />
薪⽔:<input type="number" v-model="salary" /> <button @click="addSalary">薪⽔加
1000</button> {{ salary }}</div></template><script setup lang="ts">import { ref } from 'vue';//基础类型⽤ref声明响应式let userName=ref("王⼀")let salary=ref(15000)function changeName(){userName.value += "⼀"//userName不是响应式的,userName.value才是响应式的。重新定义userName就⽆法双向绑定//userName = ref("王⼀⼀")}function addSalary(){//脚本中操作数据要加.valuesalary.value += 1000//观察salary对象结构console.log("salary = " , salary)}</script>
3.2 reactive定义对象型响应式数据
语法: let salaryInfo = reactive({userName:“王⼀”,salary:15000})
返回值:⼀个Proxy实例对象,具有双向绑定能⼒。
<template><div>
姓名:<input v-model="salaryInfo.userName" /> <button @click="changeName">名字后⾯加
1</button> {{ salaryInfo.userName }} <br />
薪⽔:<input type="number" v-model="salaryInfo.salary" /> <button @click="addSalary">薪
⽔加1000</button> {{ salaryInfo.salary }}</div></template><script setup lang="ts">import { reactive } from 'vue';// 对象类型⽤reactive声明响应式let salaryInfo = reactive({userName:"王⼀",salary:15000})function changeName(){salaryInfo.userName+="⼀"}function addSalary(){salaryInfo.salary+=1000//观察SalaryInfo对象console.log("salaryInfo",salaryInfo)}</script><style scoped></style>
3.3 ref对⽐reactive
这两者都是⽤来声明响应式数据的。但是也有⼀些需要注意的地⽅。
ref也可以⽤来声明对象型响应式数据。其内部也是使⽤reactive实现。例如下⾯的写法效果是⼀样的
<script setup lang="ts">import { ref } from 'vue';// 对象类型⽤reactive声明响应式let salaryInfo = ref({userName:"王⼀",salary:15000})function changeName(){salaryInfo.value.userName+="⼀"}function addSalary(){salaryInfo.value.salary+=1000//观察SalaryInfo对象console.log("salaryInfo",salaryInfo)}</script>
其中salaryInfo.value其实拿到的就是⼀个Reactive对象。
基础类型响应式数据,只能⽤ref声明。对象型响应式数据,ref,reactive都可以。通常⼤对象推荐使⽤ reactive。
对象型响应数据,如果将各个属性拆解出来,是不具备响应式的。如果需要响应式属性,可以使⽤toRefs或者 toRef函数进⾏转换。例如
<template><div>
姓名:<input v-model="name" /> <button @click="changeName">名字后⾯加1</button> {{
name }} <br />
薪⽔:<input type="number" v-model="money" /> <button @click="addSalary">薪⽔加
1000</button> {{ money }}</div></template><script setup lang="ts">import { reactive, toRef, toRefs } from 'vue';// 对象类型⽤reactive声明响应式let salaryInfo = reactive({userName:"王⼀",salary:15000})// 拆解出来的属性,是基础数据,不具备响应式// let name = salaryInfo.userName// let money = salaryInfo.salary// toRef将对象的属性转为⼀个响应式数据let name = toRef(salaryInfo,'userName')let money = toRef(salaryInfo,'salary')// 将对象的所有属性⼀起转换成响应式数据// let {userName,salary} = toRefs(salaryInfo)function changeName(){name.value +="⼀"console.log("name",name)}
function addSalary(){money.value +=1000//观察SalaryInfo对象console.log("money",money)}</script><style scoped></style>
3.4 标签的ref属性
在<template>中定义模板时,可以通过ref属性将当前DOM元素绑定给响应式变量。
<template>
姓名:<input ref="name" abc="aaaaa"/> <button @click="showRes">分析输⼊框</button></template><script setup lang="ts">import { ref } from 'vue';let name = ref()function showRes(){console.log(name) //RefImpl ref对象console.log(name.value) //<input> dom元素console.log(name.value.value) //输⼊框的值console.log(name.value.getAttribute("abc")) //⾃定义属性的值
}</script><style scoped></style>
如果只是针对普通元素,还体现不出Ref的作⽤。如果配合⾃定义组件,则更能体现Ref属性的作⽤。例如,针对 薪⽔信息,可以⾃⼰写⼀个简单组件,把多个输⼊框整合到⼀起。
<!-- ⾃定义的薪⽔信息输⼊组件 --><template>
姓名:<input v-model="userName"><br />
薪⽔:<input type="number" v-model="salary"></template><script lang="ts">//组件名默认是⽂件名。如果不希望⽤⽂件名,也可以⾃定义export default {name:"SalaryInfo"}</script>
<script setup lang="ts">import { ref } from 'vue';//响应式数据默认值let userName = ref("unknown")let salary = ref(1000)//对外暴露属性。只有暴露出去,组件外部才能访问defineExpose({userName,salary})</script><style></style>
然后,在App.vue中,就可以通过ref属性获取薪⽔输⼊框的值。
<!-- App.vue --><template><MySalaryInfo ref="salaryInfo"/><button @click="showRes">查看薪⽔信息</button></template><script setup lang="ts">//引⼊⼦组件import MySalaryInfo from '@/components/MySalaryInfo.vue';import { ref } from 'vue';//获取绑定对象let salaryInfo = ref()function showRes(){console.log(salaryInfo) //RefImpl ref对象console.log(salaryInfo.value) //Proxy ⼦组件的响应式数据console.log(salaryInfo.value.userName) //输⼊框的值console.log(salaryInfo.value.salary) }</script><style scoped></style>
3.5⾃定义组件的props属性
上⾯的示例相当于是⼦组件将属性暴露给⽗组件。那如果想要⽗组件给⼦组件赋值呢?这就可以⽤到组件的 props属性。
<!-- App.vue --><template><MySalaryInfo :salaryInfo="salaryInfo"/> <br /><button @click="setSalary">修改薪⽔信息
</button></template><script setup lang="ts">//引⼊⼦组件
import MySalaryInfo from '@/components/MySalaryInfo.vue';import { reactive } from 'vue';
let salaryInfo = reactive({userName:"王⼀",salary:15000})function setSalary(){salaryInfo.salary+=1000console.log(salaryInfo)}</script><style scoped></style>
此时,在MySalaryInfo组件内,就可以通过defineProps函数,获取属性。
<!-- MySalaryInfo.vue --><template>{{ salaryInfo }} <br /><!-- ⽗组件传进来的值,不建议直接⽤,eslint会报红提示 -->
姓名:<input v-model="salaryInfo.userName"><br />
薪⽔:<input type="number" v-model="salaryInfo.salary"></template><script lang="ts">//组件名默认是⽂件名。如果不希望⽤⽂件名,也可以⾃定义
export default {name:"SalaryInfo"}</script><script setup lang="ts">import type { SalaryInfo } from '@/types/SalaryInfo';//直接接收,不限定类型
// defineProps(["salaryInfo"])//接收参数,限定类型
defineProps<{salaryInfo:SalaryInfo}>()</script><style></style>
三、VUE3⽣命周期
每个 Vue 组件实例在创建时都需要经历⼀系列的初始化步骤,⽐如设置好数据侦听,编译模板,挂载实例到 DOM,以及在数据改变时更新 DOM。在此过程中,它也会运⾏被称为⽣命周期钩⼦的函数,让开发者有机会在特 定阶段运⾏⾃⼰的代码。
⽣命周期有四个阶段:创建,挂载,更新,销毁。每个阶段有⼀前⼀后两个函数
OptionsAPI的⽣命周期函数:创建阶段: beforeCreate 、 created 挂载阶段: beforeMount 、 mounted 更新阶段: beforeUpdate 、 updated 销毁阶段: beforeDestroy 、 destroyed
CompositionAPI的⽣命周期函数:创建阶段: setup 挂载阶段: onBeforeMount 、 更新阶段: onMounted onBeforeUpdate 、 onUpdated 卸载阶段: onBeforeUnmount 、 onUnmounted
示例
<template><div>
薪⽔:<input type="number" v-model="salary" /> <br /><button @click="addsum">薪⽔+1000</button></div></template><!-- vue3写法 --><script lang="ts" setup>import {
ref,
onBeforeMount,
onMounted,
onBeforeUpdate,
onUpdated,
onBeforeUnmount,
onUnmounted }
from 'vue'// 数据
let salary = ref(0)// ⽅法
function addsum() {salary.value += 1000}console.log('setup')// ⽣命周期钩⼦
onBeforeMount(()=>{console.log('挂载之前')})onMounted(()=>{console.log('挂载完毕')})onBeforeUpdate(()=>{console.log('更新之前')})
onUpdated(()=>{console.log('更新完毕')})onBeforeUnmount(()=>{console.log('卸载之前')})onUnmounted(()=>{console.log('卸载完毕')})</script>
四、Vue-Router组件路由机制
Vue项⽬虽然只有index.html⼀个⻚⾯,但是可以通过多路由机制实现多⻚⾯跳转的效果。访问不同链接,展示 不同的⻚⾯内容,形成多⻚⾯的效果。
Vue官⽅提供了Vue-Router组件实现路由管理,官⽹地址: https://router.vuejs.org/zh/ 。该组件可以在创建 Vue项⽬时选择引⼊。如果创建时没有安装,也可以⼿动安装。
npm install vue-router@4//vue3要求使⽤router组件最新版本。⽬前最新版本是4
1、基础使⽤
⾸先要在ts脚本中配置router组件。 main.ts
import { createApp } from 'vue'import App from './App.vue'import { createRouter,createWebHistory } from "vue-router";import HomePage from "@/pages/Home.vue"import AboutPage from "@/pages/About.vue"import NewsPage from "@/pages/News.vue"//配置路由规则
const routes = [{
path: '/',redirect: '/home'}, //默认跳转都⾸⻚{ { {
path: '/home', component: HomePage },
path: '/about', component: AboutPage, name:'about' }, //命名路由
path: '/news', component: NewsPage },]//创建路由器
const router = createRouter({history: createWebHistory(),//路由器⼯作模式
routes,})//项⽬中,通常将两个配置项放到单独的ts⽂件中
const app = createApp(App)//加载路由器
app.use(router)app.mount('#app')
然后,在Vue模板中,配置跳转链接(标签)以及跳转⻚⾯(标签)。
App.vue
<template><div id="app"><h1>Hello App!</h1><p><!-- 使⽤ router-link 组件进⾏导航 --><!-- 通过传递 `to` 来指定链接 --><!-- `<router-link>` 将呈现⼀个带有正确 `href` 属性的 `<a>` 标签 --><router-link to="/home">⾸⻚</router-link> <!-- 直接跳转 --><router-link :to="{ path:'/about'}">关于</router-link> <!-- 路径跳转 --><router-link replace :to="{ name:'news'}">新闻</router-link> <!-- 命名跳转 --></p><div class="content"><!-- 路由出⼝ --><!-- 路由匹配到的组件将渲染在这⾥ --><router-view></router-view></div></div></template><!-- vue3写法 --><script lang="ts" setup ></script><style>a{
margin: 10px;}.content{background: yellowgreen;widows: 10%;height: 400px;border: 1cap;border-radius: 10px;}</style>
启动后,点击⻚⾯上⽅的菜单,下⽅内容⻚就会显示相对应的内容。同时注意观察上⽅路径变化。
2、路由⼯作模式
在router配置中的history项为路由⼯作模式。Vue提供了两种⼯作模式:
(1)history模式
访问路径:URL不带#,斜杠链接,接近传统⽹站。缺点:容易产⽣404错误。
const router = createRouter({history:createWebHistory(), //history模式
/******/})
(2) hash模式
访问路径:URL带有#。缺点:对SEO不太友好。⽐较适合内部系统。
const router = createRouter({history:createWebHashHistory(), //hash模式
/******/})
3、replace属性
标签可以添加replace属性。有两种可选配置:
push和replace push 追加浏览器历史记录(默认值)。追加历史记录后,可以使⽤浏览器的返回按钮,跳回历史⻚
replace 替换浏览器历史记录。替换历史记录后,浏览器的返回按钮不可⽤。
4、嵌套路由
标签嵌⼊的⻚⾯中⽀持进⼀步嵌套⼦菜单。例如,新闻⻚希望进⼀步嵌套新闻路由。新闻⻚有多条 新闻,希望在新闻⻚展示多条新闻的标题。点击标题,可以查看对应新闻的详情。
⾸先,定义三个新闻对应的详情⻚。每个详情⻚包含简单的内容
<!-- NewsDetail1.vue --><template><p>新闻ID: 1</p><p>新闻标题: 1 </p><p>新闻内容: 1 </p></template><script lang="ts" setup></script><style></style>
并配置到路由规则中
import News1 from "@/pages/NewsDetail1.vue"import News2 from "@/pages/NewsDetail2.vue"const routes = [{
path: '/',redirect: '/home'}, //默认跳转都⾸⻚{ { {
path: '/home', component: HomePage },
path: '/about', component: AboutPage, name:'about' }, //命名路由
path: '/news',
component: NewsPage,
name:'news',children:[ //⼦路由{name: "xinwen1",path: "1",component: News1 },{name: "xinwen2",path: "2",component: News2 }] },]
然后,在新闻详情⻚增加嵌套路由
<template><div class="news"><!-- 导航区 -->
<ul><li><RouterLink to="/news/1">新闻1</RouterLink></li><li><RouterLink to="/news/2">新闻2</RouterLink></li></ul><!-- 展示区 --><div class="news-content"><RouterView></RouterView></div></div></template><script setup lang="ts"></script><style scoped>/* 新闻 */.news {padding: 0 20px;display: flex;justify-content: space-between;height: 100%;}.news ul {margin-top: 30px;list-style: none;padding-left: 10px;}.news li>a {font-size: 18px;line-height: 40px;text-decoration: none;color: #64967E;text-shadow: 0 0 1px rgb(0, 84, 0);}.news-content {width: 90%;height: 90%;border: 1px solid;margin-top: 20px;border-radius: 10px;}</style>
这样就实现了新闻⻚内的嵌套路由。点击新闻标题,会跳到对应的新闻详情⻚。
5、路由传参
上⾯的示例显然太呆板,现实的场景当然是希望查出⼀个完整的新闻列表,然后每个新闻⻚都是展示新闻列表中 的内容,⽽不是每个组件内固定的内容。这也就需要进⾏路由传参,也就是NewsDetail中的内容是从新闻列表中传 递进来的。
Vue3中提供了两种传参⽅式,query传参和param传参。
1、query传参 News.vue传参
<!-- 字符串传参 --><router-link to="/news/1?id=1&title=新闻1&content=asdfasdf"<!-- 对象传参 --><RouterLink
:to="{path:'/news/1',query:{id:'1',title:'新闻1',content:'asdfasdf'}}">
新闻1</RouterLink>
NewsDetail.vue接收参数
import {useRoute} from 'vue-router'import {toRefs} from 'vue'const route = useRoute()// 打印query参数
console.log(route.query)//配置双向绑定数据
let {query} = toRefs(route)
2、params传参
params传参⽅式表示所有参数都拼接到URL上。 ⾸先需要在route配置中预设占位符
{
path: '/news',
component: NewsPage,
name:'news',children:[ //⼦路由{name: "xinwen2",// Param传参,URL预设占位符,?表示参数可选
path: "2/:id/:title/:content",component: News2 }] },
然后,传参时,在RouteLink中直接传到预设的URL,或者⽤name属性指定⽬标。
<!-- params传参 --><RouterLink to="/news/2/1/新闻2/qowuieoiu">param路径传参</RouterLink><!-- params传参 --><RouterLink
:to="{name:'xinwen2',params:{id:2,title :'新闻2',content :'qowiueoiqu'}}">param对象传参
</RouterLink>
接下来NewsDetail2.vue中通过路由的params属性接收参数
import {useRoute} from 'vue-router'import {toRefs} from 'vue'const route = useRoute()// 打印params参数
console.log(route.params)//配置双向绑定数据
let {params} = toRefs(route)
五、Pinia集中式状态存储
1、理解状态
在任意Vue⻚⾯之间共享的存储数据。简单理解:在当前Vue项⽬中使⽤的MySQL数据库。例如登录信息,只要 完成了登录,所有Vue⻚⾯都能读取到当前登录⽤户。
Vue2中提供的集中状态存储框架是Vuex,Vue3中新提供了Pinia。如果你使⽤的还是Vue2,那么主要下,Vuex 和Pinia不能⼀起使⽤
2、创建store
Pinia可以在创建应⽤时选择引⼊。如果创建时没有引⼊,那就需要⼿动引⼊⼀下。
npm install pinia
Pinia的使⽤⽅式和Route组件基本相似。需要在启动的ts⽂件中使⽤use函数引⼊
main.ts
import {createPinia} from 'pinia'//加载piniaconst pinia = createPinia()app.use(pinia)
接下来使⽤pinia需要创建Store。⼀个Store可以理解为MySQL中的⼀个库,保存⼀部分数据。Pinia的Store中有 三个概念: state, getter , action。这三个概念也可以类⽐于熟悉的MVC。state相当于是数据;getter相当于是服 务,⽤来获取并返回数据;action相当于是Controller,组织业务逻辑。
创建定义store的⽂件 store/user.ts
import { defineStore } from 'pinia'export const userStore = defineStore('userStore',{//action封装修改state的业务动作
actions:{changeUsername(value:string){if(value && value.length<10){this.username = value}}},//getters读取state的计算值
getters:{getUsername():string{return this.username.toUpperCase()}},//state定义要保存的数据结构
state(){return{//给定默认值username:'--'}}})
store中最为核⼼的就是state,⽽在定义state时,可以利⽤TypeScript的类型定制功能,对复杂数据结构进 ⾏规范。例如
const useStore = defineStore('storeId', {state: () => {return {// ⽤于初始化空列表userList: [] as UserInfo[],// ⽤于尚未加载的数据user: null as UserInfo | null,}},})
interface UserInfo {name: stringage: number}
3、使⽤store操作数据
App.vue中修改stroe的数据
<script lang="ts" setup >//获取storeimport { userStore } from "@/store/user";const user = userStore()//修改store中的值
//1、直接修改某⼀个stateuser.username='roy'//2、修改完整的stateuser.$patch({username:'roy2'})//3、通过action进⾏修改 推荐⽅式
user.changeUsername('roy')// 获取store中的数据
console.log(user.username)// 通过getter获取state数据 推荐⽅式
console.log(user.getUsername)</script>
pinia的使⽤⼏乎没有⻔槛,相⽐vuex要简单很多,所以官⽅对Pinia的定义是符合直觉的状态管理库。因 此,在使⽤pinia时,更应该是注意使⽤规范。
4、storeToRefs声明响应式数据
如果需要将store中的数据声明成响应式数据,供Vue的模板使⽤,可以使⽤pinia提供的storeToRefs函数。他和 Vue提供的toRefs函数的区别在于,stroeToRefs只将store中的数据转换成响应式数据。⽽toRefs会将store对象中 很多隐藏的⽅法和属性⻚转换出来。
<template><div id="app"><h1>Hello {{ userInfo.username.value }}</h1></div></template><!-- vue3写法 --><script lang="ts" setup >//获取storeimport { userStore } from "@/store/user";
import { storeToRefs } from "pinia";import { toRefs } from "vue";const user = userStore()//storeToRefs转换后只有username和getUsernamelet userInfo = storeToRefs(user)console.log(userInfo)//toRefs转换后包含了很多隐藏⽅法和属性,⽐如$patchlet userInfo2 = toRefs(user)console.log(userInfo2)</script><style></style>
5、store的混合式写法
store也有⼀种混合式的写法,将各种组件混合到⼀起。
import { defineStore } from 'pinia'import { reactive } from 'vue'export const userStore = defineStore('userStore',()=>{//相当于是stateconst userInfo = reactive({username:"---"})//相当于actionfunction changeUsername(value:string){if(value && value.length<10){userInfo.username = value}}//相当于gettersfunction getUsername():string{return userInfo.username.toUpperCase()}//不⽤区分什么类型,返回出去的就可以⽤
return {userInfo,changeUsername,getUsername}})
在App.vue中,也可以像使⽤普通对象⼀样,使⽤store中的⽅法和对象
<template><div id="app"><!-- 注意对象拆包过程 --><h1>Hello {{ res.userInfo.value.username }}</h1></div></template><!-- vue3写法 --><script lang="ts" setup >//获取storeimport { userStore } from "@/store/user2";
import { storeToRefs } from "pinia";const user = userStore()//修改store中的值
//通过action进⾏修改 推荐⽅式
user.changeUsername('roy')// 获取store中的数据
console.log(user.userInfo)// 通过getter获取state数据 推荐⽅式
console.log(user.getUsername())//混合式store转成Ref后,只有数据的reflet res = storeToRefs(user)console.log(res)</script><style></style>
这种⽅式相当于在做MVC开发时,将Controller\Service\Dao这些组件写到⼀起。
复杂项⽬当中,不太建议这样⽤。但是如果别⼈这么⽤了,你要能看懂。
六、快速上⼿Element-Plus
ElementUI是饿了么开源的⼀套基于Vue2的经典UI库。针对Vue3,升级成为了ElementPlus。熟悉ElementPlus 库,不但可以节省⼤量前端项⽬的开发时间,同时也是深⼊了解Vue3复杂组件开发的很好途径。
ElementPlus官⽹地址: https://element-plus.gitee.io/zh-CN/ 。 ⽬前还在迭代更新过程当中。
1、安装ElementPlus
npm install element-plus --save
2、引⼊ElementPlus
import { createApp } from 'vue'import App from './App.vue'import ElementPlus from 'element-plus'import 'element-plus/dist/index.css'const app = createApp(App)app.use(ElementPlus)app.mount('#app')
3、使⽤ElementPlus组件 参⻅官⽅⽂档
<template><div class="mb-4"><el-button>Default</el-button><el-button type="primary">Primary</el-button><el-button type="success">Success</el-button>
<el-button type="info">Info</el-button><el-button type="warning">Warning</el-button><el-button type="danger">Danger</el-button></div></template><!-- vue3写法 --><script lang="ts" setup >import { ElButton } from 'element-plus';</script><style></style>
ElementUI针对Vue2还推出过⼀个vue-admin模版,⾥⾯案例更丰富,集成度也更⾼。很多企业内部项⽬都 可以直接拿来⽤。有兴趣可以了解⼀下。⽽针对Vue3,只推出了⼀个将ElementUI从Vue2升级到Vue3的迁 移⼯具,尚未提供Vue3的版本。
类似的UI框架还有很多,给⼤家例举⼏个常⽤的
Ant Design Vue( https://www.antdv.com/docs/vue/getting-started-cn) 经典⽼框架
Native UI( https://www.naiveui.com/zh-CN/light) 仅⽀持Vue3的⼀个新的UI库
Tdesign( https://tdesign.tencent.com/) 腾讯开源的前端UI框架 包含桌⾯与移动端
NutUI( https://nutui.jd.com/#/) 京东开源的前端UI框架
install element-plus --save
2、引⼊ElementPlus```javascriptimport { createApp } from 'vue'import App from './App.vue'import ElementPlus from 'element-plus'import 'element-plus/dist/index.css'const app = createApp(App)app.use(ElementPlus)app.mount('#app')
3、使⽤ElementPlus组件 参⻅官⽅⽂档
<template><div class="mb-4"><el-button>Default</el-button><el-button type="primary">Primary</el-button><el-button type="success">Success</el-button>
<el-button type="info">Info</el-button><el-button type="warning">Warning</el-button><el-button type="danger">Danger</el-button></div></template><!-- vue3写法 --><script lang="ts" setup >import { ElButton } from 'element-plus';</script><style></style>
ElementUI针对Vue2还推出过⼀个vue-admin模版,⾥⾯案例更丰富,集成度也更⾼。很多企业内部项⽬都 可以直接拿来⽤。有兴趣可以了解⼀下。⽽针对Vue3,只推出了⼀个将ElementUI从Vue2升级到Vue3的迁 移⼯具,尚未提供Vue3的版本。
类似的UI框架还有很多,给⼤家例举⼏个常⽤的
Ant Design Vue( https://www.antdv.com/docs/vue/getting-started-cn) 经典⽼框架
Native UI( https://www.naiveui.com/zh-CN/light) 仅⽀持Vue3的⼀个新的UI库
Tdesign( https://tdesign.tencent.com/) 腾讯开源的前端UI框架 包含桌⾯与移动端
NutUI( https://nutui.jd.com/#/) 京东开源的前端UI框架
uvuewui( https://www.uviewui.com/) 适合移动端uni-app开发