vue2升级Vue3--native、对inheritAttrs作用做以解释、声明的prop属性和未声明prop的属性

native取消

Vue 3 中,v-on 的 .native 修饰符已经被移除。在 Vue 2 中,.native 修饰符用于在组件的根元素上监听原生 DOM 事件,但在 Vue 3 中,这一行为发生了变化。

在 Vue 3 中,所有未在子组件的 emits 选项中定义的事件监听器,都会自动作为原生事件绑定到子组件的根元素上。因此,你不再需要使用 .native 修饰符来监听原生事件。

javascript 复制代码
//vue2代码:
<my-component @click.native="handleClick" />
//vue3代码
<my-component @click="handleClick" />

注意:
子组件的 emits 选项:如果子组件中定义了 emits,并且事件名与原生事件冲突,Vue 会优先将事件视为自定义事件

例如:

javascript 复制代码
export default {
  emits: ['click']
}

在这种情况下,@click 会被视为自定义事件,而不是原生事件。

inheritAttrs: false 的影响:如果子组件中设置了 inheritAttrs: false,则父组件传递的事件监听器不会自动绑定到子组件的根元素上。

inheritAttrs

在 Vue 3 中,inheritAttrs 是一个组件选项,用于控制是否将父组件传递的未声明为 props 的属性(attributes)自动继承到子组件的根元素上。它的默认值是 true
inheritAttrs: true 的行为

当 inheritAttrs 设置为 true 时:

父组件传递给子组件的未声明为 props 的属性(包括 class、style、事件监听器等)会自动绑定到子组件的根元素上。

如果子组件是单根节点组件,这些属性会被正确绑定到根元素上。

如果子组件是多根节点组件(片段组件),则会抛出警告。
inheritAttrs: false 的行为

当 inheritAttrs 设置为 false 时:

子组件的根元素不会自动继承父组件传递的未声明为 props 的属性。

这些未声明的属性可以通过 $attrs 访问,并可以手动绑定到子组件内部的其他元素上

在多根节点组件中,不会抛出警告。

使用场景

  • 默认行为(inheritAttrs: true):
    适用于大多数场景,尤其是子组件的根元素需要直接继承父组件传递的属性时。
    例如,子组件是一个简单的包装器,直接将属性透传到内部元素上。
  • 禁用继承(inheritAttrs: false):
    当子组件的根元素不是目标元素,或者需要将属性绑定到内部的其他元素时,应设置为 false。
    例如,子组件内部有多个元素,需要将属性绑定到特定的内部元素上

demo子组件:

javascript 复制代码
<template>
  <div class="input-wrapper">
    <input v-bind="$attrs" />
  </div>
</template>

如果 inheritAttrs: true,父组件传递的 class、style 等属性会被绑定到子组件的根元素 <div> 上。

如果 inheritAttrs: false,父组件传递的属性不会绑定到根元素,但可以通过 $attrs 手动绑定到 <input> 上。

声明的prop属性和未声明prop的属性

在 Vue 中,父组件传递给子组件的属性(attributes)可以分为两类:声明为 props 的属性 和 未声明为 props 的属性。理解这两者的区别对于掌握 Vue 的组件通信机制非常重要。
声明为 props 的属性

props 是子组件明确声明的属性,用于接收父组件传递的数据。它们是组件之间通信的主要方式之一。父组件传递的值会通过子组件的 props 被接收,并在子组件内部使用。

子组件 ChildComponent.vue:

javascript 复制代码
<template>
  <div>
    <p>姓名: {{ name }}</p>
    <p>年龄: {{ age }}</p>
  </div>
</template>

<script>
export default {
  props: {
    name: String,
    age: Number
  }
};
</script>

父组件:

javascript 复制代码
<template>
  <ChildComponent :name="parentName" :age="parentAge" />
</template>

<script>
import ChildComponent from './ChildComponent.vue';

export default {
  components: { ChildComponent },
  data() {
    return {
      parentName: "Kimi",
      parentAge: 25
    };
  }
};
</script>

在这个例子中,name 和 age 是子组件声明的 props,父组件通过 :name 和 :age 将数据传递给子组件。
未声明为 props 的属性

除了声明为 props 的属性外,父组件还可以传递其他属性(包括普通属性、事件监听器、class、style 等)。这些属性没有在子组件的 props 中声明,因此不会被子组件直接接收,但它们仍然会被传递到子组件中。

父组件:

javascript 复制代码
<template>
  <ChildComponent
    :name="parentName"
    :age="parentAge"
    class="child-class"
    style="color: red"
    @custom-event="handleCustomEvent"
    title="This is a title"
  />
</template>

子组件:

javascript 复制代码
<template>
  <div>
    <p>姓名: {{ name }}</p>
    <p>年龄: {{ age }}</p>
  </div>
</template>

<script>
export default {
  props: {
    name: String,
    age: Number
  }
};
</script>

在这个例子中:

:name 和 :age 是声明为 props 的属性。

class="child-class"、style="color: red"、@custom-event="handleCustomEvent" 和 title="This is a title" 是未声明为 props 的属性。

未声明属性的处理

1、自动继承到根元素(默认行为)

当子组件的 inheritAttrs 设置为 true(默认值)时,这些未声明的属性会自动绑定到子组件的根元素上。例如:

javascript 复制代码
<template>
  <div>
    <p>姓名: {{ name }}</p>
    <p>年龄: {{ age }}</p>
  </div>
</template>

在这种情况下,class="child-class"、style="color: red" 和 title="This is a title" 会被自动绑定到子组件的根元素 <div> 上。
2、手动处理未声明的属性

如果子组件的 inheritAttrs 设置为 false,未声明的属性不会自动绑定到根元素上,但可以通过 $attrs 访问这些属性,并手动绑定到其他元素上。

javascript 复制代码
<template>
  <div>
    <input v-bind="$attrs" />
  </div>
</template>

<script>
export default {
  props: {
    name: String,
    age: Number
  },
  inheritAttrs: false
};
</script>

在这种情况下,class、style 和 title 等属性会被绑定到 上,而不是根元素 <div>。

相关推荐
啵啵学习3 分钟前
浏览器插件,提示:此扩展程序未遵循 Chrome 扩展程序的最佳实践,因此已无法再使用
前端·chrome·浏览器·插件·破解
Mintopia9 分钟前
# 使用 Three.js 实现带随机障碍物的小车行驶模拟
前端·javascript·three.js
Mintopia10 分钟前
图形学与坐标系入门教学
前端·javascript·计算机图形学
独立开阀者_FwtCoder25 分钟前
8年磨一剑,Koa 3.0 正式发布!看看带来了哪些新功能
前端·javascript·后端
Frankabcdefgh32 分钟前
初中级前端面试全攻略:自我介绍模板、项目讲解套路与常见问答
前端·面试·职场和发展
2401_8784545334 分钟前
thymeleaf的使用和小结
前端·javascript·学习
brzhang42 分钟前
宝藏发现:Sim Studio,一款让AI工作流搭建变简单的开源利器
前端·后端·github
2301_7994049142 分钟前
AJAX 介绍
前端·ajax·axios
拖孩1 小时前
【Nova UI】十三、打造组件库之按钮组件(中):样式雕琢全攻略
前端·javascript·vue.js
好_快1 小时前
Lodash源码阅读-sortedUniqBy
前端·javascript·源码阅读