React 19.3 ViewTransition 上生产:列表详情联动的四个验收点

文章封面

React 19.3 稳定了 ViewTransition。一个适合试点的场景是从列表卡片进入详情,沿用同一商品或项目的视觉线索。工程上的关键在于:浏览器拍摄视图前后的内容,React 决定哪些更新属于过渡,路由层还负责加载与恢复焦点。合在一起测试才能发现实际问题。

先挑范围足够小的组件

将同一个业务对象在列表与详情中的媒体区域用稳定且在当前视图中唯一的名称关联。不要把整张列表都包进去,否则浏览器捕获和绘制的范围会变大。过渡期间若同名元素在同一视图存在多个,先列举弹窗、预览卡和悬浮列表是否复用了同一名称。路由框架如果有自己的 transition 调度,按框架入口接入,保证数据回填和可动画区块的更新时机可控。

过渡效果要配合减少动态效果偏好,并保留失败时的可操作性。

import { startTransition, ViewTransition } from 'react';

function Cover({ item, onOpen }) {
  return (
    <ViewTransition name={'cover-' + item.id}>
      <button onClick={() => startTransition(() => onOpen(item.id))}>
        <img src={item.cover} alt={item.title} width={160} height={100} />
      </button>
    </ViewTransition>
  );
}

这是局部状态驱动的简化示例。真实详情页中的对应边界要使用同名配置,并在数据延迟时保留稳定占位。键盘用户点击后的预期是定位新内容,并能返回到原位置;过渡过程中若视觉继续滚动而焦点停留旧节点,会让读屏用户迷失上下文。用键盘、读屏、减少动态效果偏好和无动画环境分别操作一次。

性能检查要覆盖首帧和取消

在弱设备或 CPU 限速下录制点击后的帧。观察点击到反馈、捕获区块、重新布局的耗时,以及快速连续点两项时路由状态是否始终指向最后一次操作。慢网络下的骨架屏和失败重试都要参与验收。对用户偏好减少动态效果的场景,禁用或缩减动画并保留同样的内容顺序、滚动恢复和焦点行为。由体验问题回溯到捕获范围和数据边界,比统一调短动画更容易找出原因。

最容易漏掉的返回路径

从列表第八项进入详情,打开一个弹窗,然后返回列表。检查原列表滚动位置、焦点和对应卡片是否仍然存在。虚拟列表若只渲染当前可见区域,返回动画可能找不到旧元素,这时优先恢复滚动与焦点,再按可见元素决定是否运行共享过渡。一个较完整的自动化断言应检查活动元素与 URL,真实浏览器录制再用于观察动画和绘制顺序。

参考资料

React 19.3 发布说明 · React ViewTransition 文档

评论

暂无评论