Vue 3.4 重磅升级：defineModel 宏如何彻底改变前端状态管理！
@大迁世界 2024-07-11 09:03:01 阅读 82
理解状态的位置和组件边界仍然是现代前端开发中主要挑战之一，也是团队在应用规模增加时做出的最重要的决定之一，可能会加速开发，也可能成为最大的摩擦源。
如果做得好，构建、组合、重构和测试前端组件会变得轻而易举；如果做得不好，则会成为难以追踪的幽灵错误的无尽源泉，使代码库变得脆弱。
Vue 3.4 版本中从实验状态发布的 <code>defineModel 宏，可能是关于组件间复杂状态交互的实现方式最具变革性的特性之一。
描述看似很无害：
defineModel 是一个新的
<script setup>宏，旨在简化支持 v-model 的组件的实现
表面上看，这个宏的实用性似乎微不足道，但它对团队如何处理状态和管理组件边界有深远影响。我们看看 defineModel 是做什么的，为什么它的添加在 Vue 3.4 中感觉像是一种范式转变——尽管它只是一个简单的宏。
状态的概念模型
通常，现代前端应用程序有三种状态范围（不包括全局窗口级别的状态）。
全局共享状态。这是整个层次结构中不同组件可访问的状态，例如登录用户的账户信息和路由间共享的信息。
分层组件状态。这是在层次结构的子树中不同组件可访问的状态，例如列表-详情编辑视图。
单个组件级别的状态。这是仅在层次结构中的单个组件中可访问的状态，状态交互不需要在树中上下传递。
在全局级别，有许多库和解决方案可以解决这个问题。例如，React 的 Zustand、Jotai、Recoil、Redux 等，Vue 的 Pinia 可以将状态从组件树中提取出来放入全局范围，以跨越树。它旨在保存真正的全局状态，如浅色/深色模式或租户 ID。
第二层状态是团队遇到“属性传递”摩擦的地方——无论是在 React、Vue 还是其他库或框架中。部分原因是管理状态在组件之间的上下移动是繁重的。
在这种情况下，团队的自然决定是将状态移动到全局存储中，或者进入第三个组件状态范围，仅仅是为了避免这种摩擦，而不断堆积到一个巨大的组件中——这会产生另一种痛苦。
如果能在保持 Vue 的双向绑定的同时，轻松地将状态分离开来，而不需要属性传递的摩擦，那该多好。这正是 <code>defineModel 的作用所在，它大大减少了在树中移动状态的摩擦，同时保持 Vue 的双向绑定。
defineModel 是什么？
重要的是首先了解它是什么以及它的功能。对于那些不熟悉 Vue 的人来说，组件间上下移动状态的惯用模式一直是使用 props 和 emits。
在 defineModel 之前 - props 和 emits
例如，考虑这个父子组件：
外部组件定义了 <code>ref 并将其作为 prop 传递给子组件。更新通过子组件向父组件的 emit 事件来完成。
为了获得双向绑定，我们需要内部的 NameInput.vue 组件如下：
<!-- NameInput.vue -->
<template>
<LabeledContainer label="NameInput.vue">code>
<input v-model="name"/>code>
</LabeledContainer>
</template>
<script setup lang="ts">code>
const props = defineProps<{
modelValue: string
}>()
const emits = defineEmits<{
'update:modelValue': [string]
}>()
const name = computed({
get() {
return props.modelValue
},
set(val) {
emits('update:modelValue', val)
}
})
</script>
外部的 Example1.vue 组件如下：
<!-- Example1.vue -->
<template>
<LabeledContainer label="Example1.vue">code>
<h1>Example 1</h1>
<p>Hello, { { name.length === 0 ? "(enter your name below)" : name }}</p>
<NameInput v-model="name"/>code>
</LabeledContainer>
</template>
<script setup lang="ts">code>
const name = ref('')
</script>
现在，当我们在文本框中输入值时，它会自动更新 prop 的值：
我们的非常简单的组件具有父子组件之间的双向绑定。
可以很容易地看到，对于如此简单的事情，这种样板代码会变得多么繁琐！
在 defineModel 之后 ✨
随着 Vue 3.4 中 <code>defineModel 的发布，我们看看它如何简化 NameInput.vue：
<!-- NameInput.vue -->
<template>
<LabeledContainer label="NameInput.vue">code>
<input v-model="name"/>code>
</LabeledContainer>
</template>
<script setup lang="ts">code>
const name = defineModel<string>({ required: true })
</script>
父组件保持不变，但大量的样板代码被删除了！这个小小的宏完全改变了管理状态的体验。
一个实际的例子
表面上看，这似乎是一个微不足道的变化。当然，获得了一些便利，但这对开发人员管理状态有多大影响？仅仅是一个简单的宏，声称会有这么大的影响岂不是荒谬？
事实上，开发人员往往会选择阻力最小的路径，如果阻力最小的路径是坏习惯，那么，开发人员将创建一个充满许多坏习惯的代码库——即“技术债务”。如果你见过 1000 多行的 React 或 Vue 组件（我们中谁没见过？），那么很可能的原因是将状态以可管理的方式分散出来的摩擦太大；随着组件的有机增长，将状态保持在一个巨大的组件中比分解出新组件更容易。
defineModel 的实现是，它创建了一条最小阻力路径，同时有助于改善团队对状态的思考方式。突然之间，管理分层组件状态变得微不足道，并消除了将状态移入全局范围或在大型组件中进行松散操作的诱惑（通常是 1000 多行组件的来源）。
使用 defineModel 简化分层状态
考虑以下简单的联系人管理应用程序：
注意这个示例中的层次结构。当用户从 <code>Listing.vue 中选择联系人时，应用程序应在 Details.vue 中显示详细信息。当用户编辑详细信息并在 Details.vue 中保存更改时，应用程序应更新 Listing.vue 中的条目。
如果我们想在 Listing.vue 和 Details.vue 之间共享状态，它必须是全局状态或从公共父级 Example3.vue 开始的分层状态——否则，很容易看到将所有内容放入一个巨大的组件中的诱惑！
在这种情况下，这就是我们的分层状态的样子：
状态通过 <code>prop 从列表组件传递到联系人组件。
我们从外到内检查代码。
这是我们的父 Example3.vue 组件：
<template>
<LabeledContainer label="Example3.vue">code>
<h1>Example 3</h1>
<p v-if="!!selectedContact">code>
Selected: { { selectedContact.name }} ({ { selectedContact.handle }})
</p>
<div class="parent">code>
<Listing
v-model="contacts"code>
v-model:selected="selectedContact"/>code>
<Details v-model="selectedContact"/>code>
</div>
</LabeledContainer>
</template>
<script setup lang="ts">code>
const selectedContact = ref<Contact>()
const contacts = ref<Contact[]>([{
name: 'Charles',
handle: '@chrlschn'
}])
</script>
这是我们的状态所在根，并通过绑定将其传递给 Listing 和 Details 组件：
<!-- Snippet from Example3.vue-->
<Listing
v-model="contacts"code>
v-model:selected="selectedContact"/>code>
<Details v-model="selectedContact"/>code>
我们先看看 Details.vue ：
<!-- Details.vue, the right side form inputs -->
<template>
<LabeledContainer label="Details.vue">code>
<div v-if="!!selected">code>
<label>
Name
<input v-model="name"/>code>
</label>
<label>
Handle
<input v-model="handle"/>code>
</label>
<div>
<button @click="handleCancel">Done</button>code>
<button @click="handleDone">Save</button>code>
</div>
</div>
<p v-else>
Select a contact
</p>
</LabeledContainer>
</template>
<script setup lang="ts">code>
const selected = defineModel<Contact|undefined>({
required: true
})
const name = ref('')
const handle = ref('')
watch (selected, (contact) => {
if (!contact) {
return
}
name.value = contact.name,
handle.value = contact.handle
})
function handleCancel() {
selected.value = undefined
}
function handleDone() {
if (!selected.value) {
return
}
selected.value.name = name.value;
selected.value.handle = handle.value;
}
</script>
这个组件的目的是拥有一组状态副本，当选中的联系人更改时，组件将值复制到本地状态，以便在不影响原始状态的情况下（直到用户保存），更改名称和 handle。这也允许用户取消任何编辑。
对于更大的属性集，可以考虑创建对象的完整响应式副本并直接绑定到它。
在左侧，Listing.vue 组件包含联系人列表，并有添加新联系人的选项。
<!-- Listing.vue -->
<template>
<LabeledContainer label="Listing.vue">code>
<div class="container">code>
<ContactItem
v-for="contact in contacts"code>
:contact="contact"code>
:selected="selected == contact"code>
@click="selected = contact">code>
</ContactItem>
</div>
<div>
<button @click="handleAddContact"> Add contact </button>code>
</div>
</LabeledContainer>
</template>
<script setup lang="ts">code>
const contacts = defineModel<Contact[]>({
required: true
})
const selected = defineModel<Contact|undefined>('selected', {
required: true
})
function handleAddContact() {
contacts.value.push({
name: 'Name',
handle: 'Handle'
})
}
</script>
然后在 ContactItem.vue 中，Listing.vue 通过普通的 props 传递显示值，因为这里不需要变更（也不需要双向绑定）：
<template>
<LabeledContainer
label="Contact.vue"code>
class="contact"code>
:class="{
'selected': !!selected
}">code>
<p class="name">{ { contact.name }}</p>code>
<p class="handle">{ { contact.handle }}</p>code>
</LabeledContainer>
</template>
<script setup lang="ts">code>
defineProps<{
contact: Contact,
selected?: boolean
}>()
</script>
我们看看这整个事情是如何结合在一起的：
我们的组件在示例组件树的层次结构中共享状态。
如果没有 <code>defineModel 来帮助简化这种交互，很容易看到本能是采取捷径或将状态移入全局状态，因为编写各种 emits 和 computed 会产生相当大的摩擦，即使在这个小示例中也是如此！
正如 Billy Mays 可能会说：“但等一下！还有更多！”让我们看看如何通过使用可组合组件进一步简化代码。
使用 defineModel 和可组合组件
利用可组合组件可以将其提升到一个新的水平，并通过将状态从组件中提取出来进一步简化我们的代码。当组件变得更大时，这特别有用。
在 Vue 中，这很容易实现，并使重构和重新组织复杂性变得轻而易举。
我们只需将我们的状态和函数向上提取到另一个函数中：
// useContacts composable
export function useContacts() {
const selectedContact = ref<Contact>()
const contacts = ref<Contact[]>([{
name: 'Charles',
handle: '@chrlschn'
}])
function addContact() {
contacts.value.push({
name: 'Name',
handle: 'Handle'
})
}
return {
selectedContact,
contacts,
addContact
}
}
很容易看出，如果我们想从 Details.vue 中移动更多的逻辑和状态，将 name 和 handle refs 以及 handleCancel() 和 handleDone() 函数移动到另一个可组合组件中并共享它们是非常低摩擦的：
// useDetailsEditor.ts
// 👇 注意我们在这里接收响应式 selectedContact
export function useDetailsEditor(
selectedContact: Ref<Contact|undefined>
) {
const name = ref('')
const handle = ref('')
// 👇 我们在 selectedContact 上添加一个监听器
// 以便更新封装的状态。
watch (selectedContact, (contact) => {
if (!contact) {
return
}
name.value = contact.name,
handle.value = contact.handle
})
function cancel() {
selectedContact.value = undefined
}
function done() {
if (!selectedContact.value) {
return
}
selectedContact.value.name = name.value;
selectedContact.value.handle = handle.value;
}
return {
name,
handle,
cancel,
done
}
}
然后我们更新 Details.vue：
<template>
<LabeledContainer label="Details.vue">code>
<div v-if="!!selected">code>
<div>
<label>
Name
<input v-model="name"/>code>
</label>
</div>
<div>
<label>
Handle
<input v-model="handle"/>code>
</label>
</div>
<div>
<button @click="cancel">Done</button>code>
<button @click="done">Save</button>code>
</div>
</div>
<p v-else>
Select a contact
</p>
</LabeledContainer>
</template>
<script setup lang="ts">code>
const selected = defineModel<Contact|undefined>({
required: true
})
const {
name,
handle,
cancel,
done
} = useDetailsEditor(selected)
// 👆 我们将选中的联系人传递给可组合组件以便监听
</script>
使用 Vue 3 可组合组件和 Vue 3.4 的 defineModel 宏，这种方式可以很好地将相关状态和逻辑干净地分离和封装。我希望清楚的是，通过简单地复制状态、函数、监听器和计算值并将它们粘贴到可组合组件中，可以轻松地重构代码。
这种模式可以使即使是大型子组件树也变得易于管理、重构和测试。
结论
Vue 3.4 中引入的 defineModel 实际上是一个深远的变化，它将帮助团队遵循最佳实践并构建更好、更易管理的组件。通过消除构建分层状态时的许多摩擦，它使得团队不太可能立即求助于全局状态或倒退到松散的做法。
通过将 defineModel 与 Vue 可组合组件结合使用，团队可以通过组织和封装相关状态和逻辑来创建更干净的组件，这些组件易于阅读和理解。
当尤雨溪首次提出 Vue 3 的 Composition API 时，社区中有很多反对声音，认为它应该保留 Options API 的简单性和易用性。事后看来，很明显，尤雨溪帮助 Vue 更好地扩展以应对构建大型项目的团队的路径是正确的选择。
随着 3.4 的发布，由于它使状态管理变得更加简洁和直观，这种愿景现在感觉更加完整。在某种程度上，它有助于澄清状态放置位置的复杂决策过程，使简单而明显的选择成为正确的选择。defineModel 就像是一颗投向海洋的小石子，其涟漪可能有一天会成为汹涌的波浪！
最后：
vue2与vue3技巧合集
VueUse源码解读
声明
本文内容仅代表作者观点，或转载于其他网站，本站不以此文作为商业用途
如有涉及侵权，请联系本站进行删除
转载本站原创文章，请注明来源及作者。