layout worklet 仅 chromium 支持，需同源模块、顶层 registerlayout、纯函数式布局建模，禁用 dom 操作与随机数，返回正确 blocksize 防塌陷。
Layout Worklet 目前仅在 Chromium 系统（Chrome、Edge、Opera）中可用，Firefox 和 Safari 完全不支持，且无法通过 polyfill 补齐 —— 这意味着它不能用于需要多浏览器兼容的生产页面，只适合实验性项目或内部工具。
如何注册 Layout Worklet 模块
必须在主线程调用 CSS.layoutWorklet.addModule()，且只能在支持该 API 的环境下执行。模块路径需是同源 URL（不能是 data: 或 blob:），也不能跨域加载。
- 必须放在
<script></script>标签中，或模块脚本内，不能在 Worker 或 iframe 中注册 - 注册后返回 Promise，应
await或.then()处理失败（比如 404 或 CORS 错误） - 模块只能注册一次；重复调用同一 URL 不会报错，但也不会重新加载
示例：
if ('layoutWorklet' in CSS) {
CSS.layoutWorklet.addModule('masonry.js')
.catch(err => console.error('Layout Worklet 加载失败:', err));
}
registerLayout() 里最容易漏掉的约束条件
registerLayout() 必须在 Layout Worklet 模块脚本中调用，且只能在顶层作用域（不能包裹在函数或条件语句里）。浏览器解析到该语句时会立即注册，因此类定义必须在它之前。
- 类名必须有
static get inputProperties()，否则布局不会响应 CSS 自定义属性变化 -
inputProperties只接受 CSS 自定义属性（如--columns），不支持原生属性（如width或display） - 类必须实现
layout()方法，否则运行时报TypeError: layout method is not implemented - 不能在
layout()中直接操作 DOM 或读取offsetHeight等同步布局信息 —— 这些值在 worklet 线程不可用
layout() 函数里哪些值是安全可读的
Layout Worklet 运行在独立线程，能访问的只有传入参数和有限的计算能力。关键限制在于：没有 DOM、没有 window、没有 document、没有样式计算结果（如 getComputedStyle）。
-
constraints.fixedInlineSize是唯一可靠的容器宽度（单位为 px），来自 CSSwidth或inline-size -
styleMap.get('--prop')可读自定义属性，但值是CSSUnitValue或CSSKeywordValue，需用.value或.toString()提取 -
children是LayoutChild对象数组，可调用layoutNextFragment()获取子元素尺寸，但不能改写其style或触发重排 - 不能使用
Math.random()做列分配 —— 它会导致每次 layout 调用结果不一致，破坏浏览器缓存和渲染稳定性
错误示例（会导致 layout 不稳定）：
const index = Math.floor(Math.random() * columns); // ❌ 不可预测，禁止
为什么瀑布流 layout 总是错位或高度塌陷
常见原因是没正确处理 fragment.blockSize 和 fragment.blockOffset，或者忽略了 edges（容器边距）与 gap 的叠加关系。
- 子元素的
blockOffset是从容器顶部开始算的绝对偏移，不是相对于上一个元素 - 如果所有子元素
blockOffset = 0，它们会全部堆在顶部 —— 必须按列高动态累加 -
fragment.inlineOffset需手动加上 padding 和 gap，否则列间间距会丢失 - 忘记在
layout()结尾返回{ inlineSize, blockSize }，会导致容器高度为 0（塌陷）
必须返回：
return {
inlineSize: constraints.fixedInlineSize,
blockSize: Math.max(...columnHeights) + padding // 至少要撑开容器
};
Layout Worklet 的真正门槛不在写逻辑，而在于彻底放弃“读 DOM → 算位置 → 写 style”这一惯性链条；它要求你把布局完全建模为纯函数：输入约束 + 属性 → 输出碎片坐标。任何隐式依赖（比如假设子元素已有固定高度）都会在真实场景中突然崩坏。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
