认识Vue组件

桃扇骨 2021-09-19 23:44 287阅读 0赞

# 前言 #

Vue.js是一套构建用户界面的渐进式框架（官方说明）。通俗点来说，Vue.js是一个轻量级的，易上手易使用的，便捷，灵活性强的前端MVVM框架。简洁的API，良好健全的中文文档，使开发者能够较容易的上手Vue框架。

本系列文章将结合个人在使用Vue中的一些经(cai)验(keng)和一些案例，对Vue框架掌握的部分知识进行输出，同时也巩固对Vue框架的理解。

> # **认识组件** #

组件是 Vue 强大的功能之一。Vue组件具有封装可复用的特点，能够让你在复杂的应用中拆分成独立模块使用。注意，所有的 Vue 组件同时也都是 Vue 的实例，可接受相同的选项对象。

## **Vue组件的注册** ##

我们可以通过全局注册和局部注册的方式来注册一个 Vue 组件，两种方式的区别在于，全局注册的组件能够在任何地方使用，其实就是所有的 Vue 实例化的时候都会去渲染这个全局组件；而局部组件只是注册在某一个 Vue 实例化对象上，只能在这个 Vue 实例化的时候会渲染，其他地方使用会被当成普通的Html标签渲染。我们就先来了解下全局组件的注册。  
Vue 组件全局注册时通过 `Vue.component(tagName, options)` 方式注册。 看一个简单的示例。

<div id="app" class="demo">
         <simple-component></simple-component> </div> <script> Vue.component("simple-component", { template: "<span>我是一个最简单的Vue组件示例</span>" }) new Vue({ el: "#app" }) </script> 复制代码

Vue.component 方法中传入两个参数，一个参数是组件的自定义标签名，另一个参数是一个对象，里面的template属性的值就是组件的模板。

可能你会想，组件的内容太简单了吧，只有一个标签，要是内容复杂点的组件，难道也要像以前一样用字符串把内容都拼接起来吗？感觉太恐怖了，就算是使用了es6的字符串语法，写下去也是一大推，很不优雅感觉。嗯，是的，针对这个问题，在 Vue 中给出了良好的解决方案，可以使用 `<script type="x-template">` 标签来处理复杂的组件模板。

<div id="app2" class="demo">
        <vut-button></vut-button>
    </div>
    <script type="x-template" id="vComponent">
        <div class="vut-button">
            <span>我是Button组件</span>
        </div>
    </script>
    
    <script>
        Vue.component("vut-button", {
            template: "#vComponent"
        })
        new Vue({
            el: "#app2"
        })
    </script>
    复制代码

当然，为了能够让代码看起来更加清晰明了点，你可以使用 `template` 标签来包裹组件模板，`template` 标签在浏览器渲染过程中不会被渲染出来。

<div id="app-test" class="demo">
        <vut-button></vut-button>
    </div>
    <template id="vComponent">
        <div class="vut-button">
            <span>我是Button组件</span>
        </div>
    </template>
    
    <script>
        Vue.component("vut-button", {
            template: "#vComponent"
        })
        new Vue({
            el: "#app-test"
        })
    </script>
    复制代码

好了，那么局部组件应该怎么注册呢？你可以通过在Vue实例选项`components`注册仅在其作用域中可用的局部组件。

<div id="app-local" class="demo">
         <simple-component></simple-component> </div> <script> new Vue({ el: "#app-local", components: { "simple-component": { template: "<span>我是一个最简单的局部Vue组件示例</span>" } } }) </script> 复制代码

Vue实例选项`components`包含了一个属性，键是组件的名称，值是一个对象，包含了组件的模板等属性。

## **使用 Prop 传递数据** ##

每个Vue组件实例都有独立范围的作用域的，这意味着子组件的模板中无法获取到父组件的数据，那么Vue可以通过使用props参数来实现父组件向子组件传递数据。

<div id="app" class="demo">
        <simple-component link="https://github.com/vuejs/vue"></simple-component>
    </div>
    <script>
        Vue.component("simple-component", {
            template: "<span>Vue的github地址是：{
        { link }}</span>",
            props: ["link"]
        })
        new Vue({
            el: "#app"
        })
    </script>
    复制代码

可以看到，我们定义了一个props数组接收来自父组件传递的数据，因为父组件传递的数据可能是多个。而事实上，props不一定是数组，也可以是对象，可以详细的指定父组件传递的数据规则，包括默认值，数据类型等。

props: {
        link: {
            type: String, //数据类型
            defalut: "https://www.baidu.com/" //默认值
        }
    }
    复制代码

那么父组件如何动态的传递数据给子组件呢？还记得v-bind指令的作用吗，其作用是`用于动态绑定html属性或者是组件的props值`，所以应该使用v-bind指令来动态传递数据。

<template id="userComponent">
        <div>
            <p>用户名：{
        { userName }}</p>
            <p>性别：{
        { sex }}</p>
            <p>年龄：{
        { age }}</p>
        </div>
    </template>
    <script type="text/javascript">
        Vue.component("user-component", {
            template: "#userComponent",
            props: ["userName", "sex", "age"]
        })
    </script>
    <div id="app2" class="demo">
        <div>
            <input type="text" v-model="userName" placeholder="请输入用户名">
            <input type="text" v-model="sex" placeholder="请输入性别">
            <input type="text" v-model="age" placeholder="请输年龄">
        </div>
        <user-component
        :user-name="userName"
        :sex="sex"
        :age="age"
        >
        </user-component>
    </div>
    <script type="text/javascript">
        new Vue({
            el: "#app2",
            data: {
                userName: "",
                sex: "",
                age: ""
            }
        })
    </script>
    复制代码

## **使用自定义事件实现子组件向父组件通信** ##

我们知道，父组件使用 prop 传递数据给子组件。但子组件怎么跟父组件通信呢？这个时候 Vue 的自定义事件系统就派得上用场了。  
假设我们在写一个评论系统，评论部分是Vue组件，评论提交之后我们要将评论的内容展示出来。  
先来写出评论组件吧

<template id="comment-component">
        <div class="i-comment-area">
            <textarea rows="5" class="i-textarea" placeholder="请输入内容" v-model="commentValue"></textarea>
            <div class="i-comment-submit" @click="handleSubmit">
                <span>提交</span>
            </div>
        </div>
    </template>
    复制代码

评论组件模板包含了一个输入框和一个提交评论的按钮，就这么简单，然后，就全局注册这个组件

Vue.component("i-comment", {
        template: "#comment-component",
        data: function(){
            return {
                commentValue: ""
            }
        },
        methods: {
          handleSubmit: function(){
              if(this.commentValue.length < 1){
                  alert("评论不能为空");
                  return;
              }
              this.$emit("content", this.commentValue);
              this.commentValue = "";
          }
        }
    })
    复制代码

可能你会发现，组件里的data实例选项跟之前的写法不一样，是的，这个在写组件的时候要注意的地方，`Vue规定了组件中的data选项必须是函数`。然后给提交按钮绑定了一个点击事件`handleSubmit`，当你填写了评论内容，并点击提交评论的时候，组件会通过 `$emit(eventName)` 触发事件，并带有一个参数，就是把评论的内容传递给父组件。

既然子组件是通过 `$emit(eventName)`来和父组件通信，那么父组件如何接收子组件传递过来的数据呢，答案是，使用 `$on(eventName)` 监听事件。

<div id="simple-comment" class="demo">
        <i-comment v-on:content="commentData"></i-comment>
        <label class="title">评论列表</label>
        <ul class="comment-list">
            <li v-for="(item,index) in commentList">
                <span>{
        { item.time }}</span>
                <span>{
        { item.content }}</span>
            </li>
        </ul>
    </div>
    复制代码

在父组件中，监听子组件中定义的事件名，并调用一个方法 `commentData`。commentData方法用来获取子组件传递给父组件的参数，这样就是一个子组件向父组件通信的过程。 可以查看[完整的例子][Link 1] 。

# **实现一个 Switch UI 组件** #

接下来，通过实际动手来实现一个 Switch UI 组件。首先思考下Switch组件需要有哪些基本的API。

>  *  考虑到使用场景，需要制定不同尺寸的Switch组件，所以需要 `size` API。
>  *  考虑到会出现禁止使用的场景，需要禁止和启用组件的功能，所以需要 `disabled` API。
>  *  考虑到需要自定义开启和关闭时的背景颜色，所以需要 `on-color` 和 `off-color` API来自定义背景色。
>  *  同理，可能需要自定义开启和关闭时显示的文字，所以需要 `on-text` 和 `off-text` API来自定义显示的文字。
>  *  可能还会需要通过事件监听来获取当前的状态，并根据状态做一些操作，所以需要一个事件来监听状态的变化，所以需要 `on-change` API。

那么基本的API都列出来了，现在就可以开始一步步实现这些功能了。首先写出组件模板的基本框架。

<span :class="wrapClass">
        <span :class="switchClass" @click="handleChangeFn" ref="switch">
            <input type="hidden" :value="currentValue">
        </span>
    </span>
    复制代码

然后得注册这个组件吧。

基本上架子就搭建好了。 然后就开始实现那些列出来的API。先来看如何实现size尺寸。

size尺寸的值肯定是通过父组件传递过来的，所以就先在子组件中的props选项中定义好size对象。

props: {
        value: {
            type: Boolean,
            default: false
        },
        size: String //尺寸
    }
    复制代码

然后我们的思路是通过不同的样式来控制渲染出来的Switch组件。我们根据传入的不同尺寸的值来添加不同的Class值，制定不同的样式，所以switchClass计算属性中可这么写：

switchClass: function(){
        return [
            prefixClass,
            {
                [prefixClass + "-checked"]: this.currentValue,
                [prefixClass +"-"+ this.size]: this.size
            }
        ];
    }
    复制代码

然后就是添加对应的样式。

/*小尺寸*/
    .vut-switch-small{
        width: 40px;
        height: 20px;
    }
    .vut-switch-small:after{
        width: 16px;
        height: 16px;
    }
    .vut-switch-small.vut-switch-checked:after{
        left: 22px;
    }
    
    /*大尺寸*/
    .vut-switch-large{
        width: 60px;
    }
    .vut-switch-large.vut-switch-checked:after{
        left: 38px;
    }
    复制代码

最后我们就在Vue实例初始化模板中使用Switch组件。

<vut-switch size="small"></vut-switch>
    <vut-switch size="large"></vut-switch>
    复制代码

这样我们就可以控制显示Switch组件的尺寸了，效果如下：

然后来看看如何实现自定义背景色的。同样也是先在子组件的props选项中定义好传递过来的数据。

props: {
        value: {
            type: Boolean,
            default: false
        },
        size: String, //尺寸
        onColor: String, //开启时的自定义背景色
        ofColor: String //关闭时的自定义背景色
    }
    复制代码

然后我们通过当前的状态来控制显示不同的背景色，也就是要关注 `currentValue` 值。先来写一个设置背景色的函数，根据currentValue值的变化来设置背景色。

setBackgroundColor: function(){
        let customColor = this.currentValue ? this.onColor : this.offColor;
        this.$refs.switch.style.backgroundColor = customColor;
    }
    复制代码

然后监听currentValue值的变化来调用这个函数。

watch: {
        currentValue: function(){
            this.setBackgroundColor();
        }
    }
    复制代码

最后我们就在Vue实例初始化模板中使用Switch组件。

<vut-switch on-color="#13ce66" off-color="#ff4949"></vut-switch>
    复制代码

效果如下：

完整的例子请查看 [switch组件][switch] 。

# 后记 #

本着学习和总结的态度写的文章，文中有任何错误和问题，可以在github上指出 [issues][] 。文中的案例都放置在github上，地址：[github.com/webproblem/…][github.com_webproblem]。

[Link 1]: https://link.juejin.im?target=https%3A%2F%2Fgithub.com%2Fwebproblem%2FIntoVue%2Ftree%2Fmaster%2Fexample%2Fcomponent%2Fprops%25E4%25BC%25A0%25E9%2580%2592%25E6%2595%25B0%25E6%258D%25AE.html
[switch]: https://link.juejin.im?target=https%3A%2F%2Fgithub.com%2Fwebproblem%2FIntoVue%2Ftree%2Fmaster%2Fexample%2Fcomponent%2Ftodolist%2Fswitch
[issues]: https://link.juejin.im?target=https%3A%2F%2Fgithub.com%2Fwebproblem%2FIntoVue%2Fissues
[github.com_webproblem]: https://link.juejin.im?target=https%3A%2F%2Fgithub.com%2Fwebproblem%2FIntoVue