Vue3 三种方式实现组件数据双向绑定
在 Vue 中，组件数据双向绑定是一项非常重要的特性，它使得我们能够轻松地在组件中处理数据的变化并将其同步到视图
比如我们想要在父组件中修改数据能够同步给子组件，并且子组件修改数据也能同步给父组件，使他们数据一方发生变化，则双方都发生改变。
实现组件数据双向绑定有三种写法分别是 常规写法、v-model、defineModel，下面给大家一一演示
常规写法
在点击父组件按钮时修改数据并同步给子组件
<script setup lang="ts">
import { ref } from 'vue';
import Hello from './components/Hello.vue';const data = ref("Hello World")// 通过调用该事件完成修改数据的操作
const changeData = (value: string) => {data.value = value
}
</script><template><h1>{{ data }}</h1><button @click="data = 'Hello Vue3'">修改子组件的数据</button><!-- 简写：<Hello :data="data" @update="data = $event" /> --><Hello :data="data" @update="changeData" />
</template>
点击子组件中的按钮触发父组件的自定义事件 update 绑定的 changeData 方法，并将参数 你好，世界！ 传递给父组件的方法： changeData 从而实现更改父组件的数据
<script setup lang="ts">
const props = defineProps<{ data: string }>()
const emit = defineEmits<(e: "update", value: string) => void>()
</script><template><h1>{{ data }}</h1><button @click="emit('update', '你好, 世界!')">修改父组件的数据</button>
</template>
可以发现这种写法非常繁琐，子组件修改数据还要通过触发事件来完成
v-model
在 Vue3 中，使用 v-model 指令来实现组件数据的双向绑定非常简单。我们可以在组件中使用 v-model 指令来绑定一个值，并且在组件内部可以直接操作这个值。
接下来这种写法才是 Vue 主流的方式：
<script setup lang="ts">
import { ref } from 'vue';
import Hello from './components/Hello.vue';const data = ref("Hello World")
</script><template><h1>{{ data }}</h1><button @click="data = 'Hello Vue3'">修改子组件的数据</button><!-- 核心代码 --><Hello v-model="data" />
</template>
-
在子组件中我们将数据以
modelValue命名来接收（固定命名） -
给
defineEmits定义一个修改数据的事件：(e: "update:modelValue", value: string) => void -
通过触发
emit('update:modelValue', '你好, 世界!')来实现数据的更新操作
<script setup lang="ts">
const props = defineProps<{ modelValue: string }>()
const emit = defineEmits<(e: "update:modelValue", value: string) => void>()
</script><template><h1>{{ modelValue }}</h1><button @click="emit('update:modelValue', '你好, 世界!')">修改父组件的数据</button>
</template>
接下来想必大家就会有疑惑了，如果是多个数据需要双向绑定该怎么做呢？其实也很简单：
<script setup lang="ts">
import { ref } from 'vue';
import Hello from './components/Hello.vue';const data1 = ref("Hello World")
const data2 = ref("Hello World")
</script><template><h1>{{ data1 }}</h1><h1>{{ data2 }}</h1><button @click="data1 = 'Hello Vue3'">修改子组件的数据</button><button @click="data2 = 'Hello TypeScript'">修改子组件的数据</button><!-- 核心代码 --><Hello v-model:data1="data1" v-model:data2="data2" />
</template>
<script setup lang="ts">
const props = defineProps<{ data1: string, data2: string }>()
const emit = defineEmits<{ (e: "update:data1", value: string): void, (e: "update:data2", value: string): void }>()
</script><template><h1>{{ data1 }}</h1><h1>{{ data2 }}</h1><button @click="emit('update:data1', '你好, 世界!')">修改父组件的数据</button><button @click="emit('update:data2', '你好, 世界!')">修改父组件的数据</button>
</template>
对比一下常规的写法，可以发现不必再通过手动绑定事件就可以达到双向绑定的需求。
而常规写法其实就是这种写法的实现原理
defineModel
学习了上述两种写法后，接下来这种写法你一定会爱不释手，话不多说直接代码演示：
<script setup lang="ts">
import { ref } from 'vue';
import Hello from './components/Hello.vue';const data = ref("Hello World")
</script><template><h1>{{ data }}</h1><button @click="data = 'Hello Vue3'">修改子组件的数据</button><!-- 核心代码 --><Hello v-model="data" />
</template>
<script setup lang="ts">
import { defineModel } from 'vue'
const modelValue = defineModel()
</script><template><h1>{{ modelValue }}</h1><button @click="modelValue = '你好, 世界!'">修改父组件的数据</button>
</template>
当然，如果想要实现多个双向数据绑定可以这么做：
<script setup lang="ts">
import { ref } from 'vue';
import Hello from './components/Hello.vue';const data1 = ref("Hello World")
const data2 = ref("Hello World")
</script><template><h1>{{ data1 }}</h1><h1>{{ data2 }}</h1><button @click="data1 = 'Hello Vue3'">修改子组件的数据</button><button @click="data2 = 'Hello TypeScript'">修改子组件的数据</button><!-- 核心代码 --><Hello v-model:data1="data1" v-model:data2="data2" />
</template>
<script setup lang="ts">
import { defineModel } from 'vue'
const data1 = defineModel("data1")
const data2 = defineModel("data2")
</script><template><h1>{{ data1 }}</h1><h1>{{ data2 }}</h1><button @click="data1 = '你好, 世界!'">修改父组件的数据</button><button @click="data2 = '你好, 世界!'">修改父组件的数据</button>
</template>
使用该语法糖可以直接调用 defineModel 拿到父组件传递的数据，不需要再使用 defineEmits 与 defineProps 就可以操作数据，告别繁琐的组件双向数据绑定。
注意： 该方式仅支持 Vue3.2.0 及以上版本
目前该方式处于Vue官方实验阶段，所以在控制台会出现以下警告：
defineModel() is a compiler-hint helper that is only usable inside <script setup> of a single file component. Its arguments should be compiled away and passing it at runtime has no effect
解决它的办法也很简单，在 vite.config.ts 文件中配置如下代码即可：
export default defineConfig({plugins: [// 核心代码vue({script: {defineModel: true,},}),]
});
