本文详解如何在 Vue 3 组合式 API 中，通过 v-model 将父组件中的响应式状态（如 user.favoriteColor）双向绑定到可复用的 SelectInput 子组件，实现数据同步与事件响应。
本文详解如何在 vue 3 组合式 api 中，通过 `v-model` 将父组件中的响应式状态（如 `user.favoritecolor`）双向绑定到可复用的 `selectinput` 子组件，实现数据同步与事件响应。
在 Vue 3 中，v-model 不再是语法糖的简单替代，而是基于 modelValue prop 和 update:modelValue 事件的标准化双向绑定机制。它使自定义表单组件（如
✅ 正确实现步骤
1. 父组件：使用 v-model 绑定响应式字段
在 Home.vue 中，直接将 user.favoriteColor 作为 v-model 的值传入子组件，无需额外 props 或事件监听：
<!-- Home.vue -->
<script setup>
import { ref } from 'vue';
import SelectInput from './SelectInput.vue';
const user = ref({
name: '',
favoriteColor: '', // 初始值为空字符串，与 select 的 placeholder 匹配
});
const selectOptions = ref(['red', 'green', 'blue', 'white', 'black']);
</script>
<template>
<div class="user-input-container">
<div class="user-input">
<p>Favorite Color</p>
<!-- ✅ 使用 v-model 双向绑定 -->
<SelectInput v-model="user.favoriteColor" :options="selectOptions" />
</div>
</div>
</template>? 注意：我们同时传入了 :options（用于渲染下拉项），而 v-model 专用于控制选中值——职责分离更清晰。
立即学习“前端免费学习笔记（深入）”；
2. 子组件：接收 modelValue 并触发更新事件
SelectInput.vue 需要显式声明 modelValue prop，并通过 defineEmits 声明 update:modelValue 事件。关键点在于：
- 使用 :value 绑定当前值（而非 v-model 在
- 监听 @change 事件，手动调用 emit('update:modelValue', value) 向上同步。
<!-- SelectInput.vue -->
<script setup>
import { defineProps, defineEmits } from 'vue';
// ✅ 接收 v-model 的默认 prop：modelValue
const props = defineProps({
modelValue: {
type: [String, Number], // 支持字符串或数字类型（如 ID）
default: '',
},
options: {
type: Array,
required: true,
},
});
const emit = defineEmits(['update:modelValue']);
const updateModel = (e) => {
emit('update:modelValue', e.target.value);
};
</script>
<template>
<select
:value="modelValue"
@change="updateModel"
class="select-input"
>
<option disabled value="">Please select one</option>
<option
v-for="option in options"
:key="option"
:value="option"
>
{{ option }}
</option>
</select>
</template>
<style scoped>
.select-input {
padding: 0.5rem;
border: 1px solid #ccc;
border-radius: 4px;
font-size: 1rem;
}
</style>⚠️ 重要细节：
- 必须使用 :value + @change 组合，不能在
- modelValue 类型建议设为联合类型（String | Number），增强组件通用性；
- :key 应确保唯一性（此处 option 若为纯字符串且不重复则安全；若存在重复值，建议使用索引或唯一 ID）。
3. 进阶：支持自定义 v-model 修饰符（可选）
如需支持 v-model.trim 或 v-model.number，可在子组件中扩展逻辑。例如处理 .number：
const updateModel = (e) => {
const value = e.target.value;
const newValue = props.modelValue === '' ? value :
e.target.selectedOptions[0]?.dataset.type === 'number'
? Number(value)
: value;
emit('update:modelValue', newValue);
};但常规场景中，保持简洁、语义明确更为推荐。
✅ 总结与最佳实践
- v-model 是 Vue 3 中实现表单组件双向绑定的标准、推荐方式，比手动 :value + @input 更简洁、一致；
- 子组件必须严格遵循 modelValue prop + update:modelValue 事件约定，这是框架识别 v-model 的基础；
- 避免在子组件模板内对 modelValue 进行直接修改（如 modelValue = xxx），它应始终视为只读输入；
- 结合 TypeScript 可进一步强化类型安全（如为 modelValue 和 options 添加泛型约束）；
- 所有状态变更最终由父组件统一管理，子组件仅负责 UI 渲染与事件反馈——这正是 Vue 响应式设计的核心哲学。
通过以上实现，SelectInput 成为了真正可复用、可组合、符合 Vue 生态规范的受控表单组件。
