Vue
推荐在绝大多数情况下使用模板来创建你的 HTML
。然而在一些场景中,你需要 JavaScript
的完全编程能力。这时你可以用渲染函数render
,它比模板更接近编译器。
简单的说,在vue
中我们使用模板HTML
语法组建页面,使用render
函数我们可以用js
语言来构建DOM
。
因为vue
是虚拟DOM
,所以在拿到template
模板时也要转译成VNode
函数,而用render
函数构建DOM
时,vue
就免去了转译的过程。
当使用render
函数描述虚拟DOM
时,vue
提供一个函数,这个函数是就构建虚拟DOM
所需要的工具。官网起名createElement
。还有约定的简写h
,
vm中有一个方法_c
,也是这个函数的别名
先看官网对 createElement
的介绍:
// @returns {VNode}
createElement(
// {String | Object | Function}
// 一个 HTML 标签字符串,组件选项对象,或者
// 解析上述任何一种的一个 async 异步函数,必要参数。
'div',
// {Object}
// 一个包含模板相关属性的数据对象
// 这样,您可以在 template 中使用这些属性。可选参数。
{
// (详情见下一节)
},
// {String | Array}
// 子节点 (VNodes),由 `createElement()` 构建而成,或使用字符串来生成“文本节点”。可选参数。组件树中的所有 VNode 必须是唯一的。
[
'先写一些文字',
createElement('h1', '一则头条'),
createElement(MyComponent, {
props: {
someProp: 'foobar'
}
})
]
)
就是说createElement(params1,params2,params3)
接受三个参数,每个参数的类型官方介绍已经说明。
render:(h) => {
return h('div',{
//给div绑定value属性
props: {
value:''
},
//给div绑定样式
style:{
width:'30px'
},
//给div绑定点击事件
on: {
click: () => {
console.log('点击事件')
}
},
})
}
有一点要注意:正如 v-bind:class
和 v-bind:style
在模板语法中会被特别对待一样,它们在 VNode
数据对象中也有对应的顶层字段。该对象也允许你绑定普通的 HTML attribute
,也允许绑定如 innerHTML
这样的 DOM property
(这会覆盖 v-html
指令)。
{
// 与 `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 }
scopedSlots: {
default: props => createElement('span', props.text)
},
// 如果组件是其它组件的子组件,需为插槽指定名称
slot: 'name-of-slot',
// 其它特殊顶层 property
key: 'myKey',
ref: 'myRef',
// 如果你在渲染函数中给多个元素都应用了相同的 ref 名,
// 那么 `$refs.myRef` 会变成一个数组。
refInFor: true
}
以官网例子为例,这个组件可以根据父级组件给他传递的level
来渲染h1
还是h6
,代码如下:
<template>
<div>
<h1 v-if="level === 1">
<slot></slot>
</h1>
<h2 v-else-if="level === 2">
<slot></slot>
</h2>
<h3 v-else-if="level === 3">
<slot></slot>
</h3>
<h4 v-else-if="level === 4">
<slot></slot>
</h4>
<h5 v-else-if="level === 5">
<slot></slot>
</h5>
<h6 v-else-if="level === 6">
<slot></slot>
</h6>
</div>
</template>
<script>
export defalut {
// 接收父组件传来的 level
props: {
level: {
type: Number,
required: true
}
}
}
</script>
这种应用场景确实不多,但是也会遇到,比如现在有6种不同的状态,用1,2,3,4,5,6表示。我们要通过这些状态展示不同的图片,如果后台不给你返回图片地址只返回状态对应的数字(图片放在本地),用render函数在合适不过了(前提是状态有很多,2、3个就算了)。下面使用render
函数重写上面的组件:
export default {
render: function (createElement) {
// createElement可以写成h,这是公认写法
// createElement 是 render 函数 的参数,它本身也是个函数,并且有三个参数。
/*
这里说明它的三个参数:
1、一个 HTML 标签字符串,组件选项对象,或者解析上述任何一种的一个 async 异步函数。类型:{String | Object | Function}。必需。
2、一个包含模板相关属性的数据对象你可以在 template 中使用这些特性。类型:{Object}。可选。
3、子虚拟节点 (VNodes),由 createElement() 构建而成,也可以使用字符串来生成“文本虚拟节点”。类型:{String | Array}。可选。
*/
return createElement(
// 参数1、标签名称,父组件传几,我这就是h几,不用再template上面加if,else了是不是很简洁实用?(必填)
'h' + this.level,
// 参数2、这里相当于给标签加属性 例如:(可选)
{
// 与 `v-bind:class` 的 API 相同,
// 接受一个字符串、对象或字符串和对象组成的数组
'class': {
foo: true,
bar: false
},
// 与 `v-bind:style` 的 API 相同,
// 接受一个字符串、对象,或对象组成的数组
style: {
color: 'red',
fontSize: '14px'
},
},
// 参数3、参数中渲染的标签的子元素数组(可选)
[
'text', // 文本节点直接写就可以
_this.$slots.default, // 所有不具名插槽,是个数组
createElement('div', _header) // createElement()创建的VNodes
]
)
},
// 接收父组件传来的 level
props: {
level: {
type: Number,
required: true
}
}
}
render
方法的实质就是生成template
模板;render
方法的参数传递给它的;html
内容备注:
render
方法可以使用JSX
语法,但需要Babel plugin
插件;render
方法里的第三个参数可以使用函数来生成多个组件(特别是如果他们相同的话),只要生成结果是一个数组,且数组元素都是VNode
即可;