Vue3 SFC 和 TSX 方式自定义组件实现 v-model

1 v-model

1.1 理解 v-model

v-model 是 vue3 中的一个内置指令，很多表单元素都可以使用这个属性，如 input、checkbox 等，咱可以在自定义组件中实现 v-model。v-model 本质上是一个语法糖：

• 绑定父组件传递过来的 modelValue 属性；
• 值改变时向父组件发出事件 update:modelValue。

1.2 案例描述

理解了 v-model 的本质，咱可以分别使用 SFC（.vue 文件）和 TSX（.tsx）方式定义一个组件 person-name ，使该组件可以使用 v-model。

person-name 包括两个输入框，分别是“姓”（familyName）和“名”（firstName）两个字段，v-model 传递的数据格式为：

{
    familyName: '张', firstName: '三' }
1
2

首先定义该类型 person-name-type.ts：

export interface PersonName {
   
  /** 姓 */
  familyName?: string;
  /** 名 */
  firstName?: string;
}
1
2
3
4
5
6
7

1.3 编写样式

编写 person-name.scss 样式文件，后面再两个组件中分别引入：

.person-name {
  .el-form-item {
    width: 200px;
  }
}
1
2
3
4
5

2 编写组件

2.1 实现思路

person-name 组件实现逻辑比较简单：

1. template 中放置两个输入框 el-input，分别对应 姓 和 名 两个字段；
2. 定义两个变量 innerFamilyName 和 innerFirstName 绑定两个输入框的值；
3. 在 props 定义 modeValue 属性，接收父组件传递过来的 PersonName 类型的对象；
4. 使用 watch 深度监听 modelValue，当其属性值有变化时，重新赋值给上面绑定输入框的两个变量；
5. 当两个输入框触发 input 事件时，通过 update:modelValue 事件通知父组件，从而实现 v-model。

2.2 SFC（.vue）中的实现

创建组件文件 person-name-sfc.vue：

<template>
  <div class="person-name">
    <el-form-item label="姓">
      <el-input v-model="innerFamilyName" @input="onInput">el-input>
    
1
2
3
4