Vue.js（11）：组件基础

素颜马尾好姑娘i 2022-09-14 13:28 164阅读 0赞

# 一、基本实例         #

在这里演示的是一个简单的示例，但是在典型的 Vue 应用中，我们使用单个文件组件而不是字符串模板。你可以[在本节][Link 1]找到有关它们的更多信息。

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

<div id="webapp">
    			<button-counter></button-counter>
    		</div>
    		<script>
    			// 创建一个Vue 应用
    			const app = Vue.createApp({})
    			
    			// 定义一个名为 button-counter 的新全局组件
    			app.component('button-counter', {
    			  data() {
    			    return {
    			      count: 0
    			    }
    			  },
    			  template: `
    			    <button @click="count++">
    			      You clicked me {
       { count }} times.
    			    </button>`
    			})
    			
    			app.mount("#webapp");
    		</script>

因为组件是可复用的组件实例，所以它们与根实例接收相同的选项，例如 `data`、`computed`、`watch`、`methods` 以及生命周期钩子等。

# 二、组件的复用 #

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

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5ri4546L5a2Q_size_19_color_FFFFFF_t_70_g_se_x_16][]

注意当点击按钮时，每个组件都会各自独立维护它的 `count`。因为你每用一次组件，就会有一个它的新**实例**被创建。

# 三、组件的组织 #

通常一个应用会以一棵嵌套的组件树的形式来组织：

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5ri4546L5a2Q_size_20_color_FFFFFF_t_70_g_se_x_16][]

例如，你可能会有页头、侧边栏、内容区等组件，每个组件又包含了其它的像导航链接、博文之类的组件。

为了能在模板中使用，这些组件必须先注册以便 Vue 能够识别。这里有两种组件的注册类型：**全局注册**和**局部注册**。至此，我们的组件都只是通过 `component` 方法全局注册的：

const app = Vue.createApp({})
    
    app.component('my-component-name', {
      // ... 选项 ...
    })

全局注册的组件可以在应用中的任何组件的模板中使用。

到目前为止，关于组件注册你需要了解的就这些了，如果你阅读完本页内容并掌握了它的内容，我们会推荐你再回来把[组件注册][Link 2]读完。

# 四、通过 Prop 向子组件传递数据 #

早些时候，我们提到了创建一个博文组件的事情。问题是如果你不能向这个组件传递某一篇博文的标题或内容之类的我们想展示的数据的话，它是没有办法使用的。这也正是 prop 的由来。

Prop 是你可以在组件上注册的一些自定义 attribute。为了给博文组件传递一个标题，我们可以用 `props` 选项将其包含在该组件可接受的 prop 列表中：

<div id="webapp">
    			<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>
    		</div>
    		<script>
    			const app = Vue.createApp({})
    			
    			app.component('blog-post', {
    			  props: ['title'],	// props 定义组件中的属性
    			  template: `<h4>{
       { title }}</h4>`
    			})
    			
    			app.mount("#webapp");
    		</script>

当一个值被传递给一个 prop attribute 时，它就成为该组件实例中的一个 property。该 property 的值可以在模板中访问，就像任何其他组件 property 一样。

一个组件默认可以拥有任意数量的 prop，无论任何值都可以传递给 prop。

![20211008160811661.png][]

然而在一个典型的应用中，你可能在 `data` 里有一个博文的数组，并想要为每篇博文渲染一个组件：

<div id="webapp">
    			<blog-post
    			    v-for="post in posts"
    			    :key="post.id"
    			    :title="post.title"
    			  ></blog-post>
    		</div>
    		<script>
    			const App = {
    			  data() {
    			    return {
    			      posts: [
    			        { id: 1, title: 'My journey with Vue' },
    			        { id: 2, title: 'Blogging with Vue' },
    			        { id: 3, title: 'Why Vue is so fun' }
    			      ]
    			    }
    			  }
    			}
    			
    			const app = Vue.createApp(App)
    			
    			app.component('blog-post', {
    			  props: ['title'], // 自定义组件的属性
    			  template: `<h4>{
       { title }}</h4>`
    			})
    			
    			app.mount("#webapp");
    		</script>

如上所示，你会发现我们可以使用 `v-bind` 来动态传递 prop。这在你一开始不清楚要渲染的具体内容，是非常有用的。

到目前为止，关于 prop 你需要了解的大概就这些了，如果你阅读完本页内容并掌握了它的内容，我们会推荐你再回来把 [prop][] 读完。

#  五、监听子组件事件 #

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

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

const App = {
      data() {
        return {
          posts: [
            /* ... */
          ],
          postFontSize: 1
        }
      }
    }

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

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

app.component('blog-post', {
      props: ['title'],
      template: `
        <div class="blog-post">
          <h4>{
       { title }}</h4>
          <button>
            Enlarge text
          </button>
        </div>
      `
    })

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

<button>
      Enlarge text
    </button>

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

<blog-post ... @enlarge-text="postFontSize += 0.1"></blog-post>

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

<button @click="$emit('enlargeText')">
      Enlarge text
    </button>

多亏了 `@enlarge-text="postFontSize += 0.1"` 监听器，父级组件能够接收事件并更新 `postFontSize` 值。

我们可以在组件的 `emits` 选项中列出已抛出的事件：

app.component('blog-post', {
      props: ['title'],
      emits: ['enlargeText']
    })

这将允许我们检查组件抛出的所有事件，还可以选择[验证它们][Link 3]。

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

有的时候用一个事件来抛出一个特定的值是非常有用的。例如我们可能想让 `<blog-post>` 组件决定它的文本要放大多少。这时可以使用 `$emit` 的第二个参数来提供这个值：

<button @click="$emit('enlargeText', 0.1)">
      Enlarge text
    </button>

然后当在父级组件监听这个事件的时候，我们可以通过 `$event` 访问到被抛出的这个值：

<blog-post ... @enlarge-text="postFontSize += $event"></blog-post>

或者，如果这个事件处理函数是一个方法：

<blog-post ... @enlarge-text="onEnlargeText"></blog-post>

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

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

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

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

等价于：

当用在组件上时，`v-model` 则会这样：

<custom-input
      :model-value="searchText"
      @update:model-value="searchText = $event"
    ></custom-input>

请注意，我们在这里使用的是 `model-value`，因为我们使用的是 DOM 模板中的 kebab-case。你可以在[解析 DOM 模板时的注意事项][DOM]部分找到关于 kebab cased 和 camelCased 属性的详细说明。

为了让它正常工作，这个组件内的 `<input>` 必须：

*  将其 `value` attribute 绑定到一个名叫 `modelValue` 的 prop 上
 *  在其 `input` 事件被触发时，将新的值通过自定义的 `update:modelValue` 事件抛出

写成代码之后是这样的：

app.component('custom-input', {
      props: ['modelValue'],
      emits: ['update:modelValue'],
      template: `
        <input
          :value="modelValue"
          @input="$emit('update:modelValue', $event.target.value)"
        >
      `
    })

现在 `v-model` 就可以在这个组件上完美地工作起来了：

<custom-input v-model="searchText"></custom-input>

在该组件中实现 `v-model` 的另一种方法是使用 `computed` property 的功能来定义 getter 和 setter。`get` 方法应返回 `modelValue` property，`set` 方法应该触发相应的事件。

app.component('custom-input', {
      props: ['modelValue'],
      emits: ['update:modelValue'],
      template: `
        <input v-model="value">
      `,
      computed: {
        value: {
          get() {
            return this.modelValue
          },
          set(value) { 
            this.$emit('update:modelValue', value)
          }
        }
      }
    })

现在你只需要了解自定义组件事件，但一旦你读完本页并对其内容还觉得不错，我们建议你稍后再阅读有关[自定义事件][Link 4]。

# 六、通过插槽分发内容 #

和 HTML 元素一样，我们经常需要向一个组件传递内容，像这样：

<alert-box>
      Something bad happened.
    </alert-box>

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

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5ri4546L5a2Q_size_20_color_FFFFFF_t_70_g_se_x_16 1][]

这可以通过使用 Vue 的自定义 `<slot>` 元素来实现：

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

如你所见，我们使用 `<slot>` 作为我们想要插入内容的占位符——就这么简单！

到目前为止，关于插槽你需要了解的大概就这些了，如果你阅读完本页内容并掌握了它的内容，我们会推荐你再回来把[插槽][Link 5]读完。

# 七、动态组件 #

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

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5ri4546L5a2Q_size_20_color_FFFFFF_t_70_g_se_x_16 2][]

上述内容可以通过 Vue 的 `<component>` 元素加一个特殊的 `is` attribute 来实现：

<component :is="currentTabComponent"></component>

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

*  已注册组件的名字
 *  一个组件的选项对象

你可以在[这里][Link 6]查阅并体验完整的代码，或在[这个版本][Link 7]了解绑定组件选项对象，而不是已注册组件名的示例。

你也可以使用 `is` attribute 来创建常规的 HTML 元素。

到目前为止，关于动态组件你需要了解的大概就这些了，如果你阅读完本页内容并掌握了它的内容，我们会推荐你再回来把[动态 & 异步组件][Link 8]读完。

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

如果想在 DOM 中直接书写 Vue 模板，Vue 不得不从 DOM 中获取字符串。这会因为浏览器的原生 HTML 解析行为而导致一些小问题。

应该注意的是，下面讨论的限制仅适用于直接在 DOM 中编写模板的情况。它们不适用于以下来源的字符串模板：

*  字符串模板 (比如 `template: '...'`)
 *  [单文件组件][Link 1]
 *  `<script type="text/x-template">`

## Element Placement Restrictions ##

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

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

这个自定义组件 `<blog-post-row>` 会被作为无效的内容提升到外部，并导致最终渲染结果出错。我们可以使用特殊的 [is attribute][is_attribute] 作为一个变通的办法：

当它用于原生 HTML 元素时，`is` 的值必须以 `vue:` 开头，才可以被解释为 Vue 组件。这是避免和原生[自定义元素][Link 9]混淆。

## Case Insensitivity ##

另外，HTML attribute 名不区分大小写，因此浏览器将所有大写字符解释为小写。这意味着当你在 DOM 模板中使用时，驼峰 prop 名称和 event 处理器参数需要使用它们的 kebab-cased (横线字符分隔) 等效值：

//  在JavaScript中的驼峰
    app.component('blog-post', {
      props: ['postTitle'],
      template: `
        <h3>{
       { postTitle }}</h3>
      `
    })

<blog-post post-title="hello!"></blog-post>

到这里，你需要了解的解析 DOM 模板时的注意事项——实际上也是 Vue 的全部*必要*内容，大概就是这些了。

[Link 1]: https://v3.cn.vuejs.org/guide/single-file-component.html
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5ri4546L5a2Q_size_19_color_FFFFFF_t_70_g_se_x_16]: /images/20220828/7f66f3a52a1c4f5da71a5d6a22f23f59.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5ri4546L5a2Q_size_20_color_FFFFFF_t_70_g_se_x_16]: /images/20220828/bcc500fcd3a14a6da567c62033b6f3a3.png
[Link 2]: https://v3.cn.vuejs.org/guide/component-registration.html
[20211008160811661.png]: /images/20220828/58c3439c31d24095b733c7c49859d9eb.png
[prop]: https://v3.cn.vuejs.org/guide/component-props.html
[emit]: https://v3.cn.vuejs.org/api/instance-methods.html#emit
[Link 3]: https://v3.cn.vuejs.org/guide/component-custom-events.html#%E9%AA%8C%E8%AF%81%E6%8A%9B%E5%87%BA%E7%9A%84%E4%BA%8B%E4%BB%B6
[DOM]: https://v3.cn.vuejs.org/guide/component-basics.html#%E8%A7%A3%E6%9E%90-dom-%E6%A8%A1%E6%9D%BF%E6%97%B6%E7%9A%84%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9
[Link 4]: https://v3.cn.vuejs.org/guide/component-custom-events.html
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5ri4546L5a2Q_size_20_color_FFFFFF_t_70_g_se_x_16 1]: /images/20220828/cc770b0bf469422daf4a1310ee016bc1.png
[Link 5]: https://v3.cn.vuejs.org/guide/component-slots.html
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5ri4546L5a2Q_size_20_color_FFFFFF_t_70_g_se_x_16 2]: /images/20220828/59b38f955005483aaa9407659320faf9.png
[Link 6]: https://codepen.io/team/Vue/pen/oNXaoKy
[Link 7]: https://codepen.io/team/Vue/pen/oNXapXM
[Link 8]: https://v3.cn.vuejs.org/guide/component-dynamic-async.html
[is_attribute]: https://v3.cn.vuejs.org/api/special-attributes.html#is
[Link 9]: https://html.spec.whatwg.org/multipage/custom-elements.html#custom-elements-customized-builtin-example