本文已参与【新人创作礼】活动,一起开启掘金创作之旅。
在Vue3中setup被称为组合式API表演的舞台,可见其重要性与地位,在小编第一篇中浅谈过setup的使用,这节可以进阶学习一下setup中两个注意点:执行时机以及其参数。
一、拉开序幕的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和异步组件的配合) 以下仅为代码展示,可自行复制到文件中验证,详细请看:juejin.cn/post/707859…
-
<template>
<h1>一个人的信息</h1>
<h2>姓名:{{name}}</h2>
<h2>年龄:{{age}}</h2>
<h2>性别:{{sex}}</h2>
<h2>a的值是:{{a}}</h2>
<button @click="sayHello">说话(Vue3所配置的——sayHello)</button>
<br>
<br>
<button @click="sayWelcome">说话(Vue2所配置的——sayWelcome)</button>
<br>
<br>
<button @click="test1">测试一下在Vue2的配置中去读取Vue3中的数据、方法</button>
<br>
<br>
<button @click="test2">测试一下在Vue3的setup配置中去读取Vue2中的数据、方法</button>
</template>
<script>
import {ref} from 'vue'
export default {
name: 'App',
data() {
return {
sex:'男',
a:100
}
},
methods: {
sayWelcome(){
alert('欢迎来到北京')
},
test1(){
console.log(this.sex)
console.log(this.name)
console.log(this.age)
console.log(this.sayHello)
}
},
async setup(){
//数据
let name = ref('张三')
let age = ref(18)
let a = ref(200)
//方法
function sayHello(){
alert(`我叫${name},我${age}岁了,你好啊!`)
}
function test2(){
console.log(name)
console.log(age)
console.log(sayHello)
console.log(this.sex)
console.log(this.sayWelcome)
}
//返回一个对象(常用)
return {
name,
age,
sayHello,
test2,
a
}
//返回一个函数(渲染函数)
// return ()=> h('h1','尚硅谷')
}
}
</script>
setup的两个注意点
-
setup执行的时机
- 在beforeCreate之前执行一次,this是undefined。
-
setup的参数
-
props:值为对象,包含:组件外部传递过来,且组件内部声明接收了的属性。
-
context:上下文对象
- attrs: 值为对象,包含:组件外部传递过来,但没有在props配置中声明的属性, 相当于
this.$attrs。 - slots: 收到的插槽内容, 相当于
this.$slots。 - emit: 分发自定义事件的函数, 相当于
this.$emit。
- attrs: 值为对象,包含:组件外部传递过来,但没有在props配置中声明的属性, 相当于
-
1、在具体展示之前先回顾一下Vue2中的vm.$attrs和vm.$slots
vm.$attrs:当一个组件没有声明props时,父组件传递过来的参数包含在$attrs中;vm.$slots:用来存放父组件传递给子组件的插槽内容。 父组件:
<template>
<div id="app">
<!-- 给子组件传递mag、city两个参数 -->
<Demo msg="你好啊" city="北京">
<!-- 给子组件传递两个具名插槽sh、sz -->
<template v-slot:sh>
<span>上海</span>
</template>
<template v-slot:sz>
<span>深圳</span>
</template>
</Demo>
</div>
</template>
<script>
import Demo from "./components/Demo";
export default {
name: "App",
components: { Demo },
};
</script>
<style>
#app {
width: 300px;
height: 300px;
background-color: yellow;
}
</style>
子组件:
<template>
<div id="demo">
<h2>Demo组件</h2>
<slot name="sz"></slot>
</div>
</template>
<script>
export default {
name: "Demo",
props: ["msg"], // 只接收了msg参数,没接收city
mounted() {
console.log(this);
},
};
</script>
<style>
#demo {
width: 150px;
height: 150px;
background-color: rgb(0, 255, 64);
}
</style>
会发现,没有接收的city参数被放在了
vm.$attrs中,被props接收了的参数直接放在vm实例对象身上,而vm.$slots身上是父组件传递过来的两个具名插槽。
2、分析setup参数
Demo组件:
<template>
<h1>一个人的信息</h1>
<h2>姓名:{{person.name}}</h2>
<h2>年龄:{{person.age}}</h2>
<button @click="test">测试触发一下Demo组件的Hello事件</button>
</template>
<script>
import {reactive} from 'vue'
export default {
name: 'Demo',
props:['msg'], // Vue2和Vue3都可用
emits:['hello'], // 声明自定义事件
setup(props,context){
console.log('-setup-props-',props)
console.log('-setup-context-',context)
console.log('-setup-context.attrs-',context.attrs) //相当与Vue2中的$attrs
console.log('-setup-context.emit-',context.emit) //触发自定义事件的。
console.log('-setup-context.slots-',context.slots) //插槽
//数据
let person = reactive({
name:'张三',
age:18
})
//方法
function test(){
context.emit('hello',666)
}
//返回一个对象(常用)
return {
person,
test
}
}
}
</script>
- props:因为没接收city参数,因此setup上的props参数只展示msg值,且是响应式的;
2.context:具体每一项对应含义上述已经说明过,注意emit触发自定义事件需要在配置项中配置
emits:['hello'],且传参数可以在父组件自定义事件中取到。
function showHelloMsg(value){
alert(`你好啊,你触发了hello事件,我收到的参数是:${value}!`)
}