文章目录
-
-
- [1. 表单类组件](#1. 表单类组件)
- [2. 状态类组件](#2. 状态类组件)
- [3. 复杂数据编辑组件](#3. 复杂数据编辑组件)
- [4. 自定义交互组件](#4. 自定义交互组件)
- [不适合使用 `v-model` 的场景](#不适合使用
v-model
的场景) - 总结
-
v-model
机制本质上是父子组件双向数据绑定的语法糖,特别适合需要在组件间保持数据同步且交互频繁的场景。以下是最适合使用 v-model
的典型场景:
1. 表单类组件
这是 v-model
最经典的应用场景,几乎所有表单元素都可以通过 v-model
实现数据双向绑定:
- 输入框(文本框、密码框、多行文本框)
- 选择器(下拉选择、单选框、复选框)
- 开关(Switch)、滑块(Slider)等表单控件
示例 :
自定义一个带验证功能的输入框组件,父组件通过 v-model
直接获取输入值,无需手动绑定 :value
和 @input
。
html
<!-- 父组件 -->
<custom-input v-model="username"></custom-input>
<!-- 子组件 (CustomInput) -->
<input
:value="value"
@input="$emit('input', $event.target.value)"
>
2. 状态类组件
当子组件需要修改父组件的状态,且状态变更需要实时反馈给父组件时:
- 弹窗(控制显示/隐藏状态)
- 抽屉组件(展开/收起状态)
- 标签切换(当前激活标签)
示例 :
控制弹窗显示隐藏:
html
<!-- 父组件 -->
<modal v-model="isVisible"></modal>
<!-- 子组件 (Modal) -->
<template>
<div v-if="value">
<button @click="$emit('input', false)">关闭</button>
</div>
</template>
<script>
export default {
props: { value: Boolean }
}
</script>
3. 复杂数据编辑组件
当需要拆分复杂表单为多个子组件,且需保持数据同步时:
- 分步表单(每一步数据实时同步到父组件)
- 动态表单(新增/删除表单项时同步数据)
- 数据表格的行内编辑(修改后实时更新数据源)
示例 :
拆分用户信息表单为多个子组件:
html
<!-- 父组件 -->
<user-form
v-model:name="user.name"
v-model:age="user.age"
></user-form>
<!-- 子组件通过多个 v-model 绑定不同字段 -->
4. 自定义交互组件
需要封装具有双向交互逻辑的组件时:
- 计数器(增减数值时同步父组件)
- 评分组件(选择星级后同步结果)
- 日期选择器(选择日期后同步到父组件)
示例 :
自定义计数器组件:
html
<!-- 父组件 -->
<counter v-model="count"></counter>
<!-- 子组件 (Counter) -->
<button @click="$emit('input', value - 1)">-</button>
<span>{{ value }}</span>
<button @click="$emit('input', value + 1)">+</button>
<script>
export default { props: { value: Number } }
</script>
不适合使用 v-model
的场景
- 跨多层级组件通信 :
v-model
本质是父子通信,跨多层级时建议用 Vuex/Pinia 或 Provide/Inject - 单向数据流优先的场景 :如果只需要父传子,无需子改父,直接用
prop
即可 - 多源数据依赖 :当组件状态依赖多个数据源时,
v-model
可能导致逻辑混乱
总结
v-model
最适合 父子组件间需要频繁双向数据同步 的场景,尤其是表单交互、状态控制类组件。它的优势是简化代码、明确数据流向,让双向绑定逻辑更直观。