把 UI 组件的尺寸和结构,一张图讲清
把 UI 组件的尺寸和结构整理成一张规格图,方便交接和查阅。生成可编辑的 HTML,展示间距、圆角、分层视图和尺寸变量表,还能用配套技能把图纸做成短片。
可用于 Claude Code · Codex · Cursor · Gemini CLI
前置要求
- Node.js >=22.20 (skills CLI)
概览
你会得到什么
- 可编辑的 HTML 规格图,包含 SVG 主视图、分层爆炸图、局部细节和尺寸表。
- 用变量代号关联图上标注、测量数值和计算公式。
- 可选:用配套 dimensional-drawing-motion 技能制作 MP4 短片。
适用场景
- 在设计交接或组件文档中记录间距、圆角和布局规则。
- 卡片、弹窗等组件变更后,同步更新对应图纸。
教程
先看懂一张组件规格图
截图能展示组件的样子,但交接时,你还需要说清间距、圆角和各层之间的关系。dimensional-drawing 会分析你提供的组件源码、页面或截图,把这些信息整理成可在浏览器打开的 HTML 图纸。
先看上方作者的弹窗演示,留意三处:
- 主视图:用线框表示标题、内容和按钮的位置,用代号标注尺寸。
- 分层爆炸图:把遮罩、阴影、容器和内容分开,展示叠放关系。
- 尺寸变量表:把
S1、R1等代号对应到间距、圆角及公式,方便统一修改。
图中的 HUG 表示随内容决定大小,FLEX 表示占用剩余空间,FILL 表示填满父容器宽度。正文用占位区域表示,图纸重点记录布局结构。
和 Anatomy 怎么选
- dimensional-drawing:记录现有 UI 组件的尺寸和结构,适合组件文档与设计交接。
- Anatomy:用可交互的机械图解释技术概念,适合讲工作原理。
安装技能,准备组件来源
-
在终端中执行安装命令。此安装方式需要 Node.js 22.20 或更新版本。
npx skills add enesozturk/dimensional-drawing安装器会让你选择技能和 AI 工具。选择
dimensional-drawing;要做动画,再选择dimensional-drawing-motion。 -
在所选 AI 工具中打开练习目录。后续请求都发送到该工具的对话中,组件文件放在它能读取的位置。
-
准备组件源码或 Storybook 页面,也可以提供网页地址、截图。源码和可渲染页面更方便读取实际样式;只有截图时,补充已知尺寸,缺失值在图中保留为
[TBD]。
手动安装时,复制完整技能目录,保留 examples;动画技能还需要 templates 和 adapters。目录结构见项目仓库。
从一张卡片生成第一份图纸
以下是本站设计的练习:先给组件明确的数值,再观察它们如何出现在图纸里。
-
在练习目录创建
practice-card.html,粘贴下面的代码,并在浏览器中打开。<!doctype html> <html lang="zh-CN"> <meta charset="utf-8"> <title>卡片练习</title> <style> * { box-sizing: border-box; } body { margin: 0; padding: 40px; font: 16px/1.5 system-ui; } .card { width: 360px; padding: 24px; display: grid; gap: 12px; border: 1px solid #ccc; border-radius: 16px; } .card h2, .card p { margin: 0; } .card button { justify-self: start; padding: 8px 16px; border: 1px solid #111; border-radius: 8px; font: inherit; background: #fff; } </style> <article class="card"> <h2>项目进度</h2> <p>查看本周的任务与下一步安排。</p> <button type="button">查看详情</button> </article> </html>你应看到一张宽 360px 的卡片,包含标题、正文和按钮。
-
在 AI 工具的对话中发送:
使用 dimensional-drawing,为 practice-card.html 的 .card 绘制尺寸规格图。 读取源码并在浏览器中测量渲染后的布局。 按技能的卡片示例组织主视图、分层爆炸图、圆角细节和尺寸变量表。 用占位区域表示标题、正文和按钮文字,使用黑白线条。 所有尺寸标注用代号,并在表中给出变量名和实际数值;未知值标 [TBD]。 保留源组件文件,将图纸保存为独立的 card-spec.html。 打开图纸检查标注重叠后再交付。 -
打开生成的
card-spec.html,找到宽度、容器内边距、纵向间距和外圆角。它们应分别对应360、24、12和16。代号可以不同,表里的变量含义应与标注一致。
想比较排版,可查看作者提供的卡片与弹窗 HTML 示例。下载后在浏览器中打开即可。
核对尺寸,再改一个局部
-
对照
practice-card.html检查图纸。找到表中数值对应的标注;如有[TBD],查看缺的是哪项信息,再提供来源或保留待定。 -
在同一段 AI 对话中发送:
将 practice-card.html 中 .card 的 padding 从 24px 改为 32px。 保持总宽 360px、间距 12px、外圆角 16px 不变。 重新测量组件,同步更新 card-spec.html 的主视图、尺寸表和相关公式。 -
刷新两个 HTML 文件。卡片内容离外框更远,图纸的内边距变量应变为
32。由于使用border-box且边框宽 1px,内容宽度会从310px变为294px,总宽仍为360px。
这次修改的关键是同步来源和图纸:只改图上的数字,无法反映组件实际布局。
换成自己的弹窗或组件
这次改用项目中的真实组件,并在下面的请求中填写它的文件路径或页面地址。先选一个组件和一个状态,给 AI 明确的读取入口与观察重点。
在 AI 对话中填写并发送下面的请求:
使用 dimensional-drawing,为以下组件绘制规格图。
组件文件或页面:[填写实际路径、Storybook 地址或网页地址]
组件与状态:[例如:设置弹窗,打开状态]
视口:[填写宽度和高度]
重点:[例如:四边留白、最大高度、遮罩层、按钮对齐]
已知尺寸:[填写设计变量或规范;没有则留空]
输出:[填写 HTML 文件名]
先读取来源并测量,再绘制。未知值用 [TBD]。
弹窗需要看它与视口的关系,以及遮罩、容器和操作区的层级;导航或页面布局则可以按断点分别绘图。选用与组件相关的视图,比把所有细节都塞进一张图更容易查阅。
进阶:把图纸做成短片
配套 dimensional-drawing-motion 会让线条逐步绘出、镜头拉远,再展开层级。上方视频是作者的 11 秒弹窗示例。
在本机导出 MP4
本机路线需要 Node.js 18+、ffmpeg 和 Playwright 的 Chromium。安装器本身仍按前述 Node.js 要求准备。
-
在终端中克隆项目并安装动画适配器依赖:
git clone https://github.com/enesozturk/dimensional-drawing cd dimensional-drawing/skills/dimensional-drawing-motion/adapters/headless npm install安装过程会下载 Playwright 所需的 Chromium。
-
在这个终端目录先输出一张作者示例的关键帧:
node render.mjs --scene ../../templates/scene-dialog.js \ --css ../../templates/base.css --still 6.6 --out frame.png打开
frame.png,检查文字是否可读、分层是否清楚,再导出整片:node render.mjs --scene ../../templates/scene-dialog.js \ --css ../../templates/base.css --out dialog.mp4默认输出为 11 秒、1920×1080、60 fps 的 MP4。
-
要制作自己的卡片动画,在 AI 工具中同时提供图纸和克隆目录,发送:
使用 dimensional-drawing-motion,把 card-spec.html 做成 11 秒短片。 参考克隆项目中的 scene-dialog.js 和 base.css,另建 scene-card.js。 根据卡片的实际尺寸、形状、标注和分层创建新场景,调整镜头位置。 先输出关键帧供我查看,确认后再渲染 MP4。 给出使用 scene-card.js 的实际渲染命令及文件路径。渲染器读取动画场景 JS 和样式文件;上一步由 AI 将 HTML 图纸改写为这样的场景。
使用 Claude Motion
如果你的 Claude 提供 Motion Artifact,可在对话中提供完成的图纸,要求使用 dimensional-drawing-motion 制作动画。检查时间线后,从 Motion 界面导出 MP4;具体接入步骤见仓库的 Claude Motion 适配说明。