vue官网学习笔记（九）组件基础

待我称王封你为后i 2022-02-19 11:13 261阅读 0赞

# 基本示例 #

这里有一个Vue组件的示例：

// 定义一个名为 button-counter 的新组件
    Vue.component('button-counter', {
        data: function () {
            return {
                count: 0
            }
        },
        template: '<button v-on:click="count++">You clicked me {
       { count }} times.</button>'
    })

组件是可复用的Vue实例，且带有一个名字：在这个例子中是 <button-counter>。我们可以在一个通过 new Vue 创建的Vue根实例中，把这个组件作为自定义元素来使用：

new Vue({ el: '#components-demo' })

因为组件是可复用的Vue实例，所以它们与 new Vue 接收相同的选项，例如 data 、computed、watch、methods 以及生命周期钩子等。仅有的例外是像el这样根实例特有的选项。

# 组件的复用 #

你可以将组件进行任意次数的复用：

注意当点击按钮时，每个组件都会独立维护它的 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中的值一样。

一个prop被注册之后，你就可以像这样把数据作为一个自定义特性传递进来：

<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。这在你一开始不清楚要渲染的具体内容，比如从一个API获取博文列表的时候，是非常有用的。

# 单个根元素 #

当构建一个 <blog-post> 组件时，你的模板最终会包含的东西远不止一个标题：

<h3>{
       { title }}</h3>

最最起码，你会包含这篇博文的正文：

<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>

看起来当组件变得越来越复杂的时候，我们的博文不只需要标题和内容，还需要发布日期、评论等等。为每个相关的信息定义一个prop会变得很麻烦：

<blog-post
        v-for="post in posts"
        v-bind:key="post.id"
        v-bind:title="post.title"
        v-bind:content="post.content"
        v-bind:publishedAt="post.publishedAt"
        v-bind:comments="post.comments"
    ></blog-post>

所以是时候重构一下这个<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>内可用。

# 监听子组件事件 #

在我们开发<blog-post>组件时，它的一些功能可能要求我们和父级组件进行沟通。例如我们可能会引入一个可访问性的功能来放大博文的字号，同时让页面的其它部分保持默认的字号。

在其父组件中，我们可以通过添加一个 postFontSize 数据属性来支持这个功能：

new Vue({
        el: '#blog-posts-events-demo',
        data: {
            posts: [/* ... */],
            postFontSize: 1
        }
    })

它可以在模板中用来控制所有博文的字号：

现在我们在每篇博文正文之前添加一个按钮来放大字号：

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>
        '
    })

问题是这个按钮不会做任何事：

<button>
        Enlarge text
    </button>

当点击这个按钮时，我们需要告诉父级组件放大所有博文的文本。幸好Vue实例提供了一个自定义事件的系统来解决这个问题。父级组件可以像处理native DOM事件一样通过 v-on 监听子组件实例的任意事件：

<blog-post
        ...
        v-on:enlarge-text="postFontSize += 0.1"
    ></blog-post>

同时子组件可以通过调用内建的$emit方法并传入事件名称来触发一个事件：

<button v-on:click="$emit('enlarge-text')">
        Enlarge text
    </button>

有了这个 v-on:enlarge-text="postFontSize += 0.1" 监听器，父级组件就会接收该事件并更新 postFontSize 的值。

### \#使用事件抛出一个值 ###

有的时候用一个事件来抛出一个特定的值是非常有用的。例如我们可能想让 <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-text>

那么这个值将会作为第一个参数传入这个方法：

methods: {
        onEnlargeText: function (enlargeAmount) {
            this.postFontSize += enlargeAmount
        }
    }

### \#在组件上使用 v-model ###

自定义事件也可以用于创建支持 v-model 的自定义输入组件。记住：

等价于：

当用在组件上时，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>

可能会渲染出这样的东西：

![20190417191809616.png][]

幸好，Vue自定义的 <slot> 元素让这变得非常简单：

Vue.component('alert-box', {
        template:'
            <div class="demo-alert-box">
                <strong>Error!</strong>
                <slot></slot>
            </div>
        '
    })

# 动态组件 #

不同组件之间进行动态切换是非常有用的，比如在一个多标签的界面里。

可以通过Vue的 <component> 元素加一个特殊的 is 特性来实现：

<component v-bind:is="currentTabComponent"></component>

在上述示例中， currentTabComponent 可以包括

1.已注册组件的名字，或

2.一个组件的选项对象

# 解析DOM模板时的注意事项 #

有些HTML元素，诸如 <ul>、<ol>、<table>和<select>，对于哪些元素可以出现在其内部是有严格限制的。而有些元素，诸如 <li>、<tr>和<option>，只能出现在其它某些特定的元素内部。

这会导致我们使用这些有约束条件的元素时遇到一些问题。例如：

这个自定义组件 <blog-post-row> 会被作为无效的内容提升到外部，并导致最终渲染结果出错。

幸好这个特殊的 is 特性给了我们一个变通的办法：