除了系统自带的原生 DOM 自带的事件之外，有时候我们需要用到这些自带的事件之外，我们就必须要自定义事件了。
事件名
不同于组件和 prop，事件名不存在任何自动化的大小写转换。而是触发的事件名需要完全匹配监听这个事件所用的名称。举个例子，如果触发一个 camelCase 名字的事件，我们还是接着昨天的项目继续往下写，在TestCom.vue 使用 button 按钮点击事件分发一个 click-event 事件，不同于组件和 prop，事件名不会被用作一个 JavaScript 变量名或 property 名，所以就没有理由使用 camelCase 或 PascalCase 了。并且 v-on 事件监听器在 DOM 模板中会被自动转换为全小写 (因为 HTML 是大小写不敏感的)，所以 @myEvent 将会变成 @myevent——导致 myEvent 不可能被监听到。
<template>
<div class="test-com-wrap">
{{ title }}
<button @click="click">按钮</button>
</div>
</template>
<script>
export default {
name: "TestCom",
props: {
title: {
type: String,
default: "",
},
},
created() {
console.log(this.$attrs)
},
methods: {
click(e) {
this.$emit('click-event', e)
}
}
};
</script>
然后我们在 TemplateM.vue 来接收这个事件：
<template>
<div class="template-m-wrap">
<test-com
title="这个是组件"
data-status="active"
@click-event="clickEvent"
></test-com>
</div>
</template>
<script>
import TestCom from "./TestCom";
export default {
name: "TemplateM",
components: {
TestCom,
},
data() {
return {};
},
methods: {
clickEvent(e) {
console.log("e===>", e.target)
}
},
};
</script>
查看浏览效果：
定义自定义事件
继续上面的代码，可以通过 emits 选项在组件上定义已经发出的事件：
<template>
<div class="test-com-wrap">
{{ title }}
<button @click="click">按钮</button>
</div>
</template>
<script>
export default {
name: "TestCom",
props: {
title: {
type: String,
default: "",
},
},
emits: ['click-event'],
created() {
console.log(this.$attrs)
},
methods: {
click(e) {
this.$emit('click-event', e)
}
}
};
</script>
验证抛出的事件
与 prop 类型验证类似，如果使用对象语法而不是数组语法定义发出的事件，则可以验证它。
要添加验证，将为事件分配一个函数，该函数接收传递给 $emit 调用的参数，并返回一个布尔值以指示事件是否有效，在 main.js 写下如下代码：
import { createApp } from 'vue/dist/vue.esm-bundler.js'
import App from './App.vue'
import router from './router'
import store from './store'
let app = createApp(App)
app.use(store).use(router).mount('#app')
app.component('custom-form', {
template: `<div>
<input v-model="email" type="text" placeholder="输入邮箱"/>
<input v-model="password" type="password" placeholder="输入密码"/>
<button @click="submitForm({email, password})">提交</button>
</div>`,
data() {
return {
email: '',
password: ''
}
},
emits: {
// 没有验证
click: null,
// 验证submit 事件
submit: ({ email, password }) => {
if (email && password) {
return true
} else {
console.warn('Invalid submit event payload!')
return false
}
}
},
methods: {
submitForm() {
this.$emit('submit', { email: this.email, password: this.password })
}
}
})
在 TemplateM.vue 写下代码：
<template>
<div class="template-m-wrap">
<custom-form @submit="submit"></custom-form>
</div>
</template>
<script>
export default {
name: "TemplateM",
components: {
},
data() {
return {};
},
methods: {
submit(options) {
console.log(options)
}
},
};
</script>
我们查看效果如下：
v-model参数
在本例中，子组件将需要一个 foo prop 并发出 update:foo 要同步的事件，还是在 main.js ：
import { createApp } from 'vue/dist/vue.esm-bundler.js'
import App from './App.vue'
import router from './router'
import store from './store'
let app = createApp(App)
app.use(store).use(router).mount('#app')
app.component('my-component', {
props: {
foo: String
},
template: `
<input
type="text"
:value="foo"
@input="$emit('update:foo', $event.target.value)">
`
})
默认情况下，组件上的 v-model 使用 modelValue 作为 prop 和 update:modelValue 作为事件。我们可以通过向 v-model 传递参数来修改这些名称：
<template>
<div class="template-m-wrap">
<my-component v-model:foo="bar"></my-component>
</div>
</template>
<script>
export default {
name: "TemplateM",
components: {
},
data() {
return {
bar: 'dsdsdd'
};
},
methods: {
submit(options) {
console.log(options)
}
},
};
</script>
查看效果如下：
多个v-model绑定
通过利用以特定 prop 和事件为目标的能力，正如我们之前在 v-model 参数中所学的那样，我们现在可以在单个组件实例上创建多个 v-model 绑定。
每个 v-model 将同步到不同的 prop，而不需要在组件中添加额外的选项：
import { createApp } from 'vue/dist/vue.esm-bundler.js'
import App from './App.vue'
import router from './router'
import store from './store'
let app = createApp(App)
app.use(store).use(router).mount('#app')
app.component('user-name', {
props: {
firstName: String,
lastName: String
},
template: `
<input
type="text"
:value="firstName"
@input="$emit('update:firstName', $event.target.value)">
<input
type="text"
:value="lastName"
@input="$emit('update:lastName', $event.target.value)">
`
})
在 TemplateM.vue :
<template>
<div class="template-m-wrap">
<user-name
v-model:first-name="firstName"
v-model:last-name="lastName"
></user-name>
</div>
</template>
<script>
export default {
name: "TemplateM",
components: {
},
data() {
return {
firstName: 'dsdsdd',
lastName: 'Ken'
};
},
methods: {
submit(options) {
console.log(options)
}
},
};
</script>
效果如下：
