四、【Vue3】——setup不得不说的两个注意点

在Vue3中setup被称为组合式API表演的舞台，可见其重要性与地位，在小编第一篇中浅谈过setup的使用，这节可以进阶学习一下setup中两个注意点：执行时机以及其参数。

一、拉开序幕的setup

1. 理解：Vue3.0中一个新的配置项，值为一个函数。

2. setup是所有Composition API（组合API） “ 表演的舞台 ” 。

3. 组件中所用到的：数据、方法等等，均要配置在setup中。

4. setup函数的两种返回值：

   1. 若返回一个对象，则对象中的属性、方法, 在模板中均可以直接使用。（重点关注！）
   2. 若返回一个渲染函数：则可以自定义渲染内容。（了解）

5. 注意点：

   1. 尽量不要与Vue2.x配置混用

      • Vue2.x配置（data、methos、computed...）中可以访问到setup中的属性、方法。
      • 但在setup中不能访问到Vue2.x配置（data、methos、computed...）。
      • 如果有重名, setup优先。

   2. 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。

1、在具体展示之前先回顾一下Vue2中的vm.$attrs和vm.$slots

1. vm.$attrs：当一个组件没有声明props时，父组件传递过来的参数包含在$attrs中；
2. 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>

1. props:因为没接收city参数，因此setup上的props参数只展示msg值，且是响应式的；

2.context：具体每一项对应含义上述已经说明过，注意emit触发自定义事件需要在配置项中配置emits:['hello']，且传参数可以在父组件自定义事件中取到。

function showHelloMsg(value){
    alert(`你好啊，你触发了hello事件，我收到的参数是:${value}！`)
}