fig-save
v1.3.3
Published
Batch download images from figma
Downloads
8
Readme
使用场景
UI 把项目切图单独放在 Figma 文件某个 node 下,该脚本通过 file key 和 node id 匹配并解析内容后批量 下载到本地,图片以对应的 node 名称命名。目前默认解析为切图的 node 类型是["FRAME", "COMPONENT"],可通过 figmaImgTypes 参数修改。
注意:由于存在即使是完全相同的 Node 节点,每次获取到的图片 url 也不同的限制,所以无法通过判断 url 来更新已下载的本地图片,目前只能在发出请求后通过eTag判断是否需要中断请求。 对于删除后不想再次下载的文件,请手动修改metadata.json(自动保存在图片路径)。
从 figma 获取 token
安装
npm install fig-save -D
使用
import { saveImgs } from 'fig-save';
// 或者
import saveImgs from 'fig-save';
// https://www.figma.com/file/:key/:title?node-id=:id
saveImgs(url, options);
Options
| 名字 | 默认 | 描述 | | :-----------: | :--------------------: | :----------------------------: | | scale | 1 | 在 0.01 到 4 之间 | | format | png | jpg, png, svg, or pdf | | saveDir | process.cwd()下的 imgs | 图片保存目录 | | concurrency | 5 | 并发下载数量 | | figmaImgTypes | ["FRAME", "COMPONENT"] | Figma 节点转图片下载的类型范围 |
TODO:
- [ ] 通过UI指定切图的唯一标记,下载任意node节点下的切图
- [x] 通过文件etag判断,跳过重复文件下载