一、简介 在 Vue3 中，响应式系统是其核心特性之一。customRef() 是 Vue3 提供的一种高级工具，允许开发者创建自定义的 ref 对象。这些对象可以包含更复杂的依赖跟踪和更新逻辑，满足特定的业务需求。本文将详细介绍 customRef() 的使用场景、基本用法以及一些最佳实践。
二、使用场景 customRef() 适用于以下场景：
复杂的依赖跟踪：需要对依赖关系进行精细控制。 自定义更新逻辑：需要在更新值时执行特定逻辑，如防抖、节流等。 异步操作：需要在异步操作完成后更新值。 三、基本使用 3.1 customRef() 的基本概念 customRef() 接收一个工厂函数，该函数返回一个包含 get 和 set 方法的对象。这些方法用于读取和修改引用值，并且可以在内部显式地控制依赖关系的跟踪和响应式更新。
3.2 代码示例 以下是一个实现防抖功能的 ref 示例：
<script lang="ts" setup>
import { customRef } from 'vue';
function debouncedRef(initialValue, delay) {
let timeoutId;
return customRef((track, trigger) => ({
get() {
// 使用 track 函数标记依赖
track();
return initialValue;
},
set(newValue) {
clearTimeout(timeoutId);
timeoutId = setTimeout(() => {
initialValue = newValue;
// 使用 trigger 函数触发依赖更新
trigger();
}, delay);
}
}));
}
// 使用自定义的ref
const myDebouncedRef = debouncedRef('Hello World', 500);
</script>在上述例子中，debouncedRef 是一个自定义的 ref 工厂函数，它接收两个参数：初始值和延迟时间。当 set 方法被调用时，会清除之前的计时器并设置一个新的计时器，在延迟时间结束后更新值并触发依赖更新。
四、功能详解 4.1 防抖功能详解 防抖（Debounce）是一种在指定时间内忽略多次触发，只在最后一次触发后的一段时间内执行的技术。上面的 debouncedRef 实现了这一功能，当我们频繁更新 ref 的值时，只有在最后一次更新后的延迟时间结束后，值才会被真正更新。
4.2 关键函数 track 和 trigger track：用于标记依赖，告诉 Vue 这个 ref 的值被读取了。 trigger：用于触发依赖更新，告诉 Vue 这个 ref 的值被修改了。 五、最佳实践及案例 5.1 异步更新 以下是一个异步更新 ref 的示例：
<script lang="ts" setup>
import { customRef } from 'vue';
function asyncRef(initialValue, asyncFunction) {
return customRef((track, trigger) => ({
get() {
track();
return initialValue;
},
async set(newValue) {
initialValue = await asyncFunction(newValue);
trigger();
}
}));
}
// 使用自定义的ref
const myAsyncRef = asyncRef('Initial Value', async (value) => {
// 模拟异步操作
await new Promise(resolve => setTimeout(resolve, 1000));
return value.toUpperCase();
});
</script>在这个示例中，asyncRef 接收一个初始值和一个异步函数。当 set 方法被调用时，会执行异步函数并在完成后更新值。
5.2 条件性更新
<script lang="ts" setup>
import { customRef } from 'vue';
function conditionalRef(initialValue, conditionFunction) {
return customRef((track, trigger) => ({
get() {
track();
return initialValue;
},
set(newValue) {
if (conditionFunction(newValue)) {
initialValue = newValue;
trigger();
}
}
}));
}
// 使用自定义的ref
const myConditionalRef = conditionalRef(0, value => value >= 0);
</script>在这个示例中，conditionalRef 只有在满足特定条件时才会更新值。
六、总结 customRef() 是 Vue3 中一个非常强大的工具，允许开发者根据自己的需求创建自定义的 ref 对象。通过合理使用 customRef()，我们可以实现防抖、节流、异步更新等复杂的响应式逻辑，从而提高代码的灵活性和可维护性。