目录
组件基础
基本示例
组件是可复用的 Vue 实例,且带有一个名字
// 定义一个名为 button-counter 的新组件 Vue.component('button-counter', { data: function () { return { count: 0 } }, template: '<button v-on:click="count++">You clicked me {{ count }} times.</button>' }) new Vue({ el: '#components-demo' })
<div id="components-demo"> <button-counter></button-counter> </div>
因为组件是可复用的 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 没有这条规则,点击一个按钮就可能会像如下代码一样影响到其它所有实例
组件的组织
通常一个应用会以一棵嵌套的组件树的形式来组织:
为了能在模板中使用,这些组件必须先注册以便 Vue 能够识别。这里有两种组件的注册类型:全局注册和局部注册。至此,我们的组件都只是通过
Vue.component
全局注册的:Vue.component('my-component-name', { // ... options ... })
全局注册的组件可以用在其被注册之后的任何 (通过
new Vue
) 新创建的 Vue 根实例,也包括其组件树中的所有子组件的模板中。
通过 Prop 向子组件传递数据
Prop 是你可以在组件上注册的一些自定义特性。当一个值传递给一个 prop 特性的时候,它就变成了那个组件实例的一个属性。为了给博文组件传递一个标题,我们可以用一个
props
选项将其包含在该组件可接受的 prop 列表中:Vue.component('blog-post', { props: ['title'], template: '<h3>{{ title }}</h3>' })
一个组件默认可以拥有任意数量的 prop,任何值都可以传递给任何 prop。在上述模板中,你会发现我们能够在组件实例中访问这个值,就像访问
data
中的值一样。<blog-post title="My journey with Vue"></blog-post> <blog-post title="Blogging with Vue"></blog-post> <blog-post title="Why Vue is so fun"></blog-post>
在
data
里有一个博文的数组: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>{{ title }}</h3> <div v-html="content"></div>
然而如果你在模板中尝试这样写,Vue 会显示一个错误,并解释道 every component must have a single root element (每个组件必须只有一个根元素)。你可以将模板的内容包裹在一个父元素内,来修复这个问题,例如:
<div class="blog-post"> <h3>{{ title }}</h3> <div v-html="content"></div> </div>
重构一下这个
<blog-post>
组件了,让它变成接受一个单独的post
prop:<blog-post v-for="post in posts" v-bind:key="post.id" v-bind:post="post" ></blog-post>
Vue.component('blog-post', { props: ['post'], template: ` <div class="blog-post"> <h3>{{ post.title }}</h3> <div v-html="post.content"></div> </div> ` }) // 模板字符串 使用``反引号
上述的这个和一些接下来的示例使用了 JavaScript 的模板字符串来让多行的模板更易读。它们在 IE 下并没有被支持,所以如果你需要在不 (经过 Babel 或 TypeScript 之类的工具) 编译的情况下支持 IE,请使用折行转义字符取而代之。
现在,不论何时为
post
对象添加一个新的属性,它都会自动地在<blog-post>
内可用。
监听子组件事件
现在我们在每篇博文正文之前添加一个按钮来放大字号
Vue.component('blog-post', { props: ['post'], template: ` <div class="blog-post"> <h3>{{ post.title }}</h3> <button v-on:click="$emit('enlarge-text')"> Enlarge text </button> <div v-html="post.content"></div> </div> ` })
<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" v-on:enlarge-text="postFontSize += 0.1" ></blog-post> </div> </div>
上述的这个和一些接下来的示例使用了 JavaScript 的模板字符串来让多行的模板更易读。它们在 IE 下并没有被支持,所以如果你需要在不 (经过 Babel 或 TypeScript 之类的工具) 编译的情况下支持 IE,请使用折行转义字符取而代之。
现在,不论何时为
post
对象添加一个新的属性,它都会自动地在<blog-post>
内可用。使用事件抛出一个值
使用
$emit
的第二个参数来抛出一个特定的值<!-- 模板内容 --> <button v-on:click="$emit('enlarge-text', 0.1)"> Enlarge text </button> <!-- 父级 --> <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
<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>
必须:1、将其 value 特性绑定到一个名叫 value 的 prop 上
2、在其 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 模板时的注意事项
is 特性
有些 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">