组件从注册方式分为全局组件和局部组件。
从功能类型又可以分为偏视图表现的(presentational)和偏逻辑的(动态生成dom),推荐在前者中使用模板,在后者中使用 JSX 或渲染函数动态生成组件模板内容,整体来说表现类的组件远远多于逻辑类组件。
定义组件
注意:组件名最好使用全小写加短横线,即使用 kebab-case (短横线分隔命名) 定义一个组件,在引用这个自定义元素时必须使用 kebab-case,
当使用 PascalCase (首字母大写命名) 定义一个组件时,在引用这个自定义元素时两种命名法都可以使用。
Vue.component('MyComponentName', { /* ... */ })
也就是说 <my-component-name>
和 <MyComponentName>
都是可接受的。
全局组件
Vue.component,在new根实例之前定义全局组件
// 定义一个名为 button-counter 的全局组件
Vue.component('button-counter', {
data: function () {
return {
count: 0
}
},
template: '<button v-on:click="count++">You clicked me {{ count }} times.</button>'
}) //使用:
<button-counter></button-counter>
显示如图:
局部组件
全局注册的组件,对于不再使用的,仍会被包含在最终的构建结果中,造成了用户下载的 JavaScript 的增加。
局部组件有几种注册形式,这里介绍单文件组件。
一个单文件组件即一个vue文件,包含template(必须有),script,style三部分。
JavaScript、CSS 分离成独立的文件然后做到热重载和预编译。
<!-- my-component.vue -->
<template>
<div>This will be pre-compiled</div>
</template>
<script src="./my-component.js"></script>
<style src="./my-component.css"></style>
每个组件必须有且只有一个根元素,使用组件时,组件上的特性也会被添加到根元素上,根元素上已有的同名特性会被覆盖,除了class和style,会与组件的class和style合并,详细见下面“引用第三方库”
//com.vue
<template lang="html">
<div>//只能有一个html标签包裹里面所有节点
child component{{name}}
</div>
</template>
<script>
export default{
data(){//data部分必须是个函数,返回一个对象。当前组件可以使用data里面的数据
return {
name:'com'
}
}
}
</script>
<style lang="css">
</style>
引入单文件组件
//App.vue引入组件
import HelloWorld from "./components/HelloWorld";
//在页面实例注入组件
components: {
HelloWorld
},
//在页面使用组件
<HelloWorld />
//或者
<HelloWorld><HelloWorld />
组件的定义方法,参考边界处理之模板定义的替代品。
关于template标签。
组件的复用
每用一次组件,就会有一个它的新实例被创建,每个组件都会各自独立维护自身属性,互相独立不干扰,这也是为什么组件的data是一个函数的原因:
<button-counter></button-counter>
<button-counter></button-counter>
<button-counter></button-counter>
父子组件
上面例子中,App.vue的components上挂载了HelloWorld这个组件,其中App.vue是父组件,HelloWorld是子组件。
父子组件通信
props(参考博文):父组件传递消息给子组件,为单向的,意味着不应该在一个子组件内部改变 prop。
每次父组件发生更新时,子组件中所有的 prop 都将会刷新为最新的。
//子组件中声明props
<template lang="html">
<div>
年龄:{{age}}
</div>
</template>
<script>
export default{
props:['age'],
data(){
return{
name:'com'
}
}
}
</script> //组件特性传入prop值
<com age="19"></com>//静态数据
<com :age="ageNum"></com>//动态数据:变量
两种常见的试图改变一个 prop 的情形
1、这个 prop 用来传递一个初始值;这个子组件接下来希望将其作为一个本地的 prop 数据来使用。在这种情况下,最好定义一个本地的 data 属性并将这个 prop 用作其初始值:
props: ['initialCounter'],
data: function () {
return {
counter: this.initialCounter
}
}
2、这个 prop 以一种原始的值传入且需要对这个值进行操作。在这种情况下,最好使用这个 prop 的值来定义一个计算属性:
props: ['size'],
computed: {
normalizedSize: function () {
return this.size.trim().toLowerCase()
}
}
注意在 JavaScript 中对象和数组是通过引用传入的,所以对于一个数组或对象类型的 prop 来说,在子组件中改变这个对象或数组本身将会影响到父组件的状态。
$emit:子组件向父组件传递数据
比如下面,点击子组件的这个按钮(子组件接收的用户行为),触发组件自定义的patch事件,执行patch事件的处理函数msg3,改变父组件的ageNum数据
在子组件中代码:
<button type="button" name="button" @click="$emit('patch',[参数])">发送到父组件</button>
父组件中代码:
<com :age="ageNum" @patch='msg3'></com>//动态数据:变量
export default{
data(){
return {
ageNum: 18
}
},
methods: {
msg3(params){
//params:子组件传递过来的参数
this.ageNum++
}
}
}
vm.$attrs
属性和vm.$listeners属性(单向传值,查阅博文:实例属性和方法)
常用在跨级组件中,祖孙组件通信。
组件上使用v-model指令
查阅博文:v-model。
组件上的原生事件
在一个组件的根元素上直接监听一个原生事件,使用 v-on
的 .native
修饰符。
<base-input v-on:focus.native="onFocus"></base-input>
插槽和作用域插槽
查阅博文:slot。
引用第三方库的组件
组件可以接受任意的特性,而这些特性会被添加到这个组件的根元素上。
例如,你通过一个 Bootstrap 插件使用了一个第三方的 <bootstrap-date-input>
组件,然后这个 data-date-picker="activated"
特性就会自动添加到 <bootstrap-date-input>
这个组件的根元素上:
<bootstrap-date-input
data-date-picker="activated"
class="date-picker-theme-dark"
></bootstrap-date-input>
该组件根元素为:
<input type="date" class="form-control">
替换/合并根元素已有特性
对于绝大多数特性来说,从外部提供给组件的值会替换掉组件内部设置好的值。所以如果组件上有 type="text"
,input的 type="date"
就会被替换掉并被破坏!class
和 style
特性会把两边的值会被合并起来,最终的值:form-control date-picker-theme-dark
。
最终,input为:
<input
type="date"
data-date-picker="activated"
class="form-control date-picker-theme-dark">
禁用特性继承
如果你不希望组件的根元素继承特性,你可以在组件的选项中设置 inheritAttrs: false
,该选项不会影响 style
和 class
的绑定。适合配合实例的 $attrs
属性使用。
组件嵌套在有嵌套规则的标签里
有些 HTML 元素,诸如 <ul>
、<ol>
、<table>
和 <select>
,对于哪些元素可以出现在其内部是有严格限制的。而有些元素,诸如 <li>
、<tr>
和 <option>
,只能出现在其它某些特定的元素内部。
//这个自定义组件 <blog-post-row> 会被作为无效的内容提升到外部
<table>
<blog-post-row></blog-post-row>
</table>
通过is特性解决:
<table>
<tr is="blog-post-row"></tr>
</table>
动态组件
使用vue内置标签<component>,通过添加is特性来切换不同的组件。
比如:在一个多标签的界面中切换不同的组件(这个标签的位置渲染为那个组件)
<!-- 组件会在 `currentTabComponent` 改变时改变 -->
<component v-bind:is="currentTabComponent"></component>
在上述示例中,currentTabComponent
可以是
- 已注册组件的名字
- 一个组件的选项对象(推荐)
当想保持组件被切换时的状态,以避免反复重渲染导致的性能问题。
比如下例,posts的第二个文章被选中,切换到 Archive 标签,然后再切换回 Posts,是不会继续展示之前选择的文章的。
需求:组件实例能够在它们第一次被创建的时候缓存下来。
方案:<keep-alive> 元素将动态组件包裹起来。
参考博文:vue内置标签。
异步组件
在需要的时候才从服务器加载一个模块,Vue 提供一个工厂函数,resolve 回调会在从服务器得到组件定义的时候被调用。
Vue.component('async-example', function (resolve, reject) {
setTimeout(function () {//setTimeout 是为了演示用的,如何获取组件取决于业务。
// 向 `resolve` 回调传递组件定义
resolve({
template: '<div>I am async!</div>'
})
}, 1000)
})
一个推荐的做法是将异步组件和 webpack 的 code-splitting 功能一起配合使用:
Vue.component('async-webpack-example', function (resolve) {
// 这个特殊的 `require` 语法将会告诉 webpack
// 自动将你的构建代码切割成多个包,这些包
// 会通过 Ajax 请求加载
require(['./my-async-component'], resolve)
})
也可以在工厂函数中返回一个 Promise:
Vue.component(
'async-webpack-example',
// 这个 `import` 函数会返回一个 `Promise` 对象。
() => import('./my-async-component')
)
当使用局部注册的时候,你也可以直接提供一个返回 Promise
的函数:
new Vue({
// ...
components: {
'my-component': () => import('./my-async-component')
}
})
处理加载状态:
const AsyncComponent = () => ({
// 需要加载的组件 (应该是一个 `Promise` 对象)
component: import('./MyComponent.vue'),
// 异步组件加载时使用的组件
loading: LoadingComponent,
// 加载失败时使用的组件
error: ErrorComponent,
// 展示加载时组件的延时时间。默认值是 200 (毫秒)
delay: 200,
// 如果提供了超时时间且组件加载也超时了,
// 则使用加载失败时使用的组件。默认值是:`Infinity`
timeout: 3000
})
在 Vue Router 的路由组件中使用上述语法的话,必须使用 Vue Router 2.4.0+ 版本。
组件值之处理边界情况
介绍组件使用中遇到的一些问题:父子孙组件的访问,组件循环或者互相引用,模板其他的定义方式,强制更新(数组或对象的变更检测注意事项,或者可能依赖了非响应式状态),在根元素使用v-once创建静态组件。
基础组件一次性引入
推荐创建一个 components
目录管理单文件组件。
针对基础组件的长列表的改善:
import BaseButton from './BaseButton.vue'
import BaseIcon from './BaseIcon.vue'
import BaseInput from './BaseInput.vue' export default {
components: {
BaseButton,
BaseIcon,
BaseInput
}
}
使用webpack(或在内部使用了 webpack 的 Vue CLI 3+)的前提下,使用 require.context
全局注册这些基础组件。
以下代码放在应用入口文件 (比如 src/main.js
) 中全局导入基础组件
import Vue from 'vue'
import upperFirst from 'lodash/upperFirst'
import camelCase from 'lodash/camelCase' const requireComponent = require.context(
// 其组件目录的相对路径
'./components',
// 是否查询其子目录
false,
// 匹配基础组件文件名的正则表达式
/Base[A-Z]\w+\.(vue|js)$/
) requireComponent.keys().forEach(fileName => {
// 获取组件配置
const componentConfig = requireComponent(fileName) // 获取组件的 PascalCase 命名
const componentName = upperFirst(
camelCase(
// 剥去文件名开头的 `./` 和结尾的扩展名
fileName.replace(/^\.\/(.*)\.\w+$/, '$1')
)
) // 全局注册组件
Vue.component(
componentName,
// 如果这个组件选项是通过 `export default` 导出的,
// 那么就会优先使用 `.default`,
// 否则回退到使用模块的根。
componentConfig.default || componentConfig
)
})