深度解析 Shimmer From Structure 核心原理:运行时 DOM 测量如何镜像你的 UI 结构

原创2026-10-14 11:00:291,815 阅读

深度解析 Shimmer From Structure 核心原理:运行时 DOM 测量如何镜像你的 UI 结构

Shimmer From Structure 是一个"结构感知"的骨架屏(Skeleton Loader)生成库:它在运行时测量你真实渲染出的 DOM 结构,自动生成像素级匹配的 shimmer 加载动画,真正做到零布局重复(Zero Layout Duplication),并支持 React、Vue、Svelte、Angular、SolidJS 五大框架。下面我们从骨架屏的痛点出发,深入拆解它的运行时 DOM 测量原理、三阶段 reflow 优化和框架适配器架构。

为什么骨架屏不该手写第二遍?

Shimmer From Structure 骨架屏加载效果演示

传统做法里,每个组件都要维护两份:真实内容版 + 骨架占位版。布局一改,两边都要改;字段一加,别忘了骨架。久而久之,加载态和真实 UI 越来越"长得不像"。

而 Shimmer From Structure 的洞察是:骨架结构其实已经存在了——就在你渲染出的 DOM 里。浏览器已经算好了每个元素的位置、尺寸和间距,何不再写一份,直接量它?

Shimmer From Structure 文档站骨架屏演示界面

核心原理:先渲染、再测量、后覆盖

整体流程可以概括为三步:

  1. 正常渲染:loading 为 true 时,你的子组件照常渲染进一个"测量容器"(shimmer-measure-container)。此时文本被 color: transparent 隐藏、图片被 opacity: 0 隐藏,但容器背景、边框、布局全部保留——这正是测量所需的信息,规则定义在 shimmerContainerStyles.ts。
  2. DOM 测量:遍历容器内所有元素,对每个"叶子节点"调用 getBoundingClientRect(),拿到相对容器的 x / y / width / height,同时读取 borderRadius 保持圆角一致。
  3. 覆盖渲染:按测量结果生成一组 position: absolute 的 shimmer 块,每块内部是一条 translateX 扫光动画。loading 变为 false 后覆盖层移除,内容原位显现,过渡完全无缝——因为布局从未变过。

React 适配器中这一步发生在 useLayoutEffect(浏览器绘制前同步执行),避免"闪烁";核心测量函数是 extractElementInfo.ts 中的 extractElementInfo()。

测量结果被收敛成一个极简的数据结构 ElementInfo(x、y、width、height、tag、borderRadius),定义见 types.ts。

什么是"叶子节点"?

不是所有元素都该生成 shimmer 块。isLeafElement() 的判定规则很直白(isLeafElement.ts):

  • img、svg、video、canvas、iframe、input、textarea、button 永远算叶子(它们总是内容本体);
  • 没有其他"实体"子元素(忽略 <br>、<hr> 等无尺寸元素)的容器,视为叶子;
  • 其余容器递归向下,直到叶子为止。

这样标题、正文段落、头像各得到一个精确的占位块,而包裹它们的 div 不会被重复计量。

性能关键:三阶段策略只触发一次 reflow

测量 DOM 有性能陷阱:读写交替会引发"布局抖动"(layout thrashing),每读一次尺寸就可能强制一次 reflow。Shimmer From Structure 把整个测量过程切成三个阶段:

阶段 操作 读写类型
Phase 1 遍历 DOM、收集叶子节点、给纯文本表格单元格套临时 <span> 纯写
Phase 2 一次性 getBoundingClientRect() 测量所有元素,过滤零尺寸项 纯读(仅触发一次 reflow)
Phase 3 拆除临时 <span>,还原文本节点 纯写

实现就在 extractElementInfo.ts:collectLeafElements() 只写不读,measureElements() 只读不写,cleanupWrappedCells() 在测量完成后收尾。对典型组件树(几十到几百个节点),整个测量只需 2–5ms,稳稳落在 60fps 的 16.67ms 帧预算内。

边界情况:表格单元格为什么需要临时 span?

直接量 <td> 会连同 padding 一起算进去,shimmer 块会"越界"覆盖到留白区域。而文本节点本身没有 getBoundingClientRect()。解法就是上面的三阶段批处理:先把所有纯文本单元格的文字挪进临时 <span>,统一测量后再还原——几十个单元格也只多触发一次 reflow。

响应式更新:ResizeObserver + rAF 节流

窗口缩放、断点切换时,布局会变,骨架也得跟着变。库在 createResizeObserver.ts 中用 ResizeObserver 监听容器尺寸变化,再用 requestAnimationFrame 节流:

  • 回调触发时浏览器已完成布局计算,读取尺寸不会再引发额外 reflow;
  • 快速拖拽窗口时,每帧最多重测一次,避免冗余计算。

控制测量范围的隐藏参数

两个 data 属性让你精调测量行为:

  • data-shimmer-ignore:跳过该元素及其所有后代,不生成 shimmer 块;
  • data-shimmer-no-children:把整个子树当成单个 shimmer 块处理,适合超大复杂子树(比如上千节点的列表),大幅降低测量开销。

相关行为在 extractElementInfo.test.ts 中有完整测试覆盖。

架构设计:一个 core,五个薄适配器

所有测量逻辑集中在框架无关的 packages/core/ 包中,五个框架适配器只做生命周期对接:

        @shimmer-from-structure/core
   extractElementInfo / isLeafElement /
   createResizeObserver / SHIMMER_CONTAINER_STYLES
              │
   ┌──────┬───┴────┬────────┬────────┐
 React    Vue    Svelte  Angular   Solid
  • React:useLayoutEffect(绘制前同步测量,见 Shimmer.tsx);
  • Vue:watch + nextTick;Svelte:$effect + onMount;Angular:ngAfterViewInit;Solid:createEffect。

测量逻辑只写一遍,任何 bug 修复或性能优化(如表格单元格批处理)所有框架立即共享。默认配色与时长等配置收敛在 constants.ts 的 shimmerDefaults 中。

动态数据怎么办?

加载时真实数据还没到,组件拿不到 props 会渲染空壳——没东西可量。templateProps 正是为此设计:测量阶段把一份 mock 数据克隆注入子组件,让浏览器按"真实形态"布局,量完即弃。用户永远看不到 mock 数据,只看到位置准确的骨架。

小结

Shimmer From Structure 的核心原理一句话概括:让真实组件自己渲染出结构,再用运行时 DOM 测量把它"照"成骨架屏。配合三阶段 reflow 优化、ResizeObserver 响应式和 core + 适配器的架构,它把"骨架屏维护"这个长期痛点变成了"包一层 <Shimmer> 就完事"。

📚 延伸阅读:官方文档 how-this-works 章节、README.md、examples/ 目录下有五大框架的完整示例工程。

登录后查看全文
shimmer-from-structure