学习
实践
活动
工具
TVP
写文章
专栏首页前端杂货铺-Gopal【Vue进阶】——如何实现组件属性透传?

【Vue进阶】——如何实现组件属性透传?

场景

很多时候,我们需要基于一些 UI 框架进行二次封装,这里以 Element UI 为例,封装一个 Input 组件类似如下:

<!-- Input 组件 -->
<template>
  <div>
    <el-input v-model="myc"></el-input>
  </div>
</template>

这个时候,我们需要保证外面能够直接设置 el-input 的属性,比如 placeholderclearable 等等,最好能够透传

直接设置

第一反应,我们想到的就是,通过 props 传值进来,然后一个个的设置,如下所示:

<template>
  <div>
    <el-input v-model="myc"
      :placeholder="configProps.placeholder"
      :clearable="configProps.clearable"></el-input>
  </div>
</template>

上面就是通过传入的 props —— configProps,来设置 placeholderclearable

但是这样代码可读性差、维护不方便、而且还会有遗漏的点

通过 v-bind="$attrs" 进行透传

其实我们在一个组件内部没有声明任何 prop 时,调用该组件,传入相关的属性,会直接将属性传到根节点上,如下:

<!-- Input 组件 -->
<template>
  <div class="hello input-con">
    <label>输入框:</label>
    <el-input ></el-input>
  </div>
</template>
<script>
export default {
  name: 'Input'
}
</script>

调用上面的组件

<Input placeholder="我是默认值"
        :clearable="true"/> 

那怎么才能将属性传递到内部的 el-input 组件中呢,直接给 el-input 加一个 v-bind="$attrs" 即可。

先看官方对 vm.$attrs 的定义:

包含了父作用域中不作为 prop 被识别 (且获取) 的 attribute 绑定 (class 和 style 除外)。当一个组件没有声明任何 prop 时,这里会包含所有父作用域的绑定 (class 和 style 除外),并且可以通过 v-bind="$attrs" 传入内部组件——在创建高级别的组件时非常有用。

大白话:调用一个组件的时候传入属性 (classstyle 除外),而且不在该组件内部的 props 中声明,就可以通过 v-bind="$attrs" 传入该组件的内部组件

比如,上面调用 Input 组件的时候传入了 placeholderclearable,然后 Input 组件内部并没有声明 placeholderclearable 去接收这两个 props,这个时候可以通过 v-bind="$attrs" 传入内部组件 el-input

具体的代码示例如下

<template>
  <div>
    <el-input v-bind="$attrs" ></el-input>
  </div>
</template>

看到的结果如下:

完整的代码示例放在了 codesandbox 中了,可以在线看下——[普通的 v-bind="

attrs"](https://codesandbox.io/s/shuxingtouchuanattrs-2c4wr?file=/src/App.vue "普通的 v-bind="

attrs""),建议大家自己试下

动态组件如何透传

虽然上面可以解决了大部分的问题了,但同事发现并不能满足场景,主要是他用了动态组件 component。他的想法是通过 JSON Schema 的方式生成表单,其中应用了动态组件 component,这是一个很棒的想法,相信现在很多公司应该都有类似的做法。

我们来看下他的实现思路:

<!-- 动态组件,根据 JSON 配置 调用 Input 或者 Select 组件等等 -->
<template>
  <div class="hello">
    <div v-for="(config, index) in configJsonArr" :key="config.type + index">
      <!-- 动态组件,根据配置中的 Type 来决定调用的是 Input 还是 Select -->
      <component :is="config.type" :configProps="config.props"></component>
    </div>
  </div>
</template>

<script>
import Input from './Input'
import Select from './Select'

export default {
  name: 'Config',
  components: {
    Input,
    Select
  },
  props: {
   // 动态组件 JSON schema 的配置
    configJsonArr: {
      type: Array,
      required: true,
      default: () => []
    }
  }
}
</script>

其中 configJsonArr 为如下:

[{
  type: 'Input',
  props: {
    placeholder: '我是默认值',
    clearable: true
  }
}, {
  type: 'Select',
  props: {
    placeholder: '我是默认值'
  }
}, {
  type: 'Input',
  props: {
    placeholder: '我是默认值',
    suffixIcon: 'el-icon-delete'
  }
}]

其中 Input 组件类似如下:

<template>
  <div class="hello input-con">
    <label>输入框:</label>
    <el-input ></el-input>
  </div>
</template>

<script>
export default {
  name: 'Input'
}
</script>

这个时候,假如我们直接在 el-input 设置 v-bind="$attrs" 是不行的,原因在于动态组件传入的属性 configProps 是一个对象,而不是解构后的对象属性,那怎么办呢?

直接使用 v-bind 解构

Vuev-bind 是可以直接传入一个对象的所有 property 的。

如果你想要将一个对象的所有 property 都作为 prop 传入,你可以使用不带参数的 v-bind (取代 v-bind:prop-name)。例如,对于一个给定的对象 post

post: {
  id: 1,
  title: 'My Journey with Vue'
}

下面的模板:

<blog-post v-bind="post"></blog-post>

等价于:

<blog-post
  v-bind:id="post.id"
  v-bind:title="post.title"
></blog-post>

这里提供一下具体的沙箱代码[1]

除此之外,还有哪些方法呢?

渲染函数大显神威

说来惭愧,之前很少用到渲染函数 (render) 函数,来了新的公司之后,发现这边用得还挺多(大家都好厉害),自己也学习了一下。

上面提到的在标签中没法解构属性,在渲染(render)函数中就可以解决,先来大致的了解下渲染函数,这里主要还是参考官方文档[2]

渲染函数中的第一个参数是 createElement,其接受的参数如下(注意第一个和第二个参数):

第一个参数可以是一个 HTML 标签名、组件选项对象,或者 resolve 了上述任何一种的一个 async 函数。必填项。这里我们挂载的是我们的 Input 组件等。

// @returns {VNode}
createElement(
  // {String | Object | Function}
  // 一个 HTML 标签名、组件选项对象,或者
  // resolve 了上述任何一种的一个 async 函数。必填项。
  'div',

  // {Object}
  // 一个与模板中 attribute 对应的数据对象。可选。
  {
    // (详情见下一节)
  },

  // {String | Array}
  // 子级虚拟节点 (VNodes),由 `createElement()` 构建而成,
  // 也可以使用字符串来生成“文本虚拟节点”。可选。
  [
    '先写一些文字',
    createElement('h1', '一则头条'),
    createElement(MyComponent, {
      props: {
        someProp: 'foobar'
      }
    })
  ]
)

我们再将重点放在第二个参数 Object 中,我们可以在这个 Object 中指定相关的属性值,比如 classstyleattrs(普通的 HTML attribute)、组件的 props【这个就是我们这一期重点关注的属性值】....。具体如下:

{
  // 与 `v-bind:class` 的 API 相同,
  // 接受一个字符串、对象或字符串和对象组成的数组
  'class': {
    foo: true,
    bar: false
  },
  // 与 `v-bind:style` 的 API 相同,
  // 接受一个字符串、对象,或对象组成的数组
  style: {
    color: 'red',
    fontSize: '14px'
  },
  // 普通的 HTML attribute
  attrs: {
    id: 'foo'
  },
  // 组件 prop
  props: {
    myProp: 'bar'
  },
  // DOM property
  domProps: {
    innerHTML: 'baz'
  },
  // 事件监听器在 `on` 内,
  // 但不再支持如 `v-on:keyup.enter` 这样的修饰器。
  // 需要在处理函数中手动检查 keyCode。
  on: {
    click: this.clickHandler
  },
  // 仅用于组件,用于监听原生事件,而不是组件内部使用
  // `vm.$emit` 触发的事件。
  nativeOn: {
    click: this.nativeClickHandler
  },
  // 自定义指令。注意,你无法对 `binding` 中的 `oldValue`
  // 赋值,因为 Vue 已经自动为你进行了同步。
  directives: [
    {
      name: 'my-custom-directive',
      value: '2',
      expression: '1 + 1',
      arg: 'foo',
      modifiers: {
        bar: true
      }
    }
  ],
  // 作用域插槽的格式为
  // { name: props => VNode | Array<VNode> }
  scopedSlots: {
    default: props => createElement('span', props.text)
  },
  // 如果组件是其它组件的子组件,需为插槽指定名称
  slot: 'name-of-slot',
  // 其它特殊顶层 property
  key: 'myKey',
  ref: 'myRef',
  // 如果你在渲染函数中给多个元素都应用了相同的 ref 名,
  // 那么 `$refs.myRef` 会变成一个数组。
  refInFor: true
}

可以看到,我们可以在上面这个对象中设置 props 属性的值的时候,将它解构掉就可以了。

核心代码实现,如下所示:

// 这其实就是一个组件
const CompFormItem = {
  components: {
    Input, Select
  },
  name: 'FormItem',
  props: {
   // 传入配置
    configJson: {
      required: true
    }
  },
  // h 实际上就是 createElement 参数
  render (h) {
   // 第一个参数就是配置中的 type,也就是我们的组件名称
    return h(`${this.configJson.type}`, {
      props: {
       // 针对 props 进行解构
        ...this.configJson.props || {}
      },
      attrs: {
       // 针对 attrs 进行解构
        ...this.configJson.props || {}
      }
    })
  }
}

这样我们再在 Input 组件中写上 v-bind="$attrs" 就可以了

<template>
  <div class="hello input-con">
    <label>输入框:</label>
    <el-input v-bind="$attrs"></el-input>
  </div>
</template>

<script>
export default {
  name: 'Input'
}
</script>

结束语

以上通过渲染函数就可以完全解决透传属性的问题了,具体的我也放在了 codesandbox 中了——动态组件透传属性[3]。也提供一下 GitHub 地址[4]【这么用心,求个赞应该可以吧?】

其实我也还在想,是不是还有其他的方法?欢迎大家评论提出自己的想法和建议

往期优秀文章推荐

  • 前端应该知道的 HTTP 知识【金九银十必备】[5]
  • 最强大的 CSS 布局 —— Grid 布局[6]
  • 如何用 Typescript 写一个完整的 Vue 应用程序[7]
  • 前端应该知道的web调试工具——whistle[8]

参考资料

[1]

沙箱代码: https://codesandbox.io/s/ecstatic-darkness-ssi7y?file=/src/components/Config.vue

[2]

官方文档: https://cn.vuejs.org/v2/guide/render-function.html

[3]

动态组件透传属性: https://codesandbox.io/s/optimistic-booth-6zgx9?file=/src/components/Input.vue

[4]

GitHub 地址: https://github.com/GpingFeng/learn-vue

[5]

前端应该知道的 HTTP 知识【金九银十必备】: https://juejin.im/post/6864119706500988935

[6]

最强大的 CSS 布局 —— Grid 布局: https://juejin.im/post/6854573220306255880

[7]

如何用 Typescript 写一个完整的 Vue 应用程序: https://juejin.im/post/6860703641037340686

[8]

前端应该知道的web调试工具——whistle: https://juejin.im/post/6861882596927504392

文章分享自微信公众号:
前端杂货铺

本文参与 腾讯云自媒体分享计划 ,欢迎热爱写作的你一起参与!

作者:Gopal
原始发表时间:2020-09-07
如有侵权,请联系 cloudcommunity@tencent.com 删除。
登录 后参与评论
0 条评论

相关文章

  • vue 实现父子组件传值和子父组件传值

    用emit函数进行传参,emit函数用于防止子组件越权。向父组件传参的时候有两个内容,一个是父组件的方法,,这个方法用于监听子组件内容发生变化,及时能传给父组件...

    全栈程序员站长
  • Vue使用eventBus实现兄弟组件传值

    在src下新建个文件夹建个js,在这里我取名为VueEvent.js,在store文件夹下,在这个文件中实例化vue

    明知山
  • angular框架如何实现父子组件传值、非父子组件传值

    什么是父子组件? 组件的父子关系是相对来说的,即在一个A组件中嵌入了B组件,那么在这一层关系中,A组件是B组件的父组件,B组件是A组件的子组件。 看下面两幅...

    全栈程序员站长
  • 一个合格的中级前端工程师应该掌握的 20 个 Vue 技巧

    之前写过一篇文章,关于 Vue 属性透传的,文章中我列举了很多种方法去实现属性透传。其中包括直接设置 props,v-bind="$attrs",render ...

    GopalFeng
  • vue使用provide和inject实现父组件与子孙组件传值

    明知山
  • 【Vue进阶】手把手教你在 Vue 中使用 JSX

    JSX 是一种 Javascript 的语法扩展,JSX = Javascript + XML,即在 Javascript 里面写 XML,因为 JSX 的这个...

    GopalFeng
  • Vue 3 任意传送门——Teleport

    2020 年 9 月 18 号,尤大大发布了 Vue 3.0,代号 One Piece。同时中英文版本的文档相继出来,笔者也去通读了一遍,发现很多宝藏,其中有个...

    GopalFeng
  • Vue父子组件之间的传值及父子组件之间相互调用属性或方法

    父组件向子组件传值是通过属性的方式 传值,传的值可以是任意类型,甚至可以是父组件的方法或者父组件对象本身。为方便理解可以简单将父组件向子组件传值按以下步骤实现。

    赵云龙龙
  • Vue3.0实现todolist之父子组件之间传值

    在child子组件的标签上通过动态绑定属性的方式 :属性名 属性名=一个属性的值 通常是一样的

    王小婷
  • vue事件发射与接收(可实现页面传值和非父子组件传值)

    1).给data添加一个 名字为eventhub 的空vue对象,就可以在任何组件都可以调用事件发射接收的方法了,在main.js中添加:

    honey缘木鱼
  • 【Vue 进阶】从 slot 到无渲染组件

    插槽(slot)通俗的理解就是“占坑”,在组件模板中占有位置,当使用该组件的时候,可以指定各个坑的内容。也就是我们常说的内容分发

    GopalFeng
  • 计算属性是如何被Vue实现的

    无论是面试过程还是日常业务开发,相信大多数前端开发者对于 Vue 的应用已经熟能生巧了。

    19组清风
  • 一个透传技巧,治好了我的重度代码洁癖

    透传是一个通讯层面的概念,指的是在通讯中不管传输的业务内容如何,只负责将传输的内容由源地址传输到目的地址,而不对业务数据内容做任何改变。

    Tusi
  • 一个两年半小前端的年终总结

    大家好,我是 Gopal。最近工作些许繁忙,利用闲暇之余,记录一下我的 2020,展望 2021

    GopalFeng
  • Vue进阶(四十七):面试必备:2022 Vue经典面试题总结(含答案)

    MVVM是Model-View-ViewModel的缩写。MVVM是一种设计思想。Model 层代表数据模型,也可以在Model中定义数据修改和操作的业务逻辑;...

    全栈程序员站长
  • 焕然一新的 Vue3 中文文档来了!

    大家好,我是LBJ,最近参与了 Vue 3新文档的翻译和校验工作 (vuejs/docs contributor[3] 和 docs-zh-cn contrib...

    @超人
  • 焕然一新的 Vue3 中文文档来了!

    大家好,我是LBJ,最近参与了 Vue 3新文档的翻译和校验工作 (vuejs/docs contributor[3] 和 docs-zh-cn contrib...

    前端达人
  • 焕然一新的 Vue 3 中文文档来了

    我们知道 Vue 3 新文档 ( vuejs.org ) 已经发布一个多月了,但那是英文版的,不知道你看了没?

    PHP开发工程师

扫码关注腾讯云开发者

领取腾讯云代金券