Vue(七) 组件详解

组件 (Component) 是 Vue.js 最核心的功能，也是整个框架设计最精彩的部分，当然也是最难掌握的。

组件与复用

组件用法

组件与创建 Vue 实例类似，需要注册后才可以使用。注册有全局注册和局部注册两种方式。全局注册后任何 Vue 实例都可以使用。

全局注册

全局注册示例代码如下：

Vue.component('my-component', {
    //选项
})

my-component 就是注册的组件自定义名称，推荐使用小写加减号分隔的形式命名。

要在父实例中使用这个组件，必须要在实例创建前注册，之后就可以用 <my-component> 的形式使用组件了，实例代码如下：

<div id="app">
	<my-component></my-component>
</div>
<script>
	Vue.component('my-component', {
        //选项
	});

	var app = new Vue({
        el: '#app'
	})
</script>

此时打开页面是空的，因为我们注册的组件没有任何内容，需要在组件选项中添加 template 选项，例如：

Vue.component('my-component', {
    template: '<div>这里是组件内容</div>'
});

渲染后的结果是：

<div id="app">
	<div>这里是组件内容</div>
</div>

template 的DOM结果必须被一个元素包含，如果这里直接写成 “这里是组件的内容”，不带 "<div></div>" 是无法渲染的。

局部注册

在 Vue 实例中，使用 components 选项可以局部注册组件，注册后的组件只有在该实例作用于下有效，组件中也可以使用 components 选项来注册组件，使组件也可以嵌套，例如：

<div id="app">
  <my-component></my-component>
</div>
<script>
    var child = {
        template: '<div>局部注册组件的内容</div>'
    }

    var app = new Vue({
        el: '#app',
        components: {
            'my-component': child
        }
    })
</script>

is属性

Vue 组件的模板在某些情况下会受到 HTML 的限制，比如 <table> 只允许 <tr> <td> <th> 等这些表格元素，所以在 <table> 内直接使用组件是无效的。这种情况下，可以使用特殊的 is 属性来挂载组件，例如：

<div id="app">
    <table>
        <tbody is="my-component"></tbody>
    </table>
</div>
<script>
   Vue.component('my-component', {
      template: '<div>这里是组件的内容</div>'
   });

   var app = new Vue({
       el: '#app',
   })
</script>

tbody 在渲染时，会被替换成组件的内容。常见的限制元素还有 <ul> <ol> <select> 。

data选项

除了 template 选项，组件中还可以像 Vue 实例那样使用其他的选项，比如 data、computed、methods 等。但是在使用 data 时，和实例稍有区别，data 必须是函数，然后将数据 return 出去，例如：

<div id="app">
    <table>
        <tbody is="my-component"></tbody>
    </table>
</div>
<script>
   Vue.component('my-component', {
      template: '<div>{{ message }}</div>',
       data: function () {
          return {
              message: '组件内容'
          }
       }
   });

   var app = new Vue({
       el: '#app',
   })
</script>

使用 props 传递数据

基本用法

组件不仅仅是要把模板的内容复用，更重要的是组件间进行通信。父组件要正向地向子组件传递数据或参数，这个正向传递数据的过程就是通过 props 来实现的。

在组件中使用 props 来声明需要从父组件接收的数据，props 的值可以是两种，一种是字符串数组，一种是对象，先介绍数组的用法，构造一个数组，接收一个来自父级的数据 message，并在模板中渲染，例如：

<div id="app">
    <my-component message="来自父组件的内容"></my-component>
</div>
<script>
   Vue.component('my-component', {
       props: ['message'],
       template: '<div>{{ message }}</div>',

   });

   var app = new Vue({
       el: '#app',
   })
</script>

props 中声明的数据与组件 data 函数 return 的数据主要区别就是 props 的来自父级，而 data 中的是组件自己的数据，作用域是组件本身，这两种数据都能在模板 template 及计算属性 computed 和方法 methods 中使用。

由于 HTML 特性不区分大小写，当使用 DOM 模板时，驼峰命名的 props 命名要转为短横分隔命名，例如：

<div id="app">
    <my-component warning-text ="提示信息"></my-component>
</div>
<script>
   Vue.component('my-component', {
       props: ['warningText'],
       template: '<div>{{ warningText }}</div>',
   });

   var app = new Vue({
       el: '#app',
   })
</script>

有时候，传递的数据并不是直接写死的，而是来自父级的动态数据，这时可以使用指令 v-bind 来动态绑定 props 的值，当父组件的数据变化时，也会传递给子组件。例如：

<div id="app">
    <input type="text" v-model="parentMessage">
    <my-component :message ="parentMessage"></my-component>
</div>
<script>
   Vue.component('my-component', {
       props: ['message'],
       template: '<div>{{ message }}</div>',
   });

   var app = new Vue({
       el: '#app',
       data: {
           parentMessage: ''
       }
   })
</script>

注意：如果你要直接传递数字，布尔值，数组，对象，但不使用 v-bind，传递的仅仅是字符串，例如：

<div id="app">
    <my-component message ="[1,2,3]"></my-component>
    <my-component :message ="[1,2,3]"></my-component>
</div>
<script>
   Vue.component('my-component', {
       props: ['message'],
       template: '<div>{{ message.length }}</div>',
   });

   var app = new Vue({
       el: '#app',
       data: {
           parentMessage: ''
       }
   })
</script>

同一个组件使用了两次，区别是第二个使用了 v-bind，第一个是 7，第二个是 3。

单向数据流

Vue 2.x 通过 props 传递数据是单向的了，也就是父组件数据变化时会传递给子组件，但是反过来不行。

业务会经常遇到两种需要改变 prop 的情况，一种是父组件传递初始值进来，子组件将它作为初始值保存起来，在自己的作用域下可以随意使用和修改。这种情况下可以在 data 内再声明一个数据，引用父组件的 prop，例如：

<div id="app">
    <my-component :init-count="1"></my-component>
</div>
<script>
   Vue.component('my-component', {
       props: ['initCount'],
       template: '<div>{{ count }}</div>',
       data: function () {
           return {
               count: this.initCount
           }
       }
   });

   var app = new Vue({
       el: '#app',
   })
</script>

另一种情况就是 prop 作为需要被转变的原始值传入，这种情况下用计算属性就可以了，例如：

<div id="app">
    <my-component :size="50"></my-component>
</div>
<script>
   Vue.component('my-component', {
       props: ['size'],
       template: '<div :style = "style">组件内容</div>',
       computed: {
           style: function () {
               return {
                   fontSize: this.size + 'px'
               }
           }
       }
   });

   var app = new Vue({
       el: '#app',
   })
</script>

注意：在 JavaScript 中对象和数组是引用类型，指向同一个内存空间，所以 prop 是对象和数组时，在子组件内改变是会影响父组件的。

数据验证

上面所介绍的 props 选项都是一个数组，当 prop 需要验证时，就需要对象写法。

一般当你的组件需要提供给别人使用时，推荐使用数据验证，比如某个数据必须是数字类型，如果传入字符串，就会在控制台弹出警告。

以下是几个 prop 的示例：

Vue.component('my-component', {
    props: {
        //必须是数字类型
        propA: Number,
        //必须是字符串或数字类型
        propB: [String, Number],
        //布尔值，默认为true
        propC: {
            type: Boolean,
            default: true
        },
        //数字，而且是必传
        propD: {
            type: Number,
            required: true
        },
        //如果是数组或对象，默认值必须用一个函数返回
        propE: {
            type: Array,
            default: function () {
                return [];
            }
        },
        //自定义一个验证函数
        propF: {
            validator: function (value) {
                return value > 10;
            }
        }
    }
});

验证的 type类型可以是：

• String
• Number
• Boolean
• Object
• Array
• Function

type 也可以是一个自定义构造器，使用 instanceof 检测。

当 prop 验证失败时，在开发版本下会在控制台抛出一天警告。

组件通信

我们已经知道，父组件向子组件通信，通过 props 传递数据就可以，但 Vue 组件通信的场景不止有这一种，归纳起来，组件通信可以用户下图表示：

组件关系可分为父子组件通信，兄弟组件通信，跨级组件通信。

父子组件通信

自定义事件

当子组件需要向父组件传递数据时，就需要用到自定义事件。子组件用 $emit() 来触发事件，父组件用 $on() 来监听子组件的事件。

父组件可以直接在子组件的自定义标签上使用 v-on 来监听子组件的自定义事件，例如：

<div id="app">
    <p>总数：{{ total }}</p>
    <my-component @increase="getTotal" @reduce="getTotal">
    </my-component>
</div>
<script>
   Vue.component('my-component', {
        template: '\
        <div>\
            <button @click="handleIncrease">+1</button>\
            <button @click="handleReduce">-1</button>\
        </div>',
       data: function () {
           return {
               count: 0
           }
       },
       methods: {
            handleIncrease: function () {
                this.count++;
                this.$emit('increase', this.count);
            },
            handleReduce: function () {
                this.count--;
                this.$emit('reduce', this.count);
            }
       }
   });

   var app = new Vue({
       el: '#app',
       data: {
           total: 0
       },
       methods: {
           getTotal: function (total) {
               this.total = total;
           }
       }
   })
</script>

除了用 v-on 在组件上监听自定义组件，也可以监听 DOM 事件，这时可以用 .native 修饰符表示监听一个原生事件，监听的是该组件的根元素，例如：

<my-component v-on:click.native="handleClick"></my-component>

使用 v-model

Vue 2.x 可以在自定义组件上使用 v-model 指令，例如：

<div id="app">
    <p>总数：{{ total }}</p>
    <my-component v-model = "total"></my-component>
</div>
<script>
   Vue.component('my-component', {
        template: '<button @click="handleClick">+1</button>',
       data: function () {
           return {
               count: 0
           }
       },
       methods: {
            handleClick: function () {
                this.count++;
                this.$emit('input', this.count);
            },
       }
   });

   var app = new Vue({
       el: '#app',
       data: {
           total: 0
       }
   })
</script>

仍然是点击按钮加 1 点效果，不过这次的 $emit() 的事件名是特殊的 input，在使用组件的父级并没有在 <my-component> 上使用 @input="hander"，而是直接用了 v-model 绑定一个数据 total。这也可以称作是一个语法糖，因为上面的示例可以间接地用自定义事件实现：

<div id="app">
    <p>总数：{{ total }}</p>
    <my-component @input="getTotal"></my-component>
</div>
<script>
   Vue.component('my-component', {
        template: '<button @click="handleClick">+1</button>',
       data: function () {
           return {
               count: 0
           }
       },
       methods: {
            handleClick: function () {
                this.count++;
                this.$emit('input', this.count);
            },
       }
   });

   var app = new Vue({
       el: '#app',
       data: {
           total: 0
       },
       methods: {
           getTotal: function (total) {
               this.total = total;
           }
       }
   })
</script>

v-model 还可以用来创建自定义的表单输入组件，进行数据双向绑定，例如：

<div id="app">
    <p>总数：{{ total }}</p>
    <my-component v-model="total"></my-component>
    <button @click="handleReduce">-1</button>
</div>
<script>
   Vue.component('my-component', {
       props: ['value'],
       template: '<input :value="value" @input="updateValue">',
       methods: {
            updateValue: function (event) {
                this.$emit('input', event.target.value);
            },
       }
   });

   var app = new Vue({
       el: '#app',
       data: {
           total: 0
       },
       methods: {
           handleReduce: function () {
               this.total--;
           }
       }
   })
</script>

实现这样一个具有双向绑定的 v-model 组件要满足下面两个要求：

• 接收一个 value 属性。
• 在有新的 value 时触发 input 事件。

非父子组件通信

在实际业务中，除了父子组件通信外，还有很多非父子组件通信的场景，非父子组件一般有两种，喜爱兄弟组件和跨多级组件。

中央事件总线

在 Vue.js 2.x 中，推荐使用一个空的 Vue 实例作为中央事件总线（bus），也就是一个中介。例如：

<div id="app">
    {{ message }}
    <component-a></component-a>
</div>
<script>
    var bus = new Vue();

    Vue.component('component-a', {
        template: '<button @click="handleEvent">传递事件</button>',
        methods: {
            handleEvent: function () {
                bus.$emit('on-message', '来自组件 component-a 的内容');
            },
        }
    });

     var app = new Vue({
         el: '#app',
         data: {
             message: ''
         },
         mounted: function () {
             var _this = this;
             //在实例初始化时，监听来自 bus 实例的事件
             bus.$on('on-message', function (msg) {
                 _this.message = msg;
             });
         }
     })
</script>

父链

在子组件中，使用 this.\(parent 可以直接访问该组件的父实例或组件，父组件也可以通过this.\)children 访问它所有的子组件，而且可以递归自上而下无线访问，直到根实例或最内层的组件。例如：

<div id="app">
    {{ message }}
    <component-a></component-a>
</div>
<script>
    Vue.component('component-a', {
        template: '<button @click="handleEvent">传递事件</button>',
        methods: {
            handleEvent: function () {
                //访问到父链后，可以做任何操作
                this.$parent.message = '来自组件 component-a 的内容';
            },
        }
    });

     var app = new Vue({
         el: '#app',
         data: {
             message: ''
         }
     })
</script>

尽管 Vue 允许这么做，但在业务中，子组件应该尽可能地避免依赖父组件的数据，更不应该去主动修改它的数据，因为这样使得父子组件紧耦合，很难理解父组件的状态，因为它可能被任意组件修改，理想情况下，只要组件自己能修改它的状态，父子组件最好还是通过 props 和 $emit 来通信。

子组件索引

当子组件较多时，通过 this.$children 来一一遍历我们需要的一个组件实例是比较困难的，尤其在组件动态渲染时，他们的序列是不固定的。Vue 提供了子组件的索引的方法，用特殊的属性 ref 来为子组件指定一个索引名称，例如：

<div id="app">
    {{ message }}
    <button @click="handleRef">通过 ref 获取子组件实例</button>
    <component-a ref="comA"></component-a>
</div>
<script>
    Vue.component('component-a', {
        template: '<div>子组件</div>',
        data: function () {
            return {
                message: '子组件内容'
            }
        }
    });

     var app = new Vue({
         el: '#app',
         data: {
             message: ''
         },
         methods: {
             handleRef: function () {
                 this.message  = this.$refs.comA.message;
             }
         }
     })
</script>

注意：$ref 只在组件渲染完成后才填充，并且它是非响应式的。它仅仅作为一个直接访问子组件的应急方案，应当避免在模板或计算属性中使用 $refs。

使用 solt 分发内容

什么是 slot

很多网站由一级导航、二级导航、左侧列表、正文、以及底部版权信息 5 个模块组成，如果要将他们都组件化，这个结构可能会是：

<app>
	<menu-main></menu-main>
	<menu-sub></menu-sub>
	<div class="container">
		<menu-left></menu-left>
		<container></container>
	</div>
	<app-footer></app-footer>
</app>

当需要让组件组合使用，混合父组件的内容与子组件的模板时，就会用到 slot，这个过程叫做内容分发。以 <app> 为例，它有两个特点：

• <app> 组件不知道它的挂载点会有什么内容。挂载点的内容是由 <app> 的父组件决定的。
• <app> 组件很可能有自己的组件。

props 传递数据、events 触发事件和 slot 内容分发就构成了 Vue 组件的 3 个 API 来源，再复杂的组件也是由这 3 部分构成的。

作用域

正式介绍 slot 前，需要先知道一个概念：编译的作用域。例如：

<child-component>
	{{ message }}
</child-component>

这里的 message 就是一个 slot，但是它绑定的是父组件的数据，而不是组件 <child-component> 的数据。

父组件的模板的内容是在父组件作用域编译，子组件模板的内容是在子组件作用域内编译。

注意：slot分发的内容，作用域是在父组件上的。

solt用法

单个 Slot

在子组件内使用特殊的 <slot> 元素就可以为这个子组件开启一个 slot（插槽），在父组件模板里，插入在子组件标签内的所有内容将替代 <slot> 标签及它的内容。例如：

<div id="app">
    <child-component>
        <p>分发的内容</p>
        <p>更多分发的内容</p>
    </child-component>
</div>
<script>
    Vue.component('child-component', {
        template: '\
        <div>\
            <slot>\
                <p>如果父组件没有插入内容，我将作为、默认出现</p>\
            </slot>\
        </div>'
    });

     var app = new Vue({
         el: '#app',
     })
</script>

渲染完后的结果为：

<div id="app">
	<div>
		<p>分发的内容</p>
		<p>更多分发的内容</p>
	</div>
</div>

注意：子组件 <slot> 内的备用内容，它的作用是子组件本身。

具名Slot

给 <slot> 元素指定一个 name 后可以分发多个内容，具名 Slot 可以与单个Slot 共存，例如：

<div id="app">
    <child-component>
        <h2 slot="header">标题</h2>
        <p>分发的内容</p>
        <p>更多的正文内容</p>
        <div slot="footer">底部信息</div>
    </child-component>
</div>
<script>
    Vue.component('child-component', {
        template: '\
        <div class="container">\
            <div class="header">\
                <slot name="header"></slot>\
            </div>\
            <div class="main">\
                <slot></slot>\
            </div>\
            <div class="footer">\
                <slot name="footer"></slot>\
            </div>\
        </div>'
    });

     var app = new Vue({
         el: '#app',
     })
</script>

子组件里声明了 3 个 <slot> 元素，其中 <div class="main"> 内的 <slot> 没有使用 name 特性，它将作为默认 slot 出现，父组件没有使用 slot 特性的元素和内容都将出现在这里。如果没有指定

默认匿名的 slot，父组件内多余的内容片断都将被抛弃。

上面最终的渲染结结果为：

<div class="container">
    <div class="header">
        <h2>标题</h2>
    </div>
    <div class="main">
        <p>分发的内容</p>
        <p>更多的正文内容</p>
    </div>
    <div class="footer">
        <div>底部信息</div>
    </div>
</div>

作用域插槽

作用域插槽是一种特殊的 slot，使用一个可以复用的模板替换已渲染元素，概念比较难以理解，先看一个简单的示例来了解它的基本用法。例如：

<div id="app">
    <child-component>
        <template scope="props">
            <p>来自父组件的内容</p>
            <p>{{ props.msg }}</p>
        </template>
    </child-component>
</div>
<script>
    Vue.component('child-component', {
        template: '\
        <div class="container">\
           <slot msg="msg"></slot>\
        </div>',
        data: function () {
            return {
                msg: '来自子组件的内容'
            }
        }
    });

     var app = new Vue({
         el: '#app',
     })
</script>

在 <slot> 元素上有一个类似 props 传递数据给组件的写法 msg=“xxx”，将数据传入到了插槽。这里的 props 只是一个临时变量，就像 v-for="item in items" 里面的 item 一样。template 内可以通过临时变量 props 访问来自子组件的数据 msg。

上面渲染后的最终结果为：

<div id="app">
	<div class=="container">
		 <p>来自父组件的内容</p>
		 <p>来自子组件的内容</p>
	</div>
</div>

作用域插槽更具代表性的用例是列表组件，允许组件自定义应该如何渲染列表每一项。例如：

<div id="app">
    <my-list :books="books">
        <!-- 作用域插槽也可以是具名的 Slot -->
        <template slot="book" scope="props">
            <li>{{ props.bookName }}</li>
        </template>
    </my-list>
</div>
<script>
    Vue.component('my-list', {
        props: {
            books: {
                type: Array,
                default: function () {
                    return [];
                }
            }
        },
        template: '\
                <ul>\
                    <slot name="book" v-for="book in books" \
                    :book-name="book.name">\
                    <!--这里也可以写默认的 slot 内容-->\
                    </slot>\
            '
    });

     var app = new Vue({
         el: '#app',
         data: {
             books: [
                 { name: 'Java编程思想'},
                 { name: 'Java核心技术'},
                 { name: 'JS 语言精粹'},
             ]
         }
     })
</script>

访问 slot

Vue.js 2.x 提供了用来访问被 slot 分发的内容的方法 $slots，例如：

div id="app">
    <child-component>
        <h2 slot="header">标题</h2>
        <p>分发的内容</p>
        <p>更多的正文内容</p>
        <div slot="footer">底部信息</div>
    </child-component>
</div>
<script>
    Vue.component('child-component', {
        template: '\
        <div class="container">\
            <div class="header">\
                <slot name="header"></slot>\
            </div>\
            <div class="main">\
                <slot></slot>\
            </div>\
            <div class="footer">\
                <slot name="footer"></slot>\
            </div>\
        </div>',
        mounted: function () {
            var header = this.$slots.header;
            var main = this.$slots.default;
            var footer = this.$slots.footer;
            console.log(footer);
            console.log(footer[0].elm.innerText);
        }
    });

    var app = new Vue({
        el: '#app',
    })
</script>

$slot 在业务中几乎用不到，在用 render 函数创建组件时会比较有用，但主要还是用于独立组件开发中。