Vue.js 2.x render

渲染函数 & JSX

Vue绝大多数情况下使用template创建 HTML。但是比如一些重复性比较高的场景&＃xff0c;需要运用 Javascript 的完全编程能力&＃xff0c;可以使用render函数。

1. 节点、树以及虚拟DOM

每个元素都是一个节点。每片文字也是一个节点。甚至注释也都是节点。
一个节点就是页面的一个部分。每个节点都可以有子节点。

比如上面的节点树就表示下面的代码&＃xff1a;

1.1 虚拟 DOM

Vue 通过建立一个虚拟 DOM 对真实 DOM 发生的变化保持追踪。
虚拟 DOM 是对Vue组件树建立起来的整个 VNode&＃xff08;Virtual Node&＃xff09;树的称呼。

1.1.1 createElement 参数

// &＃64;returns {VNode}
createElement(// {String | Object | Function}// 一个 HTML 标签字符串&＃xff0c;组件选项对象&＃xff0c;或者// 解析上述任何一种的一个 async 异步函数// 必须参数&＃39;div&＃39;,// {Object}// 一个包含模板相关属性的数据对象// 你可以在 template 中使用这些特性// 可选参数{ // 属性参见 1.1.2 深入 data 对象},// {String | Array}// 子虚拟节点&＃xff08;VNodes&＃xff09; 由 createElement() 构建而成// 也可以使用字符串来生成“文本虚拟节点”// 可选参数[&＃39;文字&＃39;,createElement(&＃39;h1&＃39;, &＃39;一个标题&＃39;),createElement(MyComponent, {props: {someProp: &＃39;foo&＃39;}})]
)

1.1.2 深入 data 对象

在 VNode 数据对象中&＃xff0c;下列属性名是级别最高的字段。该对象也允许绑定普通的 HTML 特性&＃xff0c;就像 DOM 属性一样&＃xff0c;比如innerHTML&＃xff08;这会取代v-html指令&＃xff09;。

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

1.1.3 完整示例

一个生成锚点标题的组件&＃xff1a;

var getChildrenTextContent &＃61; function (children) {return children.map(function (node) {return node.children? getChildrenTextContent(node.children): node.text}).join(&＃39;&＃39;)
}Vue.component(&＃39;anchored-heading&＃39;, {render: function (createElement) {// 创建 kebab-case 风格的IDvar headingId &＃61; getChildrenTextContent(this.$slots.default).toLowerCase().replace(/\W&＃43;/g, &＃39;-&＃39;).replace(/(^-|-$)/g, &＃39;&＃39;)return createElement(&＃39;h&＃39; &＃43; this.level,[createElement(&＃39;a&＃39;, {attrs: {name: headingId,href: &＃39;#&＃39; &＃43; headingId}}, this.$slots.default)])},props: {level: {type: Number,required: true}}
})

使用效果&＃xff1a;

1.1.4 约束

组件树中的所有 VNodes 必须是唯一的。

比如这样写是错误的&＃xff1a;

render: function (createElement) {var myParagraphVNode &＃61; createElement(&＃39;p&＃39;, &＃39;hi&＃39;)return createElement(&＃39;div&＃39;, [// 错误-重复的 VNodesmyParagraphVNode, myParagraphVNode])
}

如果需要重复多次元素/组件&＃xff0c;可以用工厂函数来实现&＃xff1a;

render: function(createElement) {return createElement(&＃39;div&＃39;,Array.apply(null, { length: 20 }.map(function() {return createElement(&＃39;p&＃39;, &＃39;hello&＃39;)})));
}

1.2 使用 Javascript 代替模板功能

1.2.1 v-if 和 v-for

只要在原生的 Javascript 中可以轻松完成的操作&＃xff0c;Vue的render函数就不会提供专有的替代方法。
比如这里的v-if和v-for。

• {{ item.name }}



使用 render 方法重写&＃xff1a;

props: [&＃39;items&＃39;],
render: function(createElement) {if (this.items.length) {return createElement(&＃39;ul&＃39;, this.items.map(function(item) {return createElement(&＃39;li&＃39;, item.name);}))} else {return createElement(&＃39;p&＃39;, &＃39;No items here.&＃39;);}
}

1.2.2 v-model

render 函数中没有与 v-model直接对应的方法&＃xff0c;需要手动实现&＃xff1a;

props: [&＃39;value&＃39;],
render: function (createElement) {var self &＃61; this;return createElement(&＃39;input&＃39;, {// DOM属性domProps: {value: self.value},on: {input: function(e) {self.$emit(&＃39;input&＃39;, e.target.value);}}})
}

1.3 事件&按键修饰符

对于.passive、.capture、.once事件修饰符&＃xff0c;Vue提供了相应的前缀可以用于on&＃xff1a;

比如&＃xff1a;

on: {&＃39;!click&＃39;: this.doThisInCapturingMode,&＃39;~keyup&＃39;: this.doThisOnce,&＃39;~!mouseover&＃39;: this.doThisOnceInCapturingMode
}

对于其他的修饰符&＃xff0c;可以在事件处理函数中使用事件方法&＃xff1a;

比如&＃xff1a;

on: {keyup: function (event) {// 如果触发事件的元素不是事件绑定的元素// 则返回if (event.target !&＃61;&＃61; event.currentTarget) return// 如果按下去的不是 enter 键或者// 没有同时按下 shift 键// 则返回if (!event.shiftKey || event.keyCode !&＃61;&＃61; 13) return// 阻止 事件冒泡event.stopPropagation()// 阻止该元素默认的 keyup 事件event.preventDefault()// ...}
}

1.4 插槽

可以通过this.$slots访问静态插槽内容&＃xff0c;得到的是一个 VNodes 数组&＃xff1a;

render: function(createElement) {// &＃96;

也可以通过this.$scopeSlots访问作用域插槽&＃xff0c;得到的是一个 VNodes 的函数&＃xff1a;

props: [&＃39;message&＃39;],
render: function(createElement) {// &＃96;

如果要用渲染函数句子向子组件中传递作用域插槽&＃xff0c;可以利用 VNode 数据对象中的scopedSlots域&＃xff1a;

render: function(createElement) {return createElement(&＃39;div&＃39;, [createElement(&＃39;child&＃39;, {// 在数据对象中传递 scopedSlots// 格式&＃xff1a;{ name: props &＃61;> VNode | Array }scopedSlots: {default: function(props) {return createElement(&＃39;span&＃39;, props.text)}}})])
}

2. JSX

在Vue中使用JSX语法&＃xff0c;可以避免书写繁杂冗余的render代码&＃xff0c;Babel插件用于在Vue中使用JSX语法。

使用文档

import AnchoredHeading from &＃39;./AnchoredHeading.vue&＃39;new Vue({el: &＃39;#app&＃39;,render: function(h) {return (Hello world)}
})

3. 函数式组件

一个函数是组件&＃xff0c;意味着它是无状态&＃xff08;没有响应式数据&＃xff09;&＃xff0c;无实例&＃xff08;没有this上下文&＃xff09;的&＃xff1a;

Vue.component(&＃39;my-component&＃39;, {functional: true,// props可选 v2.3.0^props: {},// 为了弥补缺少的实例// 提供第二个参数作为上下文render(createElement, context) {}
})

在v2.5.0^版本中&＃xff0c;单文件组件基于模板的函数式组件可以这样声明&＃xff1a;

组件需要的一切都是通过上下文来传递&＃xff1a;

• props 提供所有prop对象
• children VNode子节点的数组
• slots 返回所有插槽的对象的函数
• scopedSlots 一个暴露传入的作用域插槽以及函数形式的普通插槽的对象
• data 传递给组件的数据对象&＃xff0c;作为CreateElement的第二个参数传入组件
• parent 对父组件的引用
• listeners 一个包含了所有在父组件上注册的事件侦听器的对象&＃xff0c;data.on的别名
• injections 如果使用了inject选项&＃xff0c;该对象包含了应当被注入的属性

之前的锚点标题组件可以改为如下的函数式组件&＃xff1a;

...Vue.component(&＃39;anchored-heading&＃39;, {functional: true,render: function (createElement, context) {// 创建 kebab-case 风格的IDvar headingId &＃61; getChildrenTextContent(context.children).toLowerCase().replace(/\W&＃43;/g, &＃39;-&＃39;).replace(/(^-|-$)/g, &＃39;&＃39;)return createElement(&＃39;h&＃39; &＃43; context.props.level,[createElement(&＃39;a&＃39;, {attrs: {name: headingId,href: &＃39;#&＃39; &＃43; headingId}}, context.children)])},props: {level: {type: Number,required: true}}
})

3.1 想子组件或子元素传递特性和事件

在普通组件中&＃xff0c;没有被定义为 prop 的特性会自动添加到组件的根元素上&＃xff0c;将现有的同名特性替换或智能合并。
而函数式组件要求必须显示定义该行为&＃xff1a;

Vue.component(&＃39;my-functional-button&＃39;, {functional: true,render: function(createElement, context) {return createElement(&＃39;button&＃39;, context.data, context.children)}
})

如果使用模板的函数式组件&＃xff0c;还需要手动添加特性和监听器。

3.2 slots()和children对比

slots()和children对比

总的来说个人理解&＃xff0c;slots()可以拿到具名插槽&＃xff0c;children拿到所有。

4. 模板编译

模板编译

The end
2019-8-13 15:45:59