组件是可复用的Vue
实例,且带有一个名字。我们可以在一个通过new Vue
创建的Vue
根实例中,把这个组件作为自定义元素来使用。
// 定义一个名为button-counter的新组件
Vue.component('button-counter', {
data: function () {
return {
count: 0
}
},
template: '<button v-on:click="count++">You clicked me {{ count }} times.</button>'
})
<div id="components-demo">
<button-counter></button-counter>
</div>
new Vue({ el: '#components-demo' })
因为组件是可复用的Vue
实例,所以它们与new Vue
接收相同的选项,例如data
、computed
、watch
、methods
以及生命周期钩子等。仅有的例外是像el
这样根实例特有的选项。
组件的复用
可以将组件进行任意次数的复用。
<div id="components-demo">
<button-counter></button-counter>
<button-counter></button-counter>
<button-counter></button-counter>
</div>
每个组件都会各自独立维护它的count
。因为你每用一次组件,就会有一个它的新实例被创建。
data必须是一个函数
当我们定义这个<button-counter>
组件时,你可能会发现它的data
并不是像这样直接提供一个对象。
data: {
count: 0
}
取而代之的是,一个组件的data
选项必须是一个函数,因此每个实例可以维护一份被返回对象的独立的拷贝。
data: function () {
return {
count: 0
}
}
组件的组织
通常一个应用会以一棵嵌套的组件树的形式来组织。
为了能在模板中使用,这些组件必须先注册以便Vue
能够识别。这里有两种组件的注册类型:全局注册和局部注册。
全局注册的组件可以用在其被注册之后的任何(通过new Vue
)新创建的Vue
根实例,也包括其组件树中的所有子组件的模板中。
通过Prop向子组件传递数据
Prop
是你可以在组件上注册的一些自定义特性。当一个值传递给一个prop
特性的时候,它就变成了那个组件实例的一个属性。
Vue.component('blog-post', {
props: ['title'],
template: '<h3>{{ title }}</h3>'
})
一个组件默认可以拥有任意数量的prop
,任何值都可以传递给任何prop
。
一个prop
被注册之后,你就可以像这样把数据作为一个自定义特性传递进来。
<blog-post title="My journey with Vue"></blog-post>
<blog-post title="Blogging with Vue"></blog-post>
示例:
new Vue({
el: '#blog-post-demo',
data: {
posts: [
{ id: 1, title: 'My journey with Vue' },
{ id: 2, title: 'Blogging with Vue' },
{ id: 3, title: 'Why Vue is so fun' },
]
}
})
<blog-post v-for="post in posts" v-bind:key="post.id" v-bind:title="post.title"></blog-post>
我们可以使用v-bind
来动态传递prop
。
单个根组件
当构建一个<blog-post>
组件时,你的模板最终会包含的东西远不止一个标题,最起码,会包含一个正文。
<h3>{{ post.title }}</h3>
<div v-html="post.content"></div>
然而如果在模板中尝试这样写,Vue
会显示一个错误,并解释道每个组件必须只有一个根元素。可以将模板的内容包裹在一个父元素内,来修复这个问题。
<div class="blog-post">
<h3>{{ post.title }}</h3>
<div v-html="post.content"></div>
</div>
通过事件向父级组件发送消息
在开发<blog-post>
组件时,它的一些功能可能要求我们和父级组件进行沟通。例如我们可能会引入一个可访问性的功能来放大博文的字号,同时让页面的其它部分保持默认的字号。
在其父组件中,我们可以通过添加一个postFontSize
数据属性来支持这个功能。
new Vue({
el: '#blog-posts-events-demo',
data: {
posts: [/* ... */],
postFontSize: 1
}
})
<div id="blog-posts-events-demo">
<div :style="{ fontSize: postFontSize + 'em' }">
<blog-post v-for="post in posts" v-bind:key="post.id"
v-bind:post="post" ></blog-post>
</div>
</div>
现在我们在每篇博文正文之前添加一个按钮来放大字号。
Vue.component('blog-post', {
props: ['post'],
template: `
<div class="blog-post">
<h3>{{ post.title }}</h3>
<button>
Enlarge text
</button>
<div v-html="post.content"></div>
</div>
`
})
当点击这个按钮时,我们需要告诉父级组件放大所有博文的文本。Vue
实例提供了一个自定义事件的系统来解决这个问题。我们可以调用内建的$emit
方法并传入事件的名字,来向父级组件触发一个事件。
<button v-on:click="$emit('enlarge-text')">Enlarge text</button>
然后我们可以用v-on
在博文组件上监听这个事件,就像监听一个原生DOM事件一样。
<blog-post
...
v-on:enlarge-text="postFontSize += 0.1"
></blog-post>
使用事件抛出一个值
有的时候用一个事件来抛出一个特定的值是非常有用的。例如我们可能想让<blog-post>
组件决定它的文本要放大多少。这时可以使用$emit
的第二个参数来提供这个值。
<button v-on:click="$emit('enlarge-text',0.1)">Enlarge text</button>
然后当在父级组件监听这个事件的时候,我们可以通过$event
访问到被抛出的这个值。
<blog-post
...
v-on:enlarge-text="postFontSize += $event"
></blog-post>
或者,如果这个事件处理函数是一个方法。
<blog-post
...
v-on:enlarge-text="onEnlargeText"
></blog-post>
那么这个值将会作为第一个参数传入这个方法。
methods: {
onEnlargeText: function (enlargeAmount) {
this.postFontSize += enlargeAmount
}
}
在组件上使用v-model
自定义事件也可以用于创建支持 v-model
的自定义输入组件。
<input v-model="searchText">
//等价于:
<input v-bind:value="searchText" v-on:input="searchText = $event.target.value">
当用在组件上时,v-model
则会这样:
<custom-input v-bind:value="searchText" v-on:input="searchText = $event"></custom-input>
为了让它正常工作,这个组件内的<input>
必须:
- 将其
value
特性绑定到一个名叫value
的prop
上 - 在其
input
事件被触发时,将新的值通过自定义的input
事件抛出
写成代码之后是这样的:
Vue.component('custom-input', {
props: ['value'],
template: `
<input
v-bind:value="value"
v-on:input="$emit('input', $event.target.value)"
>
`
})
现在v-model
就应该可以在这个组件上完美地工作起来了。
<custom-input v-model="searchText"></custom-input>
通过插槽分发内容
和HTML元素一样,我们经常需要向一个组件传递内容,像这样:
<alert-box>
Something bad happened.
</alert-box>
Vue
自定义的<slot>
元素让这变得非常简单。
Vue.component('alert-box', {
template: `
<div class="demo-alert-box">
<strong>Error!</strong>
<slot></slot>
</div>
`
})
我们只要在需要的地方加入插槽就行了。
动态组件
有的时候,在不同组件之间进行动态切换是非常有用的,比如在一个多标签的界面里:
上述内容可以通过
Vue
的<component>
元素加一个特殊的is
特性来实现。
<!-- 组件会在currentTabComponent改变时改变 -->
<component v-bind:is="currentTabComponent"></component>
currentTabComponent
可以包括:已注册组件的名字或一个组件的选项对象。
解析DOM模板时的注意事项
有些HTML元素,诸如<ul>
、<ol>
、<table>
和<select>
,对于哪些元素可以出现在其内部是有严格限制的。而有些元素,诸如<li>
、<tr>
和<option>
,只能出现在其它某些特定的元素内部。
这会导致我们使用这些有约束条件的元素时遇到一些问题。
<table>
<blog-post-row></blog-post-row>
</table>
这个自定义组件<blog-post-row>
会被作为无效的内容提升到外部,并导致最终渲染结果出错。幸好这个特殊的is
特性给了我们一个变通的办法。
<table>
<tr is="blog-post-row"></tr>
</table>
需要注意的是如果我们从以下来源使用模板的话,这条限制是不存在的:
- 字符串 (例如:
template: '...'
) - 单文件组件 (
.vue
) <script type="text/x-template">