详解 vue3 组件通信defineProps、defineEmits、defineExpose

前言

在做vue项目中,总会遇到组件引入,在嵌套组件中我们的父级组件中引入子级组件中的值,或者在子组件中我们使用父组件中的值。当我们遇到这样的场景我们应该怎么做,在vue2.0中,我们使用propsemit进行父子之间的通信,兄弟之间用事件中央总线(event bus);在vue3.2的语法中我们则使用definePropsdefineEmits来声明props和emit,用其进行组件之间的传值,那么接下来,我们来看看。

defineProps

  1. 用于组件通信中父级组件给子级组件传值,其用来声明props,其接收值为props选项相同的值;
  2. 默认支持常见的类型检查,在ts下,我们需要明确变量的类型,类型经常是我们的自定义类型;
  3. 只能在<script setup>中使用;
  4. 不需要被导入即可使用,它会在编译<script setup>语法块时一同编译掉;
  5. 必须在<script setup>的顶层使用,不可以在<script setup>的局部变量中引用;
  6. 不可以访问 <script setup> 中定义的其他变量,因为在编译时整个表达式都会被移到外部的函数中。
/ 父级组件使用自定义属性向下传递值
<div class="home">
  <HelloWorld :msg="msg"/>
</div>
<script setup>
import HelloWorld from '@/components/HelloWorld'
/**
* 父级组件传递一个自定义属性
* 和props传递方式一样
* @type {string}
*/
const msg = '张三';
</script>
// 子级组件使用defineProps接收值
<div class="hello">
  <h1>{{ props.msg }}</h1>
</div>
<script setup>
/**
* 无需导入直接使用
* 写在<script setup>里面
* defineProps传入的对象key值就是传递的属性,父级传入msg,那么子级接收msg,定义其类型
* @type {Readonly<ExtractPropTypes<{msg: StringConstructor}>>}
* 以下props就是defineProps返回的对象
*/
const props = defineProps({
  msg: String,
});
</script>
<script setup>
 
/**
* 如果写在局部
* 报错:Uncaught ReferenceError: defineProps is not defined*/
const btn = function (){
  const props = defineProps({
    msg: String,
  });
}
</script>

defineProps

defineEmits

  1. 用于组件通信中子级组件向父级组件传值,其用来声明emit,其接收内容于emit选项一致;
  2. 只能在<script setup>中使用;
  3. 不需要被导入即可使用,它会在编译<script setup>语法块时一同编译掉;
  4. 必须在<script setup>的顶层使用,不可以在<script setup>的局部变量中引用。
// 子组件
<div class="hello">
  <button @click="btn">点击</button>
</div>
<script setup>
/**
 * 在子组件中使用defineEmits来声明emits
 * 其接收值与emit选项一致
 * 传入的选项在全局变量
 * emits函数是defineEmits返回值
 * defineEmits函数参数是个数组,数组内容是自定义函数名称
 * emits函数第一个参数是自定义事件名称,第二个参数是需要传递的内容
 * defineEmits如果放在局部。不在全局。则报错
 * defineEmits is not defined
 * @type {EmitFn<string[]>}
 */
const emits = defineEmits(['handle']);
const btn = () => {
  emits('handle', '张三')
}
</script>
// 父级组件中
<div class="home">
  <HelloWorld @handle="handleClick"/>
</div
<script setup>
import HelloWorld from '@/components/HelloWorld'
/**
 * 在父级组件中,使用子级的自定义事件,
 * [email protected]=事件名称
 * 函数中data是个形参,为子级传递过来的数据
 * @param data
 */
const handleClick = function (data) {
  console.log(data)
}
</script>

defineExpose

  1. 组件暴露自己的属性以及方法,去供外部使用,常用于父子组件关系;
  2. 在vue3.2中 setup 挂载到 script (ref默认是关闭的) 是不能直接使用 ref 取到子组件的方法和变量,需要使用defineExpose
// 不在子组件设置defineExpose
// 子级组件代码
<div class="hello">
  <h1>{{name}}</h1>
</div>
<script setup>
  const name = '张三'
</script>
// 父级组件代码
<div class="home">
  <HelloWorld ref="childrenDom"/>
  <button @click='handleClick'>点击</button>
</div>
<script setup>
/**
 * 父级通常使用ref来定义虚拟dom,用来操作子组件
 * 那么这个时候打印ref的value值,我们拿不到子组件的属性以及方法
 */
import HelloWorld from '@/components/HelloWorld'
import { ref } from "vue";
const childrenDom = ref(null)
const handleClick = function () {
  console.log(childrenDom.value)
}
</script>

defineExpose

// 子组件设置defineExpose
// 子组件代码
<div class="hello">
  <h1>{{name}}</h1>
</div>
<script setup>
/**
 * 子组件中设置defineExpose等同于将子组件中的方法以及属性全部做出暴漏
 * 只需要父级通过ref去获取就可以
 * @type {string}
 */
const name = '张三';
const btn = function () {
  console.log(111)
}
defineExpose({
  name,
  btn
})
</script>
// 父级组件代码
<div class="home">
  <HelloWorld ref="childrenDom"/>
  <button @click='handleClick'>点击</button>
</div>
<script setup>
/**
 * 父级通常使用ref来定义虚拟dom,用来操作子组件
 * 那么这个时候打印ref的value值,我们拿不到子组件的属性以及方法
 */
import HelloWorld from '@/components/HelloWorld'
import { ref } from "vue";
const childrenDom = ref(null)
const handleClick = function () {
  console.log(childrenDom.value)
}
</script>

defineExpose

以上就是前端vue3.2组件通信详解(defineExpose、defineEmits、defineProps)的使用方式,感谢阅读。

「点点赞赏,手留余香」

1

给作者打赏,鼓励TA抓紧创作!

微信微信 支付宝支付宝

还没有人赞赏,快来当第一个赞赏的人吧!

声明:
1. 本站所有文章教程及资源素材均来源于网络与用户分享或为本站原创,仅限用于学习和研究。
2. 如果内容损害你的权益请联系客服QQ:1642748312给予处理。
码云笔记 » 详解 vue3 组件通信defineProps、defineEmits、defineExpose

发表回复

IT互联网行业相关广告投放 更专业 更精准

立即查看 联系我们