第十八节:带你梳理Vue2: Vue组件中的注意事项和特例

1. Vue组件名推荐使用驼峰命名

现在我们来看看为什么在Vue中推荐注册组件时使用驼峰写法, 在了解这个之前,相信大家应该都能明白为什么在Vue中, 局部组件的使用频率高于全局组件.

推荐使用驼峰写法也是和局部组件有关系

我们先看一个示例

<div id="app"><!-- 3. 在注册了局部组件的实例中使用局部组件 --><my-component></my-component>
</div><script>// 1. 创建局部组件的选项对象let MyComponent = {template: `<div><h2>局部组件</h2></div>`,}const vm = new Vue({el:"#app",// 2. 将选项对象注册为局部组件components: {"my-component": MyComponent}})
</script>

通过前面的学习,这个例子应该已经熟悉了,

首先定义一个选项对象myComponent
在Vue实例中通过components注册为局部组件
在HTML模板中通过<my-component>自定义标签使用组件

示例中,不使用驼峰命名组件,依然可以正常运行,那么为什么组件名还要推荐使用驼峰命名

那先看下面几点:

首先在定义选项对象的时候使用的变量名绝对不可以是连字符, 这是标识符命名规范,因此如果要使用连字符就必须加引号
在注册组件时,components中的属性名my-component就是我们的组件名称, 其值MyComponent就是将谁注册为组件

好此时大家想一想,如果组件名和选项对象的变量名一样会怎么样

是不是就会变成如下的写法

const vm = new Vue({el:"#app",components: {MyComponent: MyComponent}
})

在思考一下,我们之前在学习ES6的时候讲过在定义对象的是有一种简便写法. 当属性跟值长得一样时,就可以简写
因此这里我们就可以简写为

const vm = new Vue({el:"#app",components: {MyComponent}
})

所以,为什么推荐使用驼峰写法,这里就应该可以看出端倪了, 如果我们定义组件的组件名使用驼峰写法,也就是和需要被注册为组件的选项对象一致时,我们注册组件将变得简单

如果此时需要注册n个组件,就可以如下写法

const vm = new Vue({el:"#app",components: {one,two,three,four.....}
})

是不是感觉很优雅,

总结:

在定义组件时推荐使用驼峰写法,最好组件名和需要被创建为组件的选项对象名一致
使用组件时推荐使用连字符

2. 组件中的template 选项

尽管语法糖简化了组件注册，但在template选项中拼接HTML元素比较麻烦，这也导致了HTML和JavaScript的高耦合性。

Vue.js提供了两种方式将定义在JavaScript中的HTML模板分离出来。

2.1 使用script标签将template模板分离出来

在使用script标签将template模板分离出来时,要注意script标签的type类型选择,

<div id="app"><!-- 3. 使用组件 --><my-component></my-component>
</div><!-- 组件模板 -->
<!-- 注意: 如果不添加type属性,可能会显示效果,但是会报错, -->
<script id="myComponent" type="text/x-template"><div><h2>我想被创建为局部组件</h2></div>
</script><script>// 1. 创建组件选项对象let MyComponent = {// 此时的模板template的值就是一个选择器template: "#myComponent",}const vm = new Vue({el:"#app",// 2. 注册组件components: {"my-component": MyComponent}})</script>

template选项现在不再是HTML元素，而是一个id，Vue.js根据这个id查找对应的元素，然后将这个元素内的HTML作为模板进行编译。

注意：

使用<script> 标签时，type指定为text/x-template，意在告诉浏览器这不是一段js脚本，浏览器在解析HTML文档时会忽略<script>标签内定义的内容。

2.2 使用template 标签处理模板

如果使用<template>标签，则不需要指定type属性。

<div id="app"><!-- 3. 使用组件 --><my-component></my-component>
</div><!-- 组件模板 -->
<!-- template标签不需要指定type,标签的本意就是告诉浏览器这是模板 -->
<template id="myComponent"><div><h2>我想被创建为局部组件</h2></div>
</template><script>// 1. 创建组件选项对象let MyComponent = {// 此时的模板template的值就是一个选择器template: "#myComponent",}const vm = new Vue({el:"#app",// 2. 注册组件components: {"my-component": MyComponent}})</script>

在理解了组件的创建和注册过程后，我建议使用<script>或<template>标签来定义组件的HTML模板。

这使得HTML代码和JavaScript代码是分离的，便于阅读和维护。

另外，在Vue.js中，可创建.vue后缀的文件，.vue文件就是一个组件,称为单文件组件，这个内容我会在后面的文章介绍。

3. 组件选项对象中的特例

组件中的选项基本与实例选项对象一致, 但是有两个选项是特例,分别为el 和 data 属性

这个说的特例是指组件的选项对象和实例选项对象使用的不同

3.1 在组件中不能使用el

el属性的作用我们都了解了, 就是在实例中使用,决定Vue需要接管的DOM元素. 组件是在实例中使用,所以不需要el属性,
如果一个选项对象被注册为组件,添加el属性就会造成报错,

// 1. 创建局部组件的选项对象
let MyComponent = {el:"",template: "#myComponent",}const vm = new Vue({el:"#app",// 2. 将选项对象注册为局部组件components: {"my-component": MyComponent}
})// 会报错, 告诉你el属性只能在实例中使用

组件使用el选项报错.png

可以通过报错信息了解到, el选项只能使用在new创建的vue实例上

3.2 组件中data属性值必须是一个函数,

组件中的data选项必须是一个函数,返回一个数据对象.

为什么需要是一个函数,而不可以像Vue实例的选项对象一样是一个对象呢

3.2.1 组件data属性值如果是一个对象的问题

不能使用对象的原因:

首先因为组件会被多次复用,
而对象是引用数据类型,如果组件数据使用对象的话,那么组件所有的复用都共享这些数据,

这样就会出现问题,看代码:

示例代码如下:

<div id="app"><!-- 3. 使用组件 --><my-component></my-component><my-component></my-component><my-component></my-component>
</div><template id="myComponent"><div><h2>组件{{num}}</h2><button @click="handleClick">点击+1</button></div>
</template><script>// 组件共享数据let data = {num : 10}// 1. 选项对象let MyComponent = {template: "#myComponent",data: function(){return data},methods: {handleClick(){this.num++}}}const vm = new Vue({el:"#app",// 2. 注册组件components: {"my-component": MyComponent}})
</script>

示例结果:

组件data数据.png

实例说明:

如果在组件的data中直接写对象就会报错,
因此我们将data函数中返回的对象提取出来.这样所有的组件都共用一个数据对象.
一次来模拟组件data选项值为对象的情景

通过案例我们就会发现如果所有的组件都共享数据,当有一个组件中的数据发生了变化,所有的组件显示的数据都会发生变化, 这不是我们想要的,

3.2.2 解决组件共享数据的问题

所以组件的data数据属性才会需要函数,每次初始化化的时候都会执行函数,将返回的结果作为组件的数据,
这样每次执行函数都会给每个组件创建一个独立的数据

<div id="app"><!-- 3. 使用组件 --><my-component></my-component><my-component></my-component><my-component></my-component>
</div><template id="myComponent"><div><h2>组件{{num}}</h2><button @click="handleClick">点击+1</button></div>
</template><script>// 1. 选项对象let MyComponent = {template: "#myComponent",data: function(){// 每次函数执行都会返回新的数据,非共享数据return {num : 10}},methods: {handleClick(){this.num++}}}const vm = new Vue({el:"#app",// 2. 注册组件components: {"my-component": MyComponent}})</script>

显示结果:

组件data数据方法.png

通过示例就会发现, 当一个组件数据发生改变的时候, 其他组件的数据不会变化,因为每个组件都有自己独立的数据

3.3 组件的命名

当注册组件 (或者 prop) 时，可以使用 kebab-case (短横线分隔命名)、camelCase (驼峰式命名) 或 PascalCase (单词首字母大写命名)。

// 在组件定义中
components: {// 使用 kebab-case 注册'kebab-cased-component': { /* ... */ },// 使用 camelCase 注册 俗称小驼峰'camelCasedComponent': { /* ... */ },// 使用 PascalCase 注册 俗称大驼峰'PascalCasedComponent': { /* ... */ }
}

在 HTML 模板中，请使用 kebab-case：

<!-- 在 HTML 模板中始终使用 kebab-case -->
<kebab-cased-component></kebab-cased-component>
<camel-cased-component></camel-cased-component>
<pascal-cased-component></pascal-cased-component>

这个问题已经在前面认真探讨过了,这里不再详细阐述

4. 组件使用问题

通过上面上的例子我们已经了解了组件的使用,就是把组件名当做自定义标签使用,但是这种使用方法有的时候也会出现问题,

4.1. 组件标签解析错误

通过下面的实例了解组件标签解析时发生的问题.

例如:实例代码如下

<div id="app"><!-- 3. 使用组件 --><table><tbody><row></row><row></row><row></row></tbody></table>
</div><!-- 组件模板 -->
<template id="myComponent"><tr><td>内容</td><td>123</td></tr>
</template><script>// 1. 组件选项对象let MyComponent = {template: "#myComponent",}// 2. 注册组件const vm = new Vue({el:"#app",components: {"row": MyComponent}})</script>

显示结果:

template模板编译问题.png

实例中的写法,在查看代码结构时,发现子组件的tr标签并不在tbody里,

原因在与浏览器规范中tbody标签里面必须放tr标签,但是我们放的是row自定义标签,所以在解析的时候就会出问题

诸如此类的还有ul,ol标签里只能放li标签, select标签中只能放option,这些都是需要注意的事项

那么我们怎么解决这类问题呢?

4.2 通过is属性使用组件

vue允许我们使用is属性来使用组件, is属性的值是组件名

所以可以采用is属性来制定组件

示例代码如下:

<div id="app"><!-- 3. 使用组件 --><table><tbody><tr is="row"></tr><tr is="row"/><tr is="row"/></tbody></table>
</div>

显示结果:

通过is属性使用组件.png

此时我们就会发现不仅结果没问题, 编译后标签的嵌套也没有什么问题,

因为我们是按照标准在tbody标签中使用的是tr标签,只不过通过is属性将tr标签替换为了组件row的模板标签.

此时tr标签中没有嵌套内容,所有使用单标签,双标签都可以