Vue render 函数与 createElement 参数详解

作者:云间搭桥

时间:2026-10-24

浏览:623

本文详解 Vue 中 render 函数的作用及其核心参数 createElement。通过解析 VNode 虚拟节点、三个关键参数及 data 对象的高级属性,结合单文件组件代码示例,帮助开发者理解在 template 无法满足复杂场景时,如何高效使用 render 函数构建动态模板。

文章目录

render 函数作用

初次阅读 Vue 渲染函数文档时可能会感到困惑,经过反复研读与实践后思路逐渐清晰。建议结合官方文档阅读,本文内容基于文档说明并融入了个人理解。

注:本文所有代码均在单文件组件中编写。代码地址

render 函数作用

render 函数与 template 类似,均用于创建 HTML 模板。但在某些场景中,使用 template 会导致代码冗长繁琐且存在大量重复,此时采用 render 函数是更优选择。

官网示例:子组件需根据父组件传递的 level 值(1-6)动态决定渲染 h1 至 h6 标签。具体代码可参考官方文档。

render 函数讲解

render 函数即渲染函数,它本身是一个函数,其参数也是一个函数——即 createElement,本文重点解析 createElement 参数。

render 函数的返回值(VNode)

VNode(即虚拟节点),代表我们要渲染的实际节点。

render 函数的参数(createElement)

createElement 是 render 函数的参数,它本身也是一个函数,并接收三个参数。

createElement 函数的返回值(VNode)

createElement 函数的返回值是 VNode(即虚拟节点)。

createElement 函数的参数(三个)

第一个参数为 HTML 标签字符串、组件选项对象,或解析上述类型的异步函数。类型:{String | Object | Function}。此为必需参数。

第二个参数为包含模板相关属性的数据对象,可在 template 中使用这些特性。类型:{Object}。此为可选参数。 第三个参数为子虚拟节点 (VNodes),由 createElement() 构建而成,也可使用字符串生成“文本虚拟节点”。类型:{String | Array}。此为可选参数。

结合代码


/**
 * render: 渲染函数
 * 参数: createElement
 * 参数类型: Function
 */
 render: function (createElement) {
  let _this = this['$options'].parent // 我这个是在 .vue 文件的 components 中写的,这样写才能访问this
  let _header = _this.$slots.header  // $slots: vue中所有分发插槽,不具名的都在default里
 
  /**
  * createElement 本身也是一个函数,它有三个参数
  * 返回值: VNode,即虚拟节点
  * 1. 一个 HTML 标签字符串,组件选项对象,或者解析上述任何一种的一个 async 异步函数。必需参数。{String | Object | Function} - 就是你要渲染的最外层标签
  * 2. 一个包含模板相关属性的数据对象你可以在 template 中使用这些特性。可选参数。{Object} - 1中的标签的属性
  * 3. 子虚拟节点 (VNodes),由 `createElement()` 构建而成,也可以使用字符串来生成“文本虚拟节点”。可选参数。{String | Array} - 1的子节点,可以用 createElement() 创建,文本节点直接写就可以
  */
  return createElement(    
   // 1. 要渲染的标签名称:第一个参数【必需】   
   'div',  
   // 2. 1中渲染的标签的属性,详情查看文档:第二个参数【可选】
   {
    style: {
     color: '#333',
     border: '1px solid #ccc'
    }
   },
   // 3. 1中渲染的标签的子元素数组:第三个参数【可选】
   [
    'text',  // 文本节点直接写就可以
    _this.$slots.default, // 所有不具名插槽,是个数组
    createElement('div', _header)  // createElement()创建的VNodes
   ]
  )
 }

可查看控制台打印出的 $slots 对象。

render 函数作用

下面通过具体代码演示 render 函数的使用方法。

例:


    render:(h) => {
              return h('div',{
                   //给div绑定value属性
                props: {
                  value:''
                },
                   //给div绑定样式
                   style:{
                      width:'30px'
                   }, 
                   //给div绑定点击事件  
                on: {
                  click: () => {
                    console.log('点击事件')
                  }
                },

              })
            }  

深入 data 对象

需注意:正如模板语法中 v-bind:class 和 v-bind:style 被特殊处理一样,在 VNode 数据对象中,以下属性名具有最高优先级。该对象也允许绑定普通 HTML 特性,类似于 DOM 属性,例如 innerHTML(这将取代 v-html 指令)。


{
 // 和`v-bind:class`一样的 API
 'class': {
 foo: true,
 bar: false
 },
 // 和`v-bind:style`一样的 API
 style: {
 color: 'red',
 fontSize: '14px'
 },
 // 正常的 HTML 特性
 attrs: {
 id: 'foo'
 },
 // 组件 props
 props: {
 myProp: 'bar'
 },
 // DOM 属性
 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
  }
 }
 ],
 // Scoped slots in the form of
 // { name: props => VNode | Array<VNode> }
 scopedSlots: {
 default: props => createElement('span', props.text)
 },
 // 如果组件是其他组件的子组件,需为插槽指定名称
 slot: 'name-of-slot',
 // 其他特殊顶层属性
 key: 'myKey',
 ref: 'myRef'
}

总结

到此这篇关于 vue 的 render 函数作用详解的文章就介绍到这了,更多相关vue render 函数作用内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站!

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章