Vue3值得注意的新特性之——触发组件选项

事件名

与组件和prop一样，值组件事件名提供了自动的得注大小写转换。如果用驼峰命名的新特性之选项子组件中触发一个事件，你将可以在父组件中添加一个kebabcase(短横线分割命名)的值组件监听器。

<my-component @my-event="doSomething"></my-component>  this.$emit(myEvent) 

与props命名一样，得注当你使用DOM模板时，新特性之选项我们建议使用kebabcase事件监听器。值组件如果你使用的得注是字符串模板，这个限制就不适用。新特性之选项

定义自定义事件

可以通过emits选项在组件上定义已发出的值组件事件。 

app.component(custom-form,得注 {   emits: [inFocus, submit] }) 

当在emits选项中定义了原生事件(如click)时，将使用组件中的新特性之选项事件替代原生事件侦听器。

验证抛出的值组件事件

与props类型验证类似，如果使用对象语法而不是得注数组语法，则可以验证它。新特性之选项

要添加验证，将为事件分配一个函数，免费源码下载该函数接收传递给$emit调用的参数，并返回一个布尔值以指示事件是否有效。 

app.component(custom-form, {   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, password })     }   } }) 

v-model事件

默认情况下，组件上的v-model使用modelValue作为props和update:modelValue做完事件。我们可以通过向v-model传递参数来修改这些名称：

<my-component v-model:title="bookTitle"></my-component> 

在本例中，子组件将需要一个 title prop 并发出 update:title 要同步的事件： 

app.component(my-component, {   props: {     title: String   },   emits: [update:title],   template: `     <input       type="text"       :value="title"       @input="$emit(update:title, $event.target.value)">   ` }) 

多个v-model绑定

通过利用特定prop和事件为目标的能力，正如我们之前在v-model参数中所学的那样，我们现在可以在单个组件实例上创建多个v-model绑定。

每个v-model将同步到不同的prop，而不需要在组件中添加额外的选项。 

<user-name   v-model:first-name="firstName"   v-model:last-name="lastName" ></user-name> app.component(user-name, {   props: {     firstName: String,     lastName: String   },   emits: [update:firstName, update:lastName],   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)">   ` }) 

处理v-model修饰词

在2.X中，我们对组件v-model上的.trim等修饰符提供了硬编码支持。但是，如果组件可以支持自定义修饰符，则会更有用。服务器租用

在3.X中，添加到组件v-model的修饰符将通过modelModifiers prop提供给组件。

v-model有内置的修饰符——.trim，.number和.lazy。但是，在某些情况下，你可能还需要添加自己的自定义修饰符。

我们做个实例：将提供的字符串第一个字母大写。 

<my-component v-model.capitalize="myText"></my-component> app.component(my-component, {   props: {     modelValue: String,     modelModifiers: {       default: () => ({})     }   },   emits: [update:modelValue],   template: `     <input type="text"       :value="modelValue"       @input="$emit(update:modelValue, $event.target.value)">   `,   created() {     console.log(this.modelModifiers) // { capitalize: true }   } }) 

现在我们已经设置了 prop，我们可以检查 modelModifiers 对象键并编写一个处理器来更改发出的值。在下面的代码中，每当<input/> 元素触发 input 事件时，我们都将字符串大写。

<div id="app">   <my-component v-model.capitalize="myText"></my-component>   {{ myText }} </div> const app = Vue.createApp({   data() {     return {       myText:      }   } }) app.component(my-component, {   props: {     modelValue: String,     modelModifiers: {       default: () => ({})     }   },   emits: [update:modelValue],   methods: {     emitValue(e) {       let value = e.target.value       if (this.modelModifiers.capitalize) {         value = value.charAt(0).toUpperCase() + value.slice(1)       }       this.$emit(update:modelValue, value)     }   },   template: `<input     type="text"     :value="modelValue"     @input="emitValue">` }) app.mount(#app) 

对于带参数的 v-model 绑定，生成的 prop 名称将为 arg + "Modifiers"： 

<my-component v-model:description.capitalize="myText"></my-component> app.component(my-component, {   props: [description, descriptionModifiers],   emits: [update:description],   template: `     <input type="text"       :value="description"       @input="$emit(update:description, $event.target.value)">   `,   created() {     console.log(this.descriptionModifiers) // { capitalize: true }   } })