Vue项目中,大多数情况我们都可以通过模板来创建HTML, 有些场景需要使用JavaScript来动态创建HTML,这种情况我们可以使用render函数来实现,下面我们来看下详细使用方法。
函数调用简写
render: function (createElement) {
return createElement(App)
}
按照ES6语法简写函数
render (createElement) {
return createElement(App)
}
再简写
render (createElement) => {
return createElement(App)
}
再简写
render (h) => h(App)
h的含义来自于Hyperscript
,意思是“生成HTML结构的script脚本”
入参详细说明
// @returns {VNode}
createElement(
// {String | Object | Function}
// 一个 HTML 标签名、组件选项对象,或者
// resolve 了上述任何一种的一个 async 函数。必填项。
'div',
// {Object}
// 一个与模板中 attribute 对应的数据对象。可选。
{
// ...
},
// {String | Array}
// 子级虚拟节点 (VNodes),由 `createElement()` 构建而成,
// 也可以使用字符串来生成“文本虚拟节点”。可选。
[
'先写一些文字',
createElement('h1', '一则头条'),
createElement(MyComponent, {
props: {
someProp: 'foobar'
}
})
]
)
- 第一个参数(必填),可以是字符串、对象或函数,字符串通常为HTML标签名,对象通常为组件,函数通常为返回标签或对象的异步函数
- 第二个参数(非必填),可以是对象,通常为attribute 对应的数据对象
- 第三个参数(非必填),可以是字符串或数组,数组通常用来传递子级虚拟节点
下面详细看下第二个参数都可以指定哪些内容
{
// 与 `v-bind:class` 的 API 相同,
// 接受一个字符串、对象或字符串和对象组成的数组
'class': {
foo: true,
bar: false
},
// 与 `v-bind:style` 的 API 相同,
// 接受一个字符串、对象,或对象组成的数组
style: {
display: isShow ? 'auto' : 'none',
//可以通过三元表达式和CSS结合的办法控制显示和隐藏
color: 'red',
fontSize: '14px'
},
// 普通的 HTML attribute
attrs: {
id: 'foo',
//data-xx形式指定元素携带参数,可通过事件中e.target.dataset.xx获取
'data-name': 'bar'
},
// 组件 prop
props: {
myProp: 'bar'
},
// DOM property
domProps: {
//innerHTML指定为可被信任的HTML可用来直接指定HTML内容,需慎用,避免xss攻击
innerHTML: 'baz'
},
// 事件监听器在 `on` 内,
// 但不再支持如 `v-on:keyup.enter` 这样的事件修饰符。
on: {
click: e => {
console.log(e.target.dataset.name) //bar
},
input: this.clickHandler2
},
// 仅用于组件,用于监听原生事件,而不是组件内部使用
// `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
}
第三个参数以数组形式传入虚拟子节点,数组类似于下面的形式
[
(h) => h(App),
(h) => h(App)
]
简单示例
render (h) => {
return h('div',{
style:{
color: red
}
},[
h('p',{
on: click () => {
console.log('test1')
}
},'test1'),
h('p',{
on: click () => {
console.log('test2')
}
},'test2')
])
}