原创

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

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

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

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

自定义组件实现 v-model#

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

为了方便使用，希望能在选择题目组件上使用 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)
      );
    }
  },
},