今天我们来看一下,vue的render
函数。
说明:
我们接着来,我们今天先来粗略的了解下render函数,后面我会用大量的代码进行说明,便于大家先简单的了解,后边我们在进行深入了解。
基础
什么是render
函数呢?Vue官方给我们已经说明。
VUE推荐在绝大多数情况下使用template来创建我们的HTML。然而在一些场景中,我们真的需要JavaScript的完全编程的能力,这就是render函数,它比template更接近编译器。
- <h1>
- <a name="hello-world" href="#hello-world">
- Hello world!
- </a>
- </h1>
在HTML层,我们决定这样定义组件接口:
<anchored-heading :level="1">Hello world!</anchored-heading>
当我们开始写一个通过level
prop 动态生成heading 标签的组件,你可能很快想到这样实现:
- <script type="text/x-template" id="anchored-heading-template">
- <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>
- </script>
- Vue.component('anchored-heading', {
- template: '#anchored-heading-template',
- props: {
- level: {
- type: Number,
- required: true
- }
- }
- })
在这种场景中使用 template 并不是最好的选择:首先代码冗长,为了在不同级别的标题中插入锚点元素,我们需要重复地使用<slot></slot>
。
虽然模板在大多数组件中都非常好用,但是在这里它就不是很简洁的了。那么,我们来尝试使用render
函数重写上面的例子:
- Vue.component('anchored-heading', {
- render: function (createElement) {
- return createElement(
- 'h' + this.level, // tag name 标签名称
- this.$slots.default // 子组件中的阵列
- )
- },
- props: {
- level: {
- type: Number,
- required: true
- }
- }
- })
简单清晰很多!简单来说,这样代码精简很多,但是需要非常熟悉 Vue 的实例属性。在这个例子中,你需要知道当你不使用slot
属性向组件中传递内容时,比如 anchored-heading
中的 Hello world!
, 这些子元素被存储在组件实例中的 $slots.default
中。如果你还不了解, 在深入 render
函数之前推荐阅读实例属性API。
我们来一个生成模板对比,便于学习
非使用render方法的情况下
- <div id="app">
- <child :level="1">Hello world!</child>
- </div>
- <script type="text/x-template" id="template">
- <div>
- <h1 v-if="level === 1">
- <slot></slot>
- </h1>
- <h2 v-if="level === 2">
- <slot></slot>
- </h2>
- <h3 v-if="level === 3">
- <slot></slot>
- </h3>
- <h4 v-if="level === 4">
- <slot></slot>
- </h4>
- <h5 v-if="level === 5">
- <slot></slot>
- </h5>
- <h6 v-if="level === 6">
- <slot></slot>
- </h6>
- </div>
- </script>
- <script type="text/javascript">
- Vue.component('child', {
- template: '#template',
- props: {
- level: {
- type: Number,
- required: true
- }
- }
- })
- new Vue({
- el: "#app"
- })
- </script>
这样的代码有一个缺陷,就是需要大量重复的代码。如<h1>~<h6>
共六种情况。如果这样的模板比较复杂,比如<hx>
标签里还有很多其他内容,显然会让人十分困扰,既不美观又不好用。
使用render方法的情况
- <div id="app">
- <child v-bind:level="2">Hello world!</child>
- </div>
- <script type="text/javascript">
- Vue.component('child', {
- render: function (createElement) {
- return createElement(
- 'h' + this.level, // tag name 标签名称
- this.$slots.default // 子组件中的阵列
- )
- },
- props: {
- level: {
- type: Number,
- required: true
- }
- }
- })
- new Vue({
- el: "#app"
- })
- </script>
比如说,有需要分发的标签 <slot>
,则通过 this.$slots.default
来获得,或许还有其他组件之类,可能需要被使用的,应该也是放在这里。
个人初步理解是,在原本被替换的地方,例如例上面代码中的 <child>
标签,在其下的每个次一级标签为一个元素,放在 this.$slots.default
这个数组中,例如上面的话,这个数组只有一个元素,但是以下代码: <child v-bind:level="2"><div>Hello</div><div> world!</div></child>
这个数组中则有两个元素,分别是 <div>Hello</div>
和 <div> world!</div>
例如 this.$slots.default[0]
则表示第一个标签。
另外,假如这2个元素中间有空格、换行符之类,那么数组中则有三个元素,那个空格、换行符则为第二个元素。这个属性有点类似dom的 childNodes属性,不是单纯以标签才算作子节点的。(但注意,不是完全相同)
有时候,我们可能想在里面添加其他的组件,例如将abc组件注册在里面。那么,我们首先要注册这个abc组件,然后将abc组件在数组里通过createElement来创建标签,只有通过这样的方式创建的abc标签,才能被abc组件使用。单纯输入字符串"<abc></abc>"
这样是不可以的。
如以下代码也是可行的(在通过render方法生成的模板中添加别的组件):
- <div id="app">
- <child v-bind:level="2">
- <div>Hello</div>
- <div> world!</div>
- </child>
- </div>
- <script>
- Vue.component('abc', {
- template: "<div>abc</div>"
- })
- Vue.component('child', {
- render: function (createElement) {
- console.log(this.$slots)
- return createElement(
- 'h' + this.level, // tag name 标签名称
- [this.$slots.default[0], createElement("abc"), this.$slots.default[1]] // 子组件中的阵列
- )
- },
- props: {
- level: {
- type: Number,
- required: true
- }
- }
- })
- new Vue({
- el: "#app"
- })
- </script>
显示结果是:
Hello
abc
world!
最后,如果想将原有内容全部使用(而不是只取部分标签),那么直接使用 this.$slots.default
作为第三个参数即可,他本身就是一个数组。
总而言之,createElement方法的作用就是动态的创建一个dom用于被render函数渲染,其中参数二和参数三可以选择性省略,参数二用于设置dom的样式、属性、事件等,参数三用于设置分发的内容,包括新增的其他组件。
粗略理解的话,可以理解为:createElement( 标签名, 标签属性, 标签里的内容)。
这样的话,我们就有了一个组件的模板所需要的全部内容了。后边我们在深入的了解下render函数。