组件间通信

1、Vue组件的嵌套关系

1.1、认识组件的嵌套

前面我们是将所有的逻辑放到一个App.vue中

• 在之前的案例中我们只是创建了一个组件App
• 如果我们一个应用程序将所有的逻辑都放在一个组件中那么这个组件就会变成非常的臃肿和难以维护
• 所以组件化的核心思想应该是对组件进行拆分拆分成一个个小的组件
• 再将这些组件组合嵌套在一起最终形成我们的应用程序

我们来分析一下下面代码的嵌套逻辑假如我们将所有的代码逻辑都放到一个App.vue组件中

• 我们会发现将所有的代码逻辑全部放到一个组件中代码是非常的臃肿和难以维护的。
• 并且在真实开发中我们会有更多的内容和代码逻辑对于扩展性和可维护性来说都是非常差的。
• 所以在真实的开发中我们会对组件进行拆分拆分成一个个功能的小组件。

1.2、组件的拆分

我们可以按照如下的方式进行拆分

按照如上的拆分方式后我们开发对应的逻辑只需要去对应的组件编写就可。 

1.3、组件的通信

上面的嵌套逻辑如下它们存在如下关系

• App组件是Header、Main、Footer组件的父组件
• Main组件是Banner、ProductList组件的父组件

在开发过程中我们会经常遇到需要组件之间相互进行通信

• 比如App可能使用了多个Header每个地方的Header展示的内容不同那么我们就需要使用者传递给Header一些数据让其进行展示
• 又比如我们在Main中一次性请求了Banner数据和ProductList数据那么就需要传递给它们来进行展示
• 也可能是子组件中发生了事件需要由父组件来完成某些操作那就需要子组件向父组件传递事件

2、父子组件之间通信的方式

父子组件之间如何进行通信呢

• 父组件传递给子组件通过props属性
• 子组件传递给父组件通过$emit触发事件

 

3、父组件传递给子组件

• 在开发中很常见的就是父子组件之间通信比如父组件有一些数据需要子组件来进行展示
  • 这个时候我们可以通过props来完成组件之间的通信
• 什么是Props呢
  • Props是你可以在组件上注册一些自定义的attribute
  • 父组件给这些attribute赋值子组件通过attribute的名称获取到对应的值
• Props有两种常见的用法
  • 方式一字符串数组数组中的字符串就是attribute的名称
  • 方式二对象类型对象类型我们可以在指定attribute名称的同时指定它需要传递的类型、是否是必须的、默认值等等

3.1、Props的数组用法

3.2、Props的对象用法 

• 数组用法中我们只能说明传入的attribute的名称并不能对其进行任何形式的限制接下来我们来看一下对象的写法是如何让我们的props变得更加完善的。
• 当使用对象语法的时候我们可以对传入的内容限制更多
  • 比如指定传入的attribute的类型
  • 比如指定传入的attribute是否是必传的
  • 比如指定没有传入时attribute的默认值

3.3、细节一那么type的类型都可以是哪些呢 

• String
• Number
• Boolean
• Array
• Object
• Date
• Function
• Symbol

3.4、细节二对象类型的其他写法

3.5、细节三Prop的大小写命名 

Prop 的大小写命名(camelCase vs kebab-case)

• HTML 中的 attribute 名是大小写不敏感的所以浏览器会把所有大写字符解释为小写字符
• 这意味着当你使用 DOM 中的模板时camelCase (驼峰命名法) 的 prop 名需要使用其等价的 kebab-case (短横线分隔命名)命名

3.6、非Prop的Attribute 

• 什么是非Prop的Attribute呢
  • 当我们传递给一个组件某个属性但是该属性并没有定义对应的props或者emits时就称之为 非Prop的Attribute
  • 常见的包括class、style、id属性等
• Attribute继承
  • 当组件有单个根节点时非Prop的Attribute将自动添加到根节点的Attribute中

3.7、禁用Attribute继承和多根节点 

如果我们不希望组件的根元素继承attribute可以在组件中设置 inheritAttrs: false

• 禁用attribute继承的常见情况是需要将attribute应用于根元素之外的其他元素
• 我们可以通过 $attrs来访问所有的 非props的attribute

多个根节点的attribute

• 多个根节点的attribute如果没有显示的绑定那么会报警告我们必须手动的指定要绑定到哪一个属性上

3.8、示例 

ShowInfo.vue

<!--子组件-->
<template>
  <div class="infos">
    <h2 :class="$attrs.class">姓名: {{ name }}</h2>
    <h2>年龄: {{ age }}</h2>
    <h2>身高: {{ height }}</h2>

    <h2>Message: {{ showMessage }}</h2>
  </div>

  <!--下面这种绑定设置后根元素也不会进行绑定了-->
  <div class="others" v-bind="$attrs"></div>
</template>

<script>
  export default {
    // inheritAttrs: false, //  不希望组件的根元素继承attribute

    // 作用: 接收父组件传递过来的属性
    // 1.props数组语法
    // 弊端: 1> 不能对类型进行验证 2.没有默认值的
    // props: ["name", "age", "height"]

    // 2.props对象语法(必须掌握)
    props: {
      name: {
        type: String,
        default: "我是默认name"
      },
      age: {
        type: Number,
        required: true,
        default: 0
      },
      height: {
        type: Number,
        default: 2
      },
      // 重要的原则: 对象类型写默认值时, 需要编写default的函数, 函数返回默认值
      friend: {
        type: Object,
        default() {
          return {name: "james"}
        }
      },
      hobbies: {
        type: Array,
        default: () => ["篮球", "rap", "唱跳"]
      },
      showMessage: {
        type: String,
        default: "我是showMessage"
      }
    }
  }
</script>

<style scoped>
</style>

App.vue

<!--父组件-->
<template>
  <!-- 1.展示why的个人信息 -->
  <!-- 如果当前的属性是一个非prop的attribute, 那么该属性会默认添加到子组件的根元素上 -->
  <!--加上 :名字=""这个代表是js代码如果想要为字符串只需要这样 "''"  -->
  <show-info name="why" :age="18" :height="1.88"
             address="广州市" abc="cba" class="active"/>

  <!-- 2.展示kobe的个人信息 -->
  <show-info name="kobe" :age="30" :height="1.87"/>

  <!-- 3.展示默认的个人信息 -->
  <show-info :age="100" show-message="哈哈哈哈"/>

</template>

<script>
  import ShowInfo from './ShowInfo.vue'

  export default {
    components: {
      ShowInfo
    }
  }
</script>

<style scoped>
</style>

main.js

import { createApp } from 'vue'

import App from './App.vue'

createApp(App).mount('#app')

4、子组件传递给父组件

• 什么情况下子组件需要传递内容到父组件呢
  • 当子组件有一些事件发生的时候比如在组件中发生了点击父组件需要切换内容
  • 子组件有一些内容想要传递给父组件的时候
• 我们如何完成上面的操作呢
  • 首先我们需要在子组件中定义好在某些情况下触发的事件名称
  • 其次在父组件中以v-on的方式传入要监听的事件名称并且绑定到对应的方法中
  • 最后在子组件中发生某个事件的时候根据事件名称触发对应的事件

4.1、自定义事件的流程

我们封装一个CounterOperation.vue的组件

• 内部其实是监听两个按钮的点击点击之后通过 this.$emit的方式发出去事件

4.2、自定义事件的参数和验证了解 

自定义事件的时候我们也可以传递一些参数给父组件 

在vue3当中我们可以对传递的参数进行验证

4.3、示例 

AddCounter.vue

<template>
  <div class="add">
    <button @click="btnClick(1)">+1</button>
    <button @click="btnClick(5)">+5</button>
    <button @click="btnClick(10)">+10</button>
  </div>
</template>

<script>
  export default {
    // 1.emits数组语法,作用记录定义的监听事件。常用
    emits: ["add"],
    // 2.emmits对象语法与数组形式两者选其一
    // emits: {
    //   add: function(count) {
    //     if (count <= 10) {
    //       return true
    //     }
    //     return false  // 表示验证不通过验证不通过也能发送只不过会报警告。
    //   }
    // },
    methods: {
      btnClick(count) {
        console.log("btnClick:", count)
        // 让子组件发出去一个自定义事件
        // 第一个参数自定义的事件名称
        // 第二个参数是传递的参数
        this.$emit("add", count)
      }
    }
  }
</script>

<style scoped>
</style>

SubCounter.vue

<template>
  <div class="sub">
    <button @click="btnClick(1)">-1</button>
    <button @click="btnClick(5)">-5</button>
    <button @click="btnClick(10)">-10</button>
  </div>
</template>

<script>
  export default {
    methods: {
      btnClick(count) {
        this.$emit("sub", count)
      }
    }
  }
</script>

<style scoped>
</style>

App.vue

<template>
  <div class="app">
    <h2>当前计数: {{ counter }}</h2>

    <!-- 1.自定义add-counter, 并且监听内部的add事件 -->
    <add-counter @add="addBtnClick"></add-counter>

    <!-- 2.自定义sub-counter, 并且监听内部的sub事件 -->
    <sub-counter @sub="subBtnClick"></sub-counter>
  </div>
</template>

<script>
  import AddCounter from './AddCounter.vue'
  import SubCounter from './SubCounter.vue'

  export default {
    components: {
      AddCounter,
      SubCounter
    },
    data() {
      return {
        counter: 0
      }
    },
    methods: {
      addBtnClick(count) {
        this.counter += count
      },
      subBtnClick(count) {
        this.counter -= count
      }
    }
  }
</script>

<style scoped>
</style>

5、组件间通信案例练习

我们来做一个相对综合的练习

TabControl.vue

<template>
  <div class="tab-control">
    <template v-for="(item, index) in titles" :key="item">
      <div class="tab-control-item"
           :class="{ active: index === currentIndex }"
           @click="itemClick(index)">
        <span>{{ item }}</span>
      </div>
    </template>
  </div>
</template>

<script>
  export default {
    props: {
      titles: {
        type: Array,
        default: () => []
      }
    },
    data() {
      return {
        currentIndex: 0
      }
    },
    emits: ["tabItemClick"],
    methods: {
      itemClick(index) {
        this.currentIndex = index
        this.$emit("tabItemClick", index)
      }
    }
  }
</script>

<style scoped>
  .tab-control {
    display: flex;
    height: 44px;
    line-height: 44px;
    text-align: center;
  }

  .tab-control-item {
    flex: 1;
  }

  .tab-control-item.active {
    color: red;
    font-weight: 700;
  }

  .tab-control-item.active span {
    border-bottom: 3px solid red;
    padding: 8px;
  }
</style>

App.vue 

<template>
  <div class="app">
    <!-- 1.tab-control -->
    <tab-control :titles="['衣服', '鞋子', '裤子']" 
                 @tab-item-click="tabItemClick"/>

    <!-- <tab-control :titles="['流行', '最新', '优选']"/> -->

    <!-- 2.展示内容 -->
    <h1>{{ pageContents[currentIndex] }}</h1>
  </div>
</template>

<script>
  import TabControl from './TabControl.vue'

  export default {
    components: {
      TabControl
    },
    data() {
      return {
        pageContents: [ "衣服列表", "鞋子列表", "裤子列表" ],
        currentIndex: 0
      }
    },
    methods: {
      tabItemClick(index) {
        console.log("app:", index)
        this.currentIndex = index
      }
    }
  }
</script>

<style scoped>
</style>

main.js 

import { createApp } from 'vue'

import App from './App.vue'

createApp(App).mount('#app')