【Vue第十七章】透传 Attributes

简介: 【Vue第十七章】透传 Attributes

“透传 attribute”指的是传递给一个组件,却没有被该组件声明为 props 或 emits 的 attribute 或者 v-on 事件监听器。最常见的例子就是 class、style 和 id。

数字化管理平台

Vue3+Vite+VueRouter+Pinia+Axios+ElementPlus

权限系统-商城

个人博客地址

一、根组件继承

默认情况下,当一个组件以单个元素为根作渲染时,透传的 attribute 会自动被添加到根元素上(直接自动继承)。

MyButton 组件模板

<template>
  <button class="btn" style="border:solid 1px #e7e7e7;"  @click="btnClick">click me</button>
</template>

一个父组件使用了这个组件,并且传入了 class

<MyButton class="large" style="outline:none;" @click="clickHandle"/>

最后渲染出的 DOM 结果是

# 一个根组件,添加的 class、style 直接作用于根元素上(直接继承)
# 如果一个子组件的根元素已经有了 class、style,它会和从父组件上继承的值合并;event 同理,继承和根元素的事件都会执行。
<button class="btn large" style="border:solid 1px #e7e7e7;outline:none;">click me</button>

二、深层组件继承

有些情况下,一个组件(如:MyButton)会在根节点上渲染另一个组件(如:BaseButton)。此时 MyButton 接收的透传attribute会直接继续传给 BaseButton。如下 MyButton 组件:

<template>
  <BaseButton />
</template>

三、模板中访问透传 attribute

3.1 禁用 Attributes 继承

如果你不想要一个组件自动地继承 attribute,你可以在组件选项中设置 inheritAttrs: false。

<script>
    export default {
      inheritAttrs: false
    }
</script>
<script setup>
  // 部分逻辑
</script>

禁用 attribute 继承的场景:attribute 需要应用在根节点以外的其他元素上。

3.2 模板中访问透传 attribute

透传进来的 attribute 可以在模板表达式中直接用 $attrs 访问到。这个 $attrs 对象包含了除组件所声明的 props 和 emits 之外的所有其他 attribute,例如 class,style,v-on 监听器等等。

<span>透传属性: {{ $attrs }}</span>

MyButton组件模板

<template>
  <div class="btn-wrapper">
        <button class="btn">click me</button>
    </div>
</template>
<script>
  exports default {
    inheritAttrs:false
  }
<script>
<script setup>
  // 组合式 API 代码
</script>
<template>
  <div class="btn-wrapper">
    <button class="btn" v-bind="$attrs">click me</button>
    </div>
</template>

3.3 多根节点的 Attributes 继承

和单根节点组件有所不同,有着多个根节点的组件没有自动 attribute 透传行为。如果 $attrs 没有被显式绑定,Vue 不知道要将 attribute 透传到哪里,所以将会抛出一个运行时警告。

<BaseLayout id="custom-layout" @click="changeValue" />

如下 BaseLayout 组件模板:

<template>
  <header>...</header>
    <main>...</main>
    <footer>...</footer>
</template>

如果 $attrs 被显式绑定,则不会有警告:

<header>...</header>
<main v-bind="$attrs">...</main>
<footer>...</footer>

四、在 JavaScript 中访问透传 Attributes

如果需要,你可以在 <script setup> 中使用 useAttrs() API 来访问一个组件的所有透传 attribute:

<script setup>
    import { useAttrs } from 'vue'
    const attrs = useAttrs()
</script>

需要注意的是,虽然这里的 attrs 对象总是反映为最新的透传 attribute,但它并不是响应式的 (考虑到性能因素)。你不能通过侦听器去监听它的变化。如果你需要响应性,可以使用 prop。或者你也可以使用 onUpdated() 使得在每次更新时结合最新的 attrs 执行副作用。


相关文章
|
1月前
|
JavaScript
Vue中如何实现兄弟组件之间的通信
在Vue中,兄弟组件可通过父组件中转、事件总线、Vuex/Pinia或provide/inject实现通信。小型项目推荐父组件中转或事件总线,大型项目建议使用Pinia等状态管理工具,确保数据流清晰可控,避免内存泄漏。
200 2
|
4月前
|
人工智能 JavaScript 算法
Vue 中 key 属性的深入解析:改变 key 导致组件销毁与重建
Vue 中 key 属性的深入解析:改变 key 导致组件销毁与重建
636 0
|
4月前
|
JavaScript UED
用组件懒加载优化Vue应用性能
用组件懒加载优化Vue应用性能
|
3月前
|
JavaScript 安全
在 Vue 中,如何在回调函数中正确使用 this?
在 Vue 中,如何在回调函数中正确使用 this?
140 0
|
3月前
|
人工智能 JSON JavaScript
VTJ.PRO 首发 MasterGo 设计智能识别引擎,秒级生成 Vue 代码
VTJ.PRO发布「AI MasterGo设计稿识别引擎」,成为全球首个支持解析MasterGo原生JSON文件并自动生成Vue组件的AI工具。通过双引擎架构,实现设计到代码全流程自动化,效率提升300%,助力企业降本增效,引领“设计即生产”新时代。
293 1
|
4月前
|
JavaScript 前端开发 开发者
Vue 自定义进度条组件封装及使用方法详解
这是一篇关于自定义进度条组件的使用指南和开发文档。文章详细介绍了如何在Vue项目中引入、注册并使用该组件,包括基础与高级示例。组件支持分段配置(如颜色、文本)、动画效果及超出进度提示等功能。同时提供了完整的代码实现,支持全局注册,并提出了优化建议,如主题支持、响应式设计等,帮助开发者更灵活地集成和定制进度条组件。资源链接已提供,适合前端开发者参考学习。
403 17
|
4月前
|
JavaScript 前端开发 UED
Vue 表情包输入组件实现代码及详细开发流程解析
这是一篇关于 Vue 表情包输入组件的使用方法与封装指南的文章。通过安装依赖、全局注册和局部使用,可以快速集成表情包功能到 Vue 项目中。文章还详细介绍了组件的封装实现、高级配置(如自定义表情列表、主题定制、动画效果和懒加载)以及完整集成示例。开发者可根据需求扩展功能,例如 GIF 搜索或自定义表情上传,提升用户体验。资源链接提供进一步学习材料。
227 1
|
6月前
|
JavaScript
vue实现任务周期cron表达式选择组件
vue实现任务周期cron表达式选择组件
857 4
|
5月前
|
JavaScript 数据可视化 前端开发
基于 Vue 与 D3 的可拖拽拓扑图技术方案及应用案例解析
本文介绍了基于Vue和D3实现可拖拽拓扑图的技术方案与应用实例。通过Vue构建用户界面和交互逻辑,结合D3强大的数据可视化能力,实现了力导向布局、节点拖拽、交互事件等功能。文章详细讲解了数据模型设计、拖拽功能实现、组件封装及高级扩展(如节点类型定制、连接样式优化等),并提供了性能优化方案以应对大数据量场景。最终,展示了基础网络拓扑、实时更新拓扑等应用实例,为开发者提供了一套完整的实现思路和实践经验。
617 77
|
6月前
|
缓存 JavaScript 前端开发
Vue 基础语法介绍
Vue 基础语法介绍