透传属性 (透传 attribute)
什么是透传属性(透传 attribute)? 传递给一个组件,却没有被该组件声明为 props 或 emits 的 attribute 或者是事件监听器,例如 class style id 等。
属性继承
当一个组件以单个元素作渲染时,透传的属性会自动被添加到根元素上。
// 组件
<script lang="ts" setup>
import { ref } from 'vue'
</script><template><div class="container"><h1>这是深入组件-属性透传</h1></div>
</template><style lang="scss" scoped>
.container {
}
</style>// 父组件
<script lang="ts" setup>
import { ref } from 'vue'
import Com16 from '@/components/demo/Com16.vue'
</script><template><div class="container"><Com16 class="big"></Com16></div>
</template><style lang="scss" scoped>
.container {
}
</style>
对 class 和 style 的合并
如果一个子组件的根元素已经有了 class 或 style attribute,它会和从父组件上继承的值合并。
// 子组件中
<h1 class="h111">这是深入组件-属性透传</h1>
同样的规则也适用于 v-on 事件监听器
当父子组件都定义了事件则都会出发,并且是从内到外相应
//子组件
<script lang="ts" setup>
import { ref } from 'vue'const fun1 = () => {console.log('我是组件事件')
}
</script><template><div class="container h1"><h1 @click="fun1">这是深入组件-属性透传</h1></div>
</template><style lang="scss" scoped>
.container {
}
</style>//父组件
<script lang="ts" setup>
import { ref } from 'vue'
import Com16 from '@/components/demo/Com16.vue'const fun2 = () => {console.log('我是父组件事件')
}
</script><template><div class="container"><Com16 @click="fun2" class="big"></Com16></div>
</template><style lang="scss" scoped>
.container {
}
</style>
禁用 Attributes 继承
如果你不想要一个组件自动地继承 attribute,你可以在组件选项中设置
inheritAttrs: false。
<script lang="ts" setup>
defineOptions({inheritAttrs: false
})
import { ref } from 'vue'const fun1 = () => {console.log('我是组件事件')
}
</script>
确实 class 没有 big 了
这些透传进来的 attribute 可以在模板的表达式中直接用 $attrs 访问到。
template Fallthrough attribute: {{ $attrs }} 这个 $attrs 对象包含了除组件所声明的 props 和 emits 之外的所有其他 attribute,例如 class,style,v-on 监听器等等。
注意:
-
和 props 有所不同,透传 attributes 在 JavaScript 中保留了它们原始的大小写,所以像 foo-bar 这样的一个 attribute 需要通过 $attrs['foo-bar'] 来访问。
-
像 @click 这样的一个 v-on 事件监听器将在此对象下被暴露为一个函数 $attrs.onClick。
多根节点的 Attributes 继承
和单根节点组件有所不同,有着多个根节点的组件没有自动 attribute 透传行为。如果 $attrs 没有被显式绑定,将会抛出一个运行时警告。
在 JavaScript 中访问透传 Attributes
如果需要,你可以在 <script setup> 中使用 useAttrs() API 来访问一个组件的所有透传 attribute:
<script setup>
import { useAttrs } from 'vue'const attrs = useAttrs()
</script>
需要注意的是,虽然这里的 attrs 对象总是反映为最新的透传 attribute,但它并不是响应式的 (考虑到性能因素)。