vue组件基础

组件是可复用的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接收相同的选项,例如datacomputedwatchmethods以及生命周期钩子等。仅有的例外是像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特性绑定到一个名叫valueprop
  • 在其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">
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 这篇笔记主要包含 Vue 2 不同于 Vue 1 或者特有的内容,还有我对于 Vue 1.0 印象不深的内容。关于...
    云之外阅读 10,471评论 0 29
  • 1.安装 可以简单地在页面引入Vue.js作为独立版本,Vue即被注册为全局变量,可以在页面使用了。 如果希望搭建...
    Awey阅读 13,797评论 4 129
  • 此文基于官方文档,里面部分例子有改动,加上了一些自己的理解 什么是组件? 组件(Component)是 Vue.j...
    陆志均阅读 9,251评论 5 14
  • Vue 实例 属性和方法 每个 Vue 实例都会代理其 data 对象里所有的属性:var data = { a:...
    云之外阅读 6,678评论 0 6
  • 有点儿冷,有风,还是下楼了。找荠菜没找到。今年行情这么差。计划没用,现实有用。 眼保健操、眼药水、眼贴。答应眼药水...
    荒岛黎明7809阅读 910评论 0 0