我所理解的前端框架最佳实践(4):抽取业务逻辑后,谁持有状态和副作用
- 用表格组件减少通用渲染和交互的维护成本
- 利用派生值减少维护成本和心智负担
- 正确拆分组件
- 抽取业务逻辑后,谁持有状态和副作用(当前)
- 按入口和依赖组织大型模块
- 用 kebab-case 格式统一文件名
- 合理使用全局状态
把一段逻辑抽成 composable 或 Hook 之后,调用方需要知道它会读写哪份状态,每次调用又会启动哪些操作。接入第二个调用方时,先弄清两处是否共享结果,再确认它会不会额外发起请求或注册订阅。
先确定哪一层能改数据
一份状态由知道它何时有效的那一层负责更新和重置。只影响当前组件的状态留在组件内,几个区域共用的状态提到它们共同的父层。状态需要跨页面共享时,再交给生命周期能覆盖这些页面的数据层。消费方读取结果,通过明确的动作请求修改。
两份数据现在相同,也要看它们由什么触发更新。会随不同输入变化的状态要有各自明确的归属。能由已有数据算出的结果集中定义派生规则,需要独立编辑和取消的草稿则有自己的生命周期。见《利用派生值减少维护成本和心智负担》。
把订阅和清理交给同一个入口
点击触发的写操作可以直接在事件处理函数里执行。持续同步外部系统时,让同一个入口负责整个订阅周期,订阅对象变化时先解除旧订阅,使用方离开时再释放当前订阅。
复用同一个入口时,要算清会启动几次副作用。如果每次调用都会注册订阅,两个组件调用就会注册两次。整个页面只需要一次订阅时,把它接到共同的数据来源旁边,由各组件消费结果。解除订阅负责挡住后续通知,已经发出的请求则由数据来源在写入结果前检查是否过期。
让调用处看得出它依赖什么
会随页面、用户或本次操作变化的依赖,由调用方明确传入。固定的共享数据来源可以由模块统一取得。需要返回状态和动作时,用业务名称说明各字段的含义,只暴露调用方要用的部分。
验证时先改变输入,再卸载调用方。观察旧订阅是否解除、晚到的响应会写入哪里,以及同一份数据有多个消费者时,到底注册了几次订阅。
资料页更新订阅在 Vue 和 React 中的写法
Header 展示当前登录账号,资料页展示路由上的用户。打开自己的主页时,两处碰巧展示同一个人。打开别人的主页时,只有资料页跟着路由切换。两份资料各有自己的数据来源,保存本人资料后由业务动作刷新账号资料。路由也在展示本人时,再刷新路由资料。
假设资料页需要接收「某个用户的资料已更新」的浏览器事件。调用方传入 profileId 和 refreshProfile,让调用处能看出要订阅谁、由谁刷新。subscribeToProfileChanges 订阅指定用户并返回取消函数。收到通知后由数据来源发起刷新,并在响应提交时检查是否过期。
Vue 在挂载后监听用户 ID
在 Vue 中,调用方传入会随路由更新的 ref 或 computed。浏览器订阅在挂载后启动,watch 的清理回调和订阅放在一起。
import { onMounted, watch } from 'vue';
import { subscribeToProfileChanges } from './profile-events';
export function useProfileUpdates({ profileId, refreshProfile }) {
onMounted(() => {
watch(
profileId,
(id, _previousId, onCleanup) => {
onCleanup(subscribeToProfileChanges(id, () => refreshProfile(id)));
},
{ immediate: true },
);
});
}
React 由 Effect 管理订阅
调用方传当前渲染的 ID。Effect 把 ID 和刷新动作列作依赖,任一变化都会重订阅,组件卸载时也会解除订阅。需要让刷新函数的身份稳定时,可以在拥有数据的那一层解决,依赖列表仍如实表达订阅用到的值。
import { useEffect } from 'react';
import { subscribeToProfileChanges } from './profile-events';
export function useProfileUpdates({ profileId, refreshProfile }) {
useEffect(() => {
return subscribeToProfileChanges(profileId, () => refreshProfile(profileId));
}, [profileId, refreshProfile]);
}
两段代码都把取消函数交给框架。Vue 监听传入的响应式 ID,React 则让 Effect 跟踪每次渲染传入的 ID 和刷新动作。两种写法各自遵循 Vue composable 的使用限制和 React 自定义 Hook 的调用规则。
切换路由后,分别模拟旧用户的通知和切换前发出的慢请求,确认通知不会触发刷新、慢响应不会覆盖新资料。最后卸载页面,确认当前订阅已经解除。
Nuxt 里的完整案例沿用这两份资料的划分,具体到调用处要传什么、保存后刷哪边,以及怎么挡住旧账号的慢响应。见《用 Composable 分清当前账号与路由用户》。
同步更新 DOM 时,值可以直接从 ref 取
滚动区拿到新的 viewport 后,如果只设置一个属性,可以直接写 viewport.value.tabIndex,并先处理空值。如果还要给同一个节点设置名称、角色或注册事件,我会在 watch 回调开头取一次节点。后面读 element 时,可以确定几次操作都落在同一个节点上。
watch(viewport, () => {
const element = viewport.value;
if (element) {
element.tabIndex = 0;
element.setAttribute('aria-label', '正文');
}
});
两种写法都以 watch 的第一个参数为监听源。@sheng/vue-prefer-watch-source-ref 可以提示改写 watch(viewport, element => …) 这类简单同步回调,即使 element 用了多次。改写前先看第一次读取之前有没有调用或状态写入。需要比较新旧值、在异步请求中保留发起时的 ID,或上一轮 cleanup 可能改变监听源时,就继续用回调参数。