前端 | 自定义组件 v-model：Vue 如何实现双向绑定

发表评论
208 次浏览

A+

所属分类：Web前端

摘要

v-model 是 Vue 中一个常用的指令，常用于表单中的数据绑定。如下基本用法想必大家都很熟悉，data 中的 checked 属性的值就会随着多选框的状态实时变化。

v-model 是 Vue 中一个常用的指令，常用于表单中的数据绑定。如下基本用法想必大家都很熟悉，data 中的 checked 属性的值就会随着多选框的状态实时变化。

<el-checkbox v-model="checked" />

但你或许听说过，Vue 组件之间是“单向数据流”，即通过 props 从父组件向子组件单向传递数据。那么，v-model 的“双向绑定”效果是如何实现的呢？

自定义组件实现 v-model

首先来看一个实际应用的例子，需求如下：在创建试卷页面 paperCreate 中，通过选择题目组件 questionSelect 查询并选择题目组成试卷，效果如下图所示。

前端 | 自定义组件 v-model：Vue 如何实现双向绑定

为了方便使用，希望能在选择题目组件上使用 v-model 指令进行双向绑定：

<!-- 选择题目组件 --> <question-select v-model="formData.questions" />  <!-- 显示已选择题目 --> <div v-for="item in formData.questions" :key="item.id" >     <question :question="item" /> </div>

value 属性和 input 事件

自定义支持 v-model 的组件只需要满足两个条件：

value 属性作为传入数据
数据改变时，将新数据作为 payload，向上 emit 一个 input 事件

就是这么简单，相关代码为：

export default {   props: {     value: Array,	// 类型根据实际需要   },   methods: {     handelChange() {       this.$emit("input", newValue);     },   }, };

如果不想使用默认的 value 属性和 input 事件，也可以通过 model 对象自定义相应属性和事件：

model: {   prop: 'checked',   event: 'change', },

单向数据流

需要注意的是，prop 传值是单向的，即父组件中的数据改变会反映到子组件中，但在子组件内部不能主动改变 prop 的值。具体来说就是，子组件中不能使用类似于 v-model="value" 之类试图改变 value 值的操作。

因此表格中的 checkbox，也只单向传入 value 来控制是否选中的状态，然后在选中状态改变时手动处理改变后的结果。

对于表格中的一行（即一道题目），如果传入的 value 数组（即已选中的题目列表）中包含它的 id，则显示为选中状态
不能直接改变原数组 value，直接构造新列表传出：
- 如果新增了一个选项，传原列表 + 所选对象
- 如果取消了一个选项，传原列表 - 所选对象

（PS：组件库中提供的 el-checkbox 实际上也是另一个自定义组件，可以同理分析）

<el-table :data="questionList">   <el-table-column>     <template slot-scope="scope">       <el-checkbox         :value="selectedIds.includes(scope.row.id)"         @change="(value) => handelChange(scope.row, value)"       />     </template>   </el-table-column>   <!-- 其他属性 --> </el-table>

props: {   value: Array, }, computed: {   selectedIds() {     return this.value.map((item) => item.id);   }, }, methods: {   handelChange(item, checked) {     if (checked) {       this.$emit("input", [...this.value, item]);     } else {       this.$emit(         "input",         this.value.filter((element) => element.id != item.id)       );     }   }, },

具体写法与组件库的具体实现有关，简单说明一下此处的 element 语法：