一、创建Vue3.0工程
1.使用 vue-cli 创建
官方文档:https://cli.vuejs.org/zh/guide/creating-a-project.html#vue-create
## 查看@vue/cli版本,确保@vue/cli版本在4.5.0以上
vue --version
## 安装或者升级你的@vue/cli
npm install -g @vue/cli
## 创建
vue create vue_test
## 启动
cd vue_test
npm run serve
2.使用 vite 创建
官方文档:https://v3.cn.vuejs.org/guide/installation.html#vite
vite官网:https://vitejs.cn
- 什么是vite?—— 新一代前端构建工具。
- 优势如下:
- 开发环境中,无需打包操作,可快速的冷启动。
- 轻量快速的热重载(HMR)。
- 真正的按需编译,不再等待整个应用编译完成。
## 创建工程
npm init vite-app <project-name>
## 进入工程目录
cd <project-name>
## 安装依赖
npm install
## 运行
npm run dev
二、常用 Composition API
官方文档: https://v3.cn.vuejs.org/guide/composition-api-introduction.html
1.setup
- 理解:Vue3.0中一个新的配置项,值为一个函数。
- setup是所有Composition API(组合API)“ 表演的舞台 ”。
- 组件中所用到的:数据、方法等等,均要配置在setup中。
- setup函数的两种返回值:
- 若返回一个对象,则对象中的属性、方法, 在模板中均可以直接使用。(重点关注!)
- 若返回一个渲染函数:则可以自定义渲染内容。(了解)
- 注意点:
- 尽量不要与Vue2.x配置混用
- Vue2.x配置(data、methos、computed…)中可以访问到setup中的属性、方法。
- 但在setup中不能访问到Vue2.x配置(data、methos、computed…)。
- 如果有重名, setup优先。
- setup不能是一个async函数,因为返回值不再是return的对象, 而是promise, 模板看不到return对象中的属性。(后期也可以返回一个Promise实例,但需要Suspense和异步组件的配合)
- 尽量不要与Vue2.x配置混用
<script>
import { reactive, ref } from 'vue'
export default {
name: 'App',
setup() {
let obj = reactive({name:'张三'})
let obj2 = ref({name:'张三'})
const change = () => {
obj = 666
// obj2.value = {name:'李四'}
}
return {
obj, obj2,
change
}
}
}
</script>
2.ref函数
- 作用: 定义一个响应式的数据
- 语法:
const xxx = ref(initValue)
- 创建一个包含响应式数据的引用对象(reference对象,简称ref对象)。
- JS中操作数据:
xxx.value
- 模板中读取数据: 不需要.value,直接:
<div>{{xxx}}</div>
- 备注:
- 接收的数据可以是:基本类型、也可以是对象类型。
- 基本类型的数据:响应式依然是靠
Object.defineProperty()
的get
与set
完成的。 - 对象类型的数据:内部 “ 求助 ” 了Vue3.0中的一个新函数——
reactive
函数。
<script>
import { ref } from 'vue'
export default {
name: 'App',
setup() {
//用ref定义响应式数据
let name = ref('张三')
const change = () => {
//ref定义的数据需要.value才能修改
name.value = '李四'
}
return {
name
}
}
}
</script>
3.reactive函数
- 作用: 定义一个对象类型的响应式数据(基本类型不要用它,要用
ref
函数) - 语法:
const 代理对象= reactive(源对象)
接收一个对象(或数组),返回一个代理对象(Proxy的实例对象,简称proxy对象) - reactive定义的响应式数据是“深层次的”。
- 内部基于 ES6 的 Proxy 实现,通过代理对象操作源对象内部数据进行操作。
<script>
import { reactive,ref } from 'vue'
export default {
name: 'App',
setup() {
/*
reactive 通常用来定义应用数据类型,reactive是基于es6的proxy
ref 定义基本数据类型,ref基于Object.defineProperty
*/
let person = reactive({name:'张三',age:18})
let arr = reactive([1,2,3,4])
let data = reactive({
arr:[1,2,3,4]
})
const change = () => {
//修改reactive的值不需要.value
person.type = 'ui设计师'
person.name = '李四'
}
const changeArr = () => {
//不可以这样赋值 会让arr丢失响应式
arr = []
//想要清空可以使用splice方法
arr.splice(0,arr.length)
//这样是可以的 不会丢失响应式
data.arr = []
}
return {
person,
change,
changeArr
}
}
}
</script>
4.Vue3.0中的响应式原理
vue2.x的响应式
-
实现原理:
-
对象类型:通过
Object.defineProperty()
对属性的读取、修改进行拦截(数据劫持)。 -
数组类型:通过重写更新数组的一系列方法来实现拦截。(对数组的变更方法进行了包裹)。
Object.defineProperty(data, 'count', { get () {}, set () {} })
-
-
存在问题:
- 新增属性、删除属性, 界面不会更新。
- 直接通过下标修改数组, 界面不会自动更新。
Vue3.0的响应式
- 实现原理:
- 通过Proxy(代理): 拦截对象中任意属性的变化, 包括:属性值的读写、属性的添加、属性的删除等。
- 通过Reflect(反射): 对源对象的属性进行操作。
- MDN文档中描述的Proxy与Reflect:
-
Proxy:https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Proxy
-
Reflect:https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Reflect
new Proxy(data, { // 拦截读取属性值 get (target, prop) { return Reflect.get(target, prop) }, // 拦截设置属性值或添加新属性 set (target, prop, value) { return Reflect.set(target, prop, value) }, // 拦截删除属性 deleteProperty (target, prop) { return Reflect.deleteProperty(target, prop) } }) proxy.name = 'tom'
-
5.reactive对比ref
- 从定义数据角度对比:
- ref用来定义:基本类型数据。
- reactive用来定义:对象(或数组)类型数据。
- 备注:ref也可以用来定义对象(或数组)类型数据, 它内部会自动通过
reactive
转为代理对象。
- 从原理角度对比:
- ref通过
Object.defineProperty()
的get
与set
来实现响应式(数据劫持)。 - reactive通过使用Proxy来实现响应式(数据劫持), 并通过Reflect操作源对象内部的数据。
- ref通过
- 从使用角度对比:
- ref定义的数据:操作数据需要
.value
,读取数据时模板中直接读取不需要.value
。 - reactive定义的数据:操作数据与读取数据:均不需要
.value
。
- ref定义的数据:操作数据需要
6.setup的两个注意点
-
setup执行的时机
- 在beforeCreate之前执行一次,this是undefined。
-
setup的参数
- props:值为对象,包含:组件外部传递过来,且组件内部声明接收了的属性。
- context:上下文对象
- attrs: 值为对象,包含:组件外部传递过来,但没有在props配置中声明的属性, 相当于
this.$attrs
。 - slots: 收到的插槽内容, 相当于
this.$slots
。 - emit: 分发自定义事件的函数, 相当于
this.$emit
。
- attrs: 值为对象,包含:组件外部传递过来,但没有在props配置中声明的属性, 相当于
<script>
import { reactive, ref } from 'vue'
export default {
name: 'Demo',
props:['msg'],
mounted(){
console.log('this.props :>> ', this.$props.msg); //你好
},
setup(props, context) {
/**
* props:值为对象,包含:组件外部传递过来,且组件内部声明接收了的属性。
* context:上下文对象
*/
let sum = ref(17)
let person = reactive({
name:'张三',
age:18
})
console.log(props.msg) //你好
//使用emit给父组件传递数据
context.emit('hello','你也好')
return {
sum:ref(person.age),
person
}
}
}
</script>
7.计算属性与监视
1.computed函数
-
与Vue2.x中computed配置功能一致
-
写法
import {computed} from 'vue' setup(){ ... //计算属性——简写 let fullName = computed(()=>{ return person.firstName + '-' + person.lastName }) //计算属性——完整 let fullName = computed({ get(){ return person.firstName + '-' + person.lastName }, set(value){ const nameArr = value.split('-') person.firstName = nameArr[0] person.lastName = nameArr[1] } }) }
2.watch函数
-
与Vue2.x中watch配置功能一致
-
两个小“坑”:
- 监视reactive定义的响应式数据时:oldValue无法正确获取、强制开启了深度监视(deep配置失效)。
- 监视reactive定义的响应式数据中某个属性时:deep配置有效。
import { ref,reactive ,watch } from 'vue'
export default {
setup () {
let sum = ref(0)
let msg = ref('msg')
let person = reactive({
name:'张三',
age:18,
job:{
salary:20
}
})
//immediate:true 自动调用一次
//deep:true 深度监听
//1、 监视ref
watch(sum,(newVal,oldVal)=>{
console.log('变化变化 :>> ',newVal,oldVal);
})
//2、 监听多个数据
watch([sum,msg],([newVal1,newVal2],[oldVal1,oldVal2])=>{
console.log('新数据 :>> ', newVal1,newVal2);
console.log('老数据 :>> ',oldVal1,oldVal2);
})
//3、 监听对象
//BUG : 在监听对象的时候 新数据和老数据是一样的,无法正确的获取老数据
//1.注意:此处无法正确的获取oldValue
//2.注意:强制开启了深度监视(deep配置无效)
watch(person,(newVal,oldVal)=>{
console.log('person变化了 :>> ', newVal,oldVal);
},{deep:true}) //此处deep配置无效
//4、 监听 reactive定义的某一个属性
//注意,你不能直接侦听响应式对象的属性值,需要写成个函数 ()=> person.age
watch(()=>person.age,(newVal,oldVal)=>{
console.log('newVal,oldVal:>> ',newVal,oldVal);
})
//5、 监听 reactive中的某些属性
watch([()=>person.age,()=>person.name],([newVal1,newVal2],[oldVal1,oldVal2])=>{
console.log('新数据 :>> ', newVal1,newVal2);
console.log('老数据 :>> ',oldVal1,oldVal2);
})
//6、 特殊情况
watch(()=>person.job,(newValue,oldValue)=>{
console.log('person的job变化了',newValue,oldValue)
},{deep:true}) //此处由于监视的是reactive素定义的对象中的某个属性,所以deep配置有效
return {
sum,msg,person
}
}
}
3.watchEffect函数
-
watch
的套路是:既要指明监视的属性,也要指明监视的回调。 -
watchEffect
的套路是:不用指明监视哪个属性,监视的回调中用到哪个属性,那就监视哪个属性。 -
watchEffect
有点像computed
:- 但
computed
注重的计算出来的值(回调函数的返回值),所以必须要写返回值。 - 而
watchEffect
更注重的是过程(回调函数的函数体),所以不用写返回值。
//watchEffect所指定的回调中用到的数据只要发生变化,则直接重新执行回调。 watchEffect(()=>{ const x1 = sum.value const x2 = person.age console.log('watchEffect配置的回调执行了') })
- 但
8.生命周期
- Vue3.0中可以继续使用Vue2.x中的生命周期钩子,但有有两个被更名:
beforeDestroy
改名为beforeUnmount
destroyed
改名为unmounted
- Vue3.0也提供了 Composition API 形式的生命周期钩子,与Vue2.x中钩子对应关系如下:
beforeCreate
===>setup()
created
=======>setup()
beforeMount
===>onBeforeMount
mounted
=======>onMounted
beforeUpdate
===>onBeforeUpdate
updated
=======>onUpdated
beforeUnmount
==>onBeforeUnmount
unmounted
=====>onUnmounted
9.自定义hook函数
-
什么是
hook
?—— 本质是一个函数,把setup函数中使用的Composition API
进行了封装。 -
类似于
vue2.x
中的混入mixin
。 -
自定义
hook
的优势: 复用代码, 让setup
中的逻辑更清楚易懂。
// usePoint.js内部
import {reactive,onMounted,onBeforeUnmount } from 'vue'
export default function (){
const point = reactive({
x:0,
y:0
})
const pointEvent = (e:any)=>{
point.x = e.pageX
point.y = e.pageY
}
onMounted(()=>{
window.addEventListener('click',pointEvent)
console.log('111 :>> ', 111);
})
onBeforeUnmount(()=>{
window.removeEventListener('click',pointEvent)
})
return point
}
//使用时引入
import {reactive, ref,onMounted,onBeforeUnmount } from 'vue'
import usePoint from './hooks/usePoint'
export default {
setup() {
let sum = ref(0)
let point = usePoint()
console.log('point :>> ', point);
return {
sum,
point
}
}
}
10.toRef和toRefs
- 作用:创建一个 ref 对象,其value值指向另一个对象中的某个属性。
- 语法:
const name = toRef(person,'name')
- 应用: 要将响应式对象中的某个属性单独提供给外部使用时。
- 扩展:
toRefs
与toRef
功能一致,但可以批量创建多个 ref 对象,语法:toRefs(person)
- 注意:
toRef
和torefs
是引用了源对象
import { reactive,toRef,toRefs } from 'vue'
export default {
setup () {
let person = reactive({
name:'张三',
age:18,
job:{
salary:20
}
})
//toRefs 将一个响应式对象转换为一个普通对象,这个普通对象的每个属性都是指向源对象相应属性的 ref。
// 每个单独的 ref 都是使用 toRef() 创建的
//去出person对象里的name属性,并且是响应式的
//toRef和torefs是引用了源对象,所以修改了name1,proson内部的name也会跟着改变
let name1 = toRef(person,'name')
name1.value = '李四'
console.log(person.name) //李四
return {
//toRefs就是多个
...toRefs(person),
person,
name1
}
}
}
三、其它 Composition API
1.shallowReactive 与 shallowRef
-
shallowReactive:只处理对象最外层属性的响应式(浅响应式)。
-
shallowRef:如果接受一个对象类型的数据不会去求助
reactive
将其转为响应式。 -
什么时候使用?
- 如果有一个对象数据,结构比较深, 但变化时只是外层属性变化 ===>
shallowReactive
。 - 如果有一个对象数据,后续功能不会修改该对象中的属性,而是生新的对象来替换 ===>
shallowRef
。
- 如果有一个对象数据,结构比较深, 但变化时只是外层属性变化 ===>
import { ref,reactive , toRef, toRefs, shallowReactive, shallowRef } from 'vue'
export default {
setup () {
// let person = shallowReactive({ //只有第一层具备响应式
let person = reactive({
name:'张三',
age:18,
job:{
salary:20
}
})
/**
* shallowRef和ref的区别在于 shallowRef如果接受一个对象类型的数据不会去求助reactive将其转为响应式
* sum.value打印结果是Object而非Proxy
*/
const sum = shallowRef({
value:0
})
console.log('sum :>> ', sum);
return {
...toRefs(person),
person,
sum
}
}
}
2.readonly 与 shallowReadonly
- readonly: 让一个响应式数据变为只读的(深只读)。
- shallowReadonly:让一个响应式数据变为只读的(浅只读)。
- 应用场景: 不希望数据被修改时。
import { ref,reactive , toRefs, shallowReactive, readonly } from 'vue'
export default {
setup () {
let sum = ref<number>(0)
let person = reactive({
name:'张三',
age:18,
job:{
salary:20
}
})
console.log('person :>> ', person);
/**
* readonly包裹后 数据将不能被修改
* shallowReactive 浅层次的只读
* Set operation on key "age" failed: target is readonly
*/
person = readonly(person)
console.log('person :>> ', person);
sum = readonly(sum)
return {
...toRefs(person),
sum
}
}
}
3.toRaw 与 markRaw
- toRaw:
- 作用:将一个由
reactive
生成的响应式对象转为普通对象。 - 使用场景:用于读取响应式对象对应的普通对象,对这个普通对象的所有操作,不会引起页面更新。
- 作用:将一个由
- markRaw:
- 作用:标记一个对象,使其永远不会再成为响应式对象。
- 应用场景:
- 有些值不应被设置为响应式的,例如复杂的第三方类库等。
- 当渲染具有不可变数据源的大列表时,跳过响应式转换可以提高性能。
import { ref,reactive , toRefs,toRaw, markRaw } from 'vue'
export default {
setup () {
let sum = ref<number>(0)
let person = reactive({
name:'张三',
age:18,
job:{
salary:20
},
car:{}
})
function showRawPerson(){
// toRaw把响应式对象转换成没被vue处理过的普通对象
//只能用来转换reactive定义的响应式对象
const p = toRaw(person)
console.log(p)
}
function addCar(){
let car = {name:'奔驰',price:40}
//内部标记了一个__v_skip:true
person.car = markRaw(car) // markRaw把一个对象标记为不需要响应式
}
return {
sum,
person,
showRawPerson,
addCar,
...toRefs(person),
}
}
}
4.customRef
-
作用:创建一个自定义的 ref,并对其依赖项跟踪和更新触发进行显式控制。
-
实现防抖效果:
<template> <input type="text" v-model="keyword"> <h3>{{keyword}}</h3> </template> <script> import {ref,customRef} from 'vue' export default { name:'Demo', setup(){ // let keyword = ref('hello') //使用Vue准备好的内置ref //自定义一个myRef function myRef(value,delay){ let timer //通过customRef去实现自定义 return customRef((track,trigger)=>{ return{ get(){ track() //告诉Vue这个value值是需要被“追踪”的 return value }, set(newValue){ clearTimeout(timer) timer = setTimeout(()=>{ value = newValue trigger() //告诉Vue去更新界面 },delay) } } }) } let keyword = myRef('hello',500) //使用程序员自定义的ref return { keyword } } } </script>
5.provide 与 inject
-
作用:实现祖与后代组件间通信
-
套路:父组件有一个
provide
选项来提供数据,后代组件有一个inject
选项来开始使用这些数据 -
具体写法:
-
祖组件中:
import Child from './components/Child.vue' import { reactive,provide } from 'vue'; export default { components:{ Child }, setup () { let car = reactive({ name:'奔驰', price:'40w' }) // provide('car',car) return {car} } }
-
后代组件中:
import { inject } from 'vue'; export default { setup () { let car = inject('car') console.log('car :>> ', car); return {car} } }
-
6.响应式数据的判断
isRef
: 检查一个值是否为一个 ref 对象isReactive
: 检查一个对象是否是由reactive
创建的响应式代理isReadonly
: 检查一个对象是否是由readonly
创建的只读代理isProxy
: 检查一个对象是否是由reactive
或者readonly
方法创建的代理
import { reactive,ref,readonly ,isReactive,isProxy,isRef,isReadonly} from 'vue';
export default {
setup () {
let car = reactive({
name:'奔驰',
price:'40w'
})
let sum = ref(0)
let car2 = readonly(car)
console.log('isRef :>> ', isRef(sum)); //true
console.log('isReadonly :>> ', isReadonly(car2)); //true
console.log('isReactive :>> ', isReactive(car)); //true
console.log('isProxy :>> ', isProxy(car)); //true
return {car}
}
}
五、新的组件
1.Fragment
- 在Vue2中: 组件必须有一个根标签
- 在Vue3中: 组件可以没有根标签, 内部会将多个标签包含在一个Fragment虚拟元素中
- 好处: 减少标签层级, 减小内存占用
2.Teleport
-
什么是Teleport?——
Teleport
是一种能够将我们的组件html结构移动到指定位置的技术。<teleport to="移动位置"> <div v-if="isShow" class="mask"> <div class="dialog"> <h3>我是一个弹窗</h3> <button @click="isShow = false">关闭弹窗</button> </div> </div> </teleport>
3.Suspense
-
等待异步组件时渲染一些额外内容,让应用有更好的用户体验
-
使用步骤:
-
异步引入组件
import {defineAsyncComponent} from 'vue' const Child = defineAsyncComponent(()=>import('./components/Child.vue'))
-
使用
Suspense
包裹组件,并配置好default
与fallback
<template> <div class="app"> <h3>我是App组件</h3> <Suspense> <template v-slot:default> <Child/> </template> <template v-slot:fallback> <h3>加载中.....</h3> </template> </Suspense> </div> </template>
-
六、其他
1.全局API的转移
-
Vue 2.x 有许多全局 API 和配置。
-
例如:注册全局组件、注册全局指令等。
//注册全局组件 Vue.component('MyButton', { data: () => ({ count: 0 }), template: '<button @click="count++">Clicked {{ count }} times.</button>' }) //注册全局指令 Vue.directive('focus', { inserted: el => el.focus() }
-
-
Vue3.0中对这些API做出了调整:
-
将全局的API,即:
Vue.xxx
调整到应用实例(app
)上2.x 全局 API( Vue
)3.x 实例 API ( app
)Vue.config.xxxx app.config.xxxx Vue.config.productionTip 移除 Vue.component app.component Vue.directive app.directive Vue.mixin app.mixin Vue.use app.use Vue.prototype app.config.globalProperties
-
2.其他改变
-
data选项应始终被声明为一个函数。
-
过度类名的更改:
-
Vue2.x写法
.v-enter, .v-leave-to { opacity: 0; } .v-leave, .v-enter-to { opacity: 1; }
-
Vue3.x写法
.v-enter-from, .v-leave-to { opacity: 0; } .v-leave-from, .v-enter-to { opacity: 1; }
-
-
移除keyCode作为 v-on 的修饰符,同时也不再支持
config.keyCodes
-
移除
v-on.native
修饰符-
父组件中绑定事件
<my-component v-on:close="handleComponentEvent" v-on:click="handleNativeClickEvent" />
-
子组件中声明自定义事件
<script> export default { emits: ['close'] } </script>
-
-
移除过滤器(filter)
过滤器虽然这看起来很方便,但它需要一个自定义语法,打破大括号内表达式是 “只是 JavaScript” 的假设,这不仅有学习成本,而且有实现成本!建议用方法调用或计算属性去替换过滤器。
-
…
七、三个宏函数
在setup语法糖中需要使用defineProps
和defineEmits
来进行父子组件的数据传递
1.defineProps()
<script setup>
//defineProps接受的参数和配置项中的props一致
const props = defineProps({
// 基础类型检查
// (给出 `null` 和 `undefined` 值则会跳过任何类型检查)
propA: Number,
// 多种可能的类型
propB: [String, Number],
// 必传,且为 String 类型
propC: {
type: String,
required: true
},
// Number 类型的默认值
propD: {
type: Number,
default: 100
},
// 对象类型的默认值
propE: {
type: Object,
// 对象或数组的默认值
// 必须从一个工厂函数返回。
// 该函数接收组件所接收到的原始 prop 作为参数。
default(rawProps) {
return { message: 'hello' }
}
},
// 自定义类型校验函数
propF: {
validator(value) {
// The value must match one of these strings
return ['success', 'warning', 'danger'].includes(value)
}
},
// 函数类型的默认值
propG: {
type: Function,
// 不像对象或数组的默认,这不是一个工厂函数。这会是一个用来作为默认值的函数
default() {
return 'Default function'
}
}
})
</script>
2.defineEmits()
我们在 <template>
中使用的 $emit
方法不能在组件的 <script setup>
部分中使用,但 defineEmits()
会返回一个相同作用的函数供我们使用
<script setup>
const emit = defineEmits(['inFocus', 'submit'])
function buttonClick() {
emit('submit')
}
</script>
3.defineExpose()
使用<script setup>
的组件是默认关闭的——即通过模板引用或者 $parent
链获取到的组件的公开实例,不会暴露任何在<script setup>
中声明的绑定。
可以通过 defineExpose
编译器宏来显式指定在 <script setup>
组件中要暴露出去的属性:
//子组件中需要暴露的数据
<script setup>
import { ref } from 'vue'
const num = 1
const fn = () => {
return '我是子组件中的方法'
}
defineExpose({
num,
fn
})
</script>
父组件中使用ref获取
<script lang="ts" setup>
import Child from './components/Child.vue'
import { ref ,onMounted } from 'vue';
const child = ref()
let num = ref(0)
onMounted(() => {
console.log(child.value.num) // 1
child.value.fn() // '我是子组件中的方法'
})
</script>