vue高阶封装之双向绑定(一) 如何实现跨组件 v-model？

为什么封装组件要使用双向绑定？

双向绑定把数据变更的操作隐藏在组件内部，调用者并不会直接感知，业务层无需关心内部实现逻辑，简化大量与业务无关的代码。

组件双向绑定应有以下2个特点：

父组件只传输 prop，不定义事件接收。
由子组件更新传下来的值。

本篇文章详解如何用 v-model 实现3种双向绑定

v-model 是什么？

v-model 即可以作用在普通表单元素上，又可以作用在组件上。
vuejs隐式添加 value 的 prop，子组件通过 props.value 接收值。
子组件通过 this.$emit('input')，改变父组件 v-model 绑定的值。
v-model 可以实现双向绑定，无需定义接收事件。

为什么v-model可以实现双向绑定？

v-model 其实是一个语法糖，以下是经过 vue 转换后的模板：

<input v-model="message" />
 
// 转换后：
<input
  v-bind:value="message"
  v-on:input="message=$event.target.value"

添加 v-bind:value。
添加 v-on:input 的自定义事件。

动态绑定了 input 的 value 指向了 messgae 变量，并且在触发 input 事件的时候去动态把 message 设置为目标值，这样实际上就完成了数据双向绑定。

双向绑定其实就是普通单向绑定和事件组合来完成的。

基本模型：父组件 - 当前组件（转发参数，高阶组件） - 子组件

父级组件不用过多解释，使用 v-model 传参。

<template>
  <div>
    <!-- $attrs & observer -->
    <BaseInputAttrs v-model="pModel"/> <br>
 
    <!-- watch & data & emit('input') -->
    <BaseInputWatch v-model="pModel"/> <br>
 
    <!-- computed & emit('input') -->
    <BaseInputComputed v-model="pModel"/> 
   </div>
</template>
 
<script>
export default {
  data () {
    return {
      pModel: 'v-model双向绑定',
    }
  },
}
</script>

下面是三种<当前组件>的 v-model 实现方案

方案1：

<template>
  <input type="text" v-bind="$attrs" v-on="$listeners">
</template>

$attr: 向子组件传递，当前组件没有接收的，父组件传递下来的 prop 。

$listeners: 向父组件传递，当前组件没有接收的，子组件抛出的自定义事件。

这样实现后，发现输入后会变成一个 [object InputEvent] 的事件对象。

是因为 v-on="input" 是内置事件，vue 判断当前组件的 tag 是 'input' 类的表单元素，才会关联 value。

当前组件经过封装后，tag 已经改变，父组件实际处理的是 this.$emit('input', el) 的传参，el 就是 [object InputEvent] 表单对象。

解决方案：拦截内置的 input 事件，改变引用，向父组件传递最终值，如下。

<template>
  <input type="text" v-bind="$attrs" @input="observerInput">
</template>
 
<script>
  export default {
    methods: {      
      // 拦截内置事件      
      observerInput (el) {
        this.$emit('input', el.target.value)
      },
    },  
  }
</script>

方案2：watch监听和过渡属性

分别监听父组件和子组件，通过过渡属性 model 存储值

<template>
  <input type="text" v-model="model">
</template>
 
<script>
  export default {
    props: {
      value: {
        type: String,
        default: '',
      },
    },
 
    data () {
      return {
        model: '',
      }
    },
 
    watch: {
      value: {
        immediate: true,
        handler (newVal) {
          this.model = newVal
        },
      },
 
      model (newVal) {
        this.$emit('input', newVal)
      },
    },
  }
</script>

方案3：计算属性 setter getter

尤雨溪的方案 setter 去拦截修改

<template>
    <input type="text" v-model="model">
</template>
 
<script>
  export default {
    props: {
      value: {
        type: String,
        default: '',
      },
    },
 
    computed: {
      model: {
        get () {
          return this.value
        },
        set (newVal) {
          this.$emit('input', newVal)
        },
      },
    },
  }
</script>

总结：三种方案都是通过 this.$emit('input') 修改最终的值，这是封装组件的关键所在：统一数据源。

之后几篇文章会介绍其他的双向绑定方案！

参考文档：https://ustbhuangyi.github.io/vue-analysis/extend/v-model.html

最后编辑于：2019.06.11 18:36:35