剖析 Figma 图形对象的基本属性

大家好，我是前端西瓜哥。

今天我们来看看 Figma 图形对象的一些基本属性。

这些属性来自 fig 文件，更贴近 Figma 图形的底层数据结构。

Figma 也提供了 REST API 接口获取设计稿的图形树结构，且大多数属性和 fig 文件的相同，文档说明也更详细。

但有些属性在底层属性上做了一层封装，以提供更好的语义。比如在 REST API 的数据有 rotation 属性，但 fig 文件并没有，需要通过 transform 矩阵属性计算出来。

www.figma.com/developers/...

基本属性

guid：图形 id 对象，用于唯一标识图形。

它有两个属性：sessionID（会话 id，每个 socket 连接一个唯一 id），以及 localID（一个自增 id），二者组合可得到一个在和本地图形和其他客户端图形都不同的唯一 id，以便实现协同编辑。

json 复制代码

{
  "sessionID": 1,
  "localID": 7
}

phase：通常是 CREATED，表示创建。貌似使用了 quill 的 delta 风格。不知道有没有其他的值，比如 delete 这些。

parentIndex：父节点 id。fig 的数据结构是拍平的一维数组，加载时需要根据 parentIndex 还原为图形树结构。

type：图形（或者说是节点）类型，比如 ROUNDED_RECTANGLE（圆角矩形）、VECTOR（矢量网格）。还有一些非图形的类型，如 VARIABLE（变量，比如颜色变量）。

name：图形名。

visible：是否可见。

locked：是否锁定，锁定的图形不可选择，不可通过光标移动。

opacity：不透明度，介于 0 到 1 之间。0 表示完全透明，1表示完全不透明。

blendMode：混合模式，表示当前节点和其下的图层以何种形式混合。默认为 PASS_THROUGH（穿透）。

size：一个对象，x 为宽，y 为高。属性名不是 width 和 height，大概因为用了矢量结构体；

transform：一个表达 3x3 矩阵的对象，会对节点进行矩阵变换；

size 和 transform 可以表达一个变形的矩形，包括位移、旋转、翻转、斜切等。

这种表达方式很简洁，方便做 GPU 并行渲染，也便于直转 SVG。

proportionsConstrained：是否锁定宽高比。如果为 true，输入框修改宽时，高会自动更新，保持原来的宽高比，反之同理。

cornerRadius：圆角半径；

cornerSmoothing：平滑圆角程度，比如 60% 对应 iOS 图标的平滑程度；

horizontalConstraint / verticalConstraint：图形的水平和垂直约束，指定在 frame（画框）缩放时图形缩放或移动的方式。

支持的类型值有：

MIN：默认值，向左或向上保持固定距离；
MAX：向右或向下保持固定距离；
CENTER：向 frame 的中心点保持相对距离；
STRETCH：拉伸，向左（上）和向右固定距离，缩放 frame 会引起图形拉伸；
SCALE：保持相对 frame 的比例关系；

handleMirroring：拖拽控制点调整路片段（segment）时，入控制点（handleIn）和出控制点(handleOut)的镜像关系。

有三种形式：

NONE，默认值，无镜像关系，两个控制点各自独立;
ANGLE，角度一致但长度各自独立，表现为：修改一个控制点，两个控制点和路径点都在一条直线上，但另一个控制点到路径点的长度保持不变;
ANGLE_AND_LENGTH，角度和长度相同，即完全 路径点对称，见下图。

填充

fillPaints：填充对应的 Paint 数组。

比如下面是SOLID（纯色）的表示。

json 复制代码

fillPaints: [
  {
    "type": "SOLID",
    "color": {
      "r": 0.7631543278694153,
      "g": 0.9063313603401184,
      "b": 0.6506586074829102,
      "a": 1
    },
    "opacity": 1,
    "visible": true,
    "blendMode": "NORMAL" // 这里也有混合模式
  },
]

数组前面的填充会覆盖掉后面的填充。

此外 Figma 还支持 IMAGE（图片）、GRADIENT_LINEAR（线性渐变）、GRADIENT_LINEAR（径向渐变）、GRADIENT_ANGULAR（旋转渐变）、GRADIENT_DIAMOND（菱形渐变）、VIDEO （视频）等 PaintType 类型。

fillGeometry：大概是填充对应的图形化描述，指向一个 Buffer 对象，能转成类型数组，但不知道什么解析。

但如果使用开发者 REST API，这个属性得到的是 SVG 的 Path 描述；

描边

strokePatins：描边数组，基本和 fillPaints 一样。

strokeGeometry：同 fillGeometry。

strokeWeight：描边宽度。

dashPattern：数字数组，描述虚线描边的规则，指定连续的 "实线-虚线-实线-..." 这样循环下去，参考 SVG 的 stroke-dasharray 属性。

strokeAlign：描边对齐，默认为 INSIDE（内描边），此外还有 CENTER（往两边扩展）、OUTSIDE（外描边）。

strokeCap：描边路径两端的样式，默认为 NONE，除了经典的 SQUARE、ROUND，还有特殊的 LINE_ARROW、CIRCLE_FILLED 等值，可以产生箭头或其他特殊样式。

strokeJoin：路径转角的处理方式。MITER（斜接）、 BEVEL（倒角）和 ROUND（圆角）。

miterLimit：对斜角长度与线宽比例的阈值，在 strokeJoin 为 milter 时有效，表示为超过阈值时，尖角会变成 bevel。的效果。

编辑器 UI 上并没有这个属性，但有个 Miter angle 属性，它和 miterLimit 的转换关系为：miterLimit = miterLength / stroke-width = 1 / sin (theta / 2)。可以参考 SVG 的 stroke-milterlimit 属性。

下图中，蓝色路径的转角突破了阈值，小于 28.96，于是从 miter 变成了bevel。

效果

effects：效果数组。

有这几种效果：

DROP_SHADOW：外阴影；
INNER_SHADOW：内阴影；
BACKGROUND_BLUR：背景模糊，该图层下的背景会被模糊掉，类似毛玻璃效果，通常这个图形要设置透明度；
FOREGROUND_BLUR：前景模糊（貌似就是高斯模糊）

蒙版

mask：图形是否作为蒙版，设置为蒙版图形的前面的兄弟节点不在被蒙版区域的部分不会被渲染；

maskType：指定蒙版类型。默认是 ALPHA （基于透明度），此外还有 VECTOR（基于图形轮廓线）、LUMINANCE（基于明度）；

结尾

还有不少特定图形才有的属性，比如文本对象特有的 fontSize，并不在本文的讨论范围内，我们下篇文章再聊。

我是前端西瓜哥，欢迎关注我，学习更多图形编辑器知识。