SuperAPI AI 工具集

figma-slides

设计与创作

查看项目

更新于 10-16 00:20

技能介绍

用途:在 Figma Slides 中编写和编辑演示文稿。每张幻灯片是 SLIDE 节点,整个演示文稿是二维网格(figma.getSlideGrid() 返回按行排列的幻灯片)。

主要能力:管理幻灯片网格(列出、新建、复制、重排、删除、聚焦、跳过),添加内容(文本、形状、背景色),以及控制切换效果。

使用方式:先确认文件是 Slides 类型,可用 return { editorType: figma.editorType }; 检查,结果须为 'slides',否则所有操作都会抛错。列出幻灯片以获取 ID 和网格位置,幻灯片 ID 是其他操作引用的依据。从 references/slides-snippets.md 选择操作,通过 use_figma(skillNames: "figma-slides")运行片段,并编辑内联常量。完成后返回新建或变更的幻灯片 ID,并重新列出或读取内容确认。

要点:添加文本前必须先 await figma.loadFontAsync({ family, style }),默认 Inter / Regular。用 figma.createSlide({ row, col }) 在指定网格位置创建,或用 figma.createSlide() 追加。切换样式值包括 NONE、DISSOLVE、SLIDE_FROM_LEFT、SLIDE_FROM_RIGHT、SLIDE_FROM_BOTTOM、SLIDE_FROM_TOP、PUSH_FROM_LEFT、PUSH_FROM_RIGHT、PUSH_FROM_BOTTOM、PUSH_FROM_TOP、SMART_ANIMATE,计时默认 { type: 'ON_CLICK' }。背景以 1920×1080 全出血矩形插入索引 0,重复运行会更新已有背景而非叠加。reorder 接收幻灯片 ID 的二维数组(行×列),通过 figma.setSlideGrid 重建网格,所有 ID 必须存在于当前网格。跳过切换的是 slide.isSkippedSlide。

限制:这些工具需要 Figma 桌面应用,浏览器中不可用 Plugin API。脚本为普通 JS,使用顶层 await 和 return,不用 IIFE,不调用 figma.closePlugin(),console.log 不会返回;颜色范围为 0–1;错误是原子性的,脚本失败不会应用任何更改,需读取错误、修复后重试。每个操作的完整片段见 references/slides-snippets.md。