组合式 API 通过自定义 Hook 实现逻辑复用,如 usewindowSize 管理窗口尺寸、useValidation 处理表单校验,并结合 provide/inject 共享状态,提升代码内聚性与可维护性。
在 vue 3 中,组合式 API(Composition API)让开发者能更灵活地组织和复用逻辑代码。相比选项式 API 中混入(mixin)的局限性,组合式 API 通过自定义 Hook 的方式实现高内聚、低耦合的逻辑封装,真正做到了“按功能组织,而非按组件拆分”。
使用自定义 Hook 封装通用逻辑
自定义 Hook 是一个以 use 开头的函数,内部调用 ref、reactive、watch 等响应式 API,返回需要暴露给组件的状态或方法。这种方式将可复用逻辑独立出来,便于在多个组件中导入使用。
例如,封装一个用于获取窗口尺寸的逻辑:
function usewindowsize() {
const width = ref(window.innerWidth);
const height = ref(window.innerHeight);
const updateSize = () => {
width.value = window.innerWidth;
height.value = window.innerHeight;
};
onMounted(() => window.addEventListener('resize', updateSize));
onUnmounted(() => window.removeEventListener('resize', updateSize));
return { width, height };
}
在组件中直接调用:
立即学习“前端免费学习笔记(深入)”;
export default {
setup() {
const { width, height } = useWindowSize();
return { width, height };
}
};
这样任何需要监听窗口变化的组件都能复用这段逻辑,无需重复编写事件监听和响应式处理。
管理状态与副作用分离
组合式 API 的优势在于可以清晰划分“状态管理”和“副作用控制”。比如处理表单验证时,可以把校验规则、错误信息和校验行为封装在一起。
示例:创建一个输入校验 Hook
function useValidation(initialValue, validators = []) {
const value = ref(initialValue);
const errors = ref([]);
const validate = () => {
errors.value = validators
.map(validator => validator(value.value))
.Filter(msg => msg); // 过滤出错误信息
};
watch(value, validate);
return { value, errors, validate };
}
组件中使用:
const { value, errors } = useValidation('', [
(v) => v ? '' : '此项为必填',
(v) => v.Length > 5 ? '' : '长度需大于5'
]);
这种模式让表单逻辑高度可配置,只需传入不同的校验规则即可复用于注册、登录等场景。
跨组件共享响应式状态
当多个组件需要共享同一份状态时(如用户登录信息、主题模式),可以结合 provide/inject 与组合式 API 构建全局可复用逻辑。
例如,创建一个主题切换的 Hook:
function useTheme() {
const theme = ref('light');
const toggleTheme = () => {
theme.value = theme.value === 'light' ? 'dark' : 'light';
};
return { theme, toggleTheme };
}
在根组件中 provide:
setup() {
const { theme, toggleTheme } = useTheme();
provide('theme', { theme, toggleTheme });
}
后代组件 inject 使用:
setup() {
const { theme, toggleTheme } = inject('theme');
return { theme, toggleTheme };
}
这样既保持了响应性,又避免了 prop 层层透传的问题。
基本上就这些。通过合理设计自定义 Hook,把常用逻辑抽离成函数,再配合 reactive、watch、生命周期钩子,就能轻松实现逻辑复用。关键是关注“功能单元”,而不是“数据类型”,让代码更易维护、测试和扩展。