---

1 自定义事件

在封装组件时，为了让组件的使用者可以监听到组件内状态的变化，此时需要用到组件的自定义事件。

2 自定义事件的 3 个使用步骤

在封装组件时：

① 声明自定义事件
② 触发自定义事件

在使用组件时：

③ 监听自定义事件

2.1 声明自定义事件

开发者为自定义组件封装的自定义事件，必须事先在 emits 节点中声明。

<template>
  <div>
    <h3>Counter 组件</h3>
    <button> +1 </button>
  </div>
</template>

<script>
export default {
  name: 'Counter',
  // Counter 组件的自定义事件必须事先声明到 emits 节点中
  emits: ['change']
}
</script>

<style>

</style>

2.2 触发自定义事件

在 emits 节点下声明的自定义事件，可以通过 this.$emit(‘自定义事件的名称’) 方法进行触发。

<template>
  <div>
    <h3>Counter 组件</h3>
    <p>{{ count }}</p>
    <button @click="add"> +1 </button>
  </div>
</template>

<script>
export default {
  name: 'Counter',
  data() {
    return {
      count: 0
    }
  },
  // Counter 组件的自定义事件必须事先声明到 emits 节点中
  emits: ['change'],
  methods: {
    // 当点击 +1 按钮时，调用 add 方法，this.$emit( 'change' ) 触发change事件
    add() {
      this.count++
      this.$emit( 'change' )
    }
  }
}
</script>

<style>

</style>

2.3 监听自定义事件

在使用自定义的组件时，可以通过 v-on 的形式监听自定义事件。

<template>
  <div>
    <h1>App 组件</h1>
    <counter @change="getCount"></counter>
  </div>
</template>

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

export default {
  name: 'App',
  components: {
    Counter
  },
  methods: {
    getCount() {
      console.log('监听到了change事件')
    }
  }
}
</script>

<style>

</style>

3 自定义事件传参

在调用 this.$emit() 方法触发自定义事件时，可以通过第 2 个参数为自定义事件传参。

<template>
  <div>
    <h3>Counter 组件</h3>
    <p>{{ count }}</p>
    <button @click="add"> +1 </button>
  </div>
</template>

<script>
export default {
  name: 'Counter',
  data() {
    return {
      count: 0
    }
  },
  // Counter 组件的自定义事件必须事先声明到 emits 节点中
  emits: ['change'],
  methods: {
    // 当点击 +1 按钮时，调用 add 方法，this.$emit( 'change' ) 触发change事件
    add() {
      this.count++
      // 触发自定义事件，并且传参
      this.$emit( 'change', this.count )
    }
  }
}
</script>

<style>

</style>

在App组件中监听change事件，接收参数。

<template>
  <div>
    <h1>App 组件</h1>
    <p> App-counter: {{ count }} </p>
    <counter @change="getCount"></counter>
  </div>
</template>

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

export default {
  name: 'App',
  data() {
    return {
      count: 0
    }
  },
  components: {
    Counter
  },
  methods: {
    // 监听change事件，并接收参数
    getCount( sonCount ) {
      console.log('监听到了change事件')
      this.count = sonCount
    }
  }
}
</script>

<style>

</style>