深度解析 Shimmer From Structure 核心原理:运行时 DOM 测量如何镜像你的 UI 结构
深度解析 Shimmer From Structure 核心原理:运行时 DOM 测量如何镜像你的 UI 结构
Shimmer From Structure 是一个"结构感知"的骨架屏(Skeleton Loader)生成库:它在运行时测量你真实渲染出的 DOM 结构,自动生成像素级匹配的 shimmer 加载动画,真正做到零布局重复(Zero Layout Duplication),并支持 React、Vue、Svelte、Angular、SolidJS 五大框架。下面我们从骨架屏的痛点出发,深入拆解它的运行时 DOM 测量原理、三阶段 reflow 优化和框架适配器架构。
为什么骨架屏不该手写第二遍?
传统做法里,每个组件都要维护两份:真实内容版 + 骨架占位版。布局一改,两边都要改;字段一加,别忘了骨架。久而久之,加载态和真实 UI 越来越"长得不像"。
而 Shimmer From Structure 的洞察是:骨架结构其实已经存在了——就在你渲染出的 DOM 里。浏览器已经算好了每个元素的位置、尺寸和间距,何不再写一份,直接量它?
核心原理:先渲染、再测量、后覆盖
整体流程可以概括为三步:
- 正常渲染:
loading为true时,你的子组件照常渲染进一个"测量容器"(shimmer-measure-container)。此时文本被color: transparent隐藏、图片被opacity: 0隐藏,但容器背景、边框、布局全部保留——这正是测量所需的信息,规则定义在 shimmerContainerStyles.ts。 - DOM 测量:遍历容器内所有元素,对每个"叶子节点"调用
getBoundingClientRect(),拿到相对容器的x / y / width / height,同时读取borderRadius保持圆角一致。 - 覆盖渲染:按测量结果生成一组
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/ 目录下有五大框架的完整示例工程。

