$attrs:“透传神器”【Vue3】

55 阅读2分钟

在日常的组件开发中,你是否遇到过这样的困境:为了适配多场景,子组件声明了大量冗余 Props;父组件新增一个属性,子组件就得跟着修改;跨组件传递数据时,中间组件被迫做 “无用转发”?其实 Vue 早已内置了解决方案 —— $attrs 属性。它以 “无侵入透传” 为核心,无需冗余声明,一键承接父组件的属性与事件,让组件扩展性瞬间拉满。今天我们就从基础定义、核心应用场景两个维度,结合实战代码,彻底掌握这个 “透传神器”。

一、基础定义:$attrs 到底是什么?

1. 核心概念

$attrs 是 Vue 实例的内置属性,本质是一个 对象。指的是传递给一个组件,却没有被该组件声明为 props 或 emits 的 attribute 或者 v-on 事件监听器。最常见的例子就是 classstyle 和 id

简单理解:父组件给子组件的 “额外配置包”,子组件无需逐一 “签收”(声明 Props),可直接开箱即用或转发给其他元素 / 组件。

2. 关键特性

  • 自动收集:父组件新增属性 / 事件时,子组件无需修改代码,$attrs 自动收录;
  • 无侵入透传:不破坏子组件原有逻辑,透传过程不影响内部状态;
  • 支持多级转发:父组件的属性可通过中间组件一键透传给孙组件,无需中间组件手动转发;
  • 兼容所有类型:普通属性(如 placeholder)、原生事件(如 @click)等均可透传。
  • $attrs会被默认自动被添加到根元素上(额外注意!!!!);

3. Vue官方参考文章:

cn.vuejs.org/guide/compo…

4.基础代码示例

父组件:

image.png

子组件:

image.png

即使子组件并没有声明任何一个props,父组件传递的所有属性和事件默认也都已经被透传绑定至了子组件之上,但是需要注意,此时不显示指定attrs的绑定位置,会发现被绑定至了子组件的根元素上面,可能并不是我们想要的实际效果(看实际封装场景),看下图:

image.png

image.png

这时候,我们可以手动指定attrs的实际绑定位置

image.png

image.png 然后打开控制台可以看见,属性和事件已经被绑定至了我们的目标位置。

实际这样就结束了嘛?NoNoNo...接下来还有坑可以踩:

1.input和change事件都被触发两次

image.png

2.根元素的样式也会应用上透传样式

image.png

而这一切都是因为Vue的默认透传行为决定的,所以需要禁止掉这个行为

解决方案:inheritAttrs: false

image.png

接下来看最终效果:

image.png

image.png

关于样式透传的补充:

由于scoped的隔离属性,当父组件想要透传的样式,是在父组件中声明,目标元素却不是子组件的根元素时,不额外处理会出现样式失效的问题:

问题:

image.png

image.png

解决方案:

1.在子组件中提前先声明样式类名 image.png

image.png

2.引入基础样式文件

3.父组件中使用deep关键字声明相关穿透样式(推荐)

4.不使用scoped(不推荐)