InstanceNode

appendChild 之后，默认保持 child 节点的 relativeTransform，由于 child 的父图层的改变，可能导致 child 节点在画布上的位置发生变更；若想保持 child 节点的位置，可以将 preserveAbsolutePostion 设为 true。

`insertChild`

Type: insertChild(index: number, child: SceneNode, preserveAbsolutePostion?: boolean): void

在指定的位置 index 处插入子节点 child。假设一个组有三个子节点 A、B、C，现在调用 insertChild 方法将插入图层节点 D：

insertChild(0, D)，子节点顺序为：D、A、B、C。
insertChild(1, D)，子节点顺序为：A、D、B、C。
insertChild(2, D)，子节点顺序为：A、B、D、C。
insertChild(3, D)，子节点顺序为：A、B、C、D。

`findChildren`

Type: findChildren(callback?: (node: SceneNode) => boolean): SceneNode[]

与 findAll 类似，不同之处在于，findChildren 仅会在当前节点的直接子节点（不包括子节点的子节点）中进行查找。

`findChild`

Type: findChild(callback: (node: SceneNode) => boolean): SceneNode | null

与 findOne 类似，不同之处在于，findChild 仅会在当前 ComponentNode 节点的直接子节点（不包括子节点的子节点）中进行查找。

`findAll`

Type: findAll(callback?: (node: SceneNode) => boolean): SceneNode[]

搜索整个子树（此节点的子节点、其子节点的子节点等）。返回回调为其返回 true 的所有节点。

`findOne`

Type: findOne(callback: (node: SceneNode) => boolean): SceneNode | null

从当前节点开始查找整个节点树，对每个节点调用 callback 函数，并返回第一个对于 callback 函数的返回值为 true 的节点。

`findAllWithCriteria`

Type: findAllWithCriteria<T extends NodeType[]>(criteria: {types: T;}): Array<{ type: T[number] } & SceneNode>
Type Declaration: NodeType

搜索整个子树（此节点的子节点、其子节点的子节点等）。返回满足条件中定义的任何类型的所有节点。

`layoutMode`

Type: "NONE" | "HORIZONTAL" | "VERTICAL"

确定此图层是否使用自动布局来定位其子级。默认为 NONE。

`layoutWrap`

Type: "NO_WRAP" | "WRAP"

确定此图层是否使用换行自动布局。默认为 NO_WRAP。

`primaryAxisSizingMode`

Type: "FIXED" | "AUTO"

仅适用于自动布局画板。确定主轴是否具有固定长度（由用户确定）或自动长度（由布局引擎确定）。

`counterAxisSizingMode`

Type: "FIXED" | "AUTO"

仅适用于自动布局画板。确定计数器轴是具有固定长度（由用户确定）还是自动长度（由布局引擎确定）。

`primaryAxisAlignItems`

Type: "MIN" | "MAX" | "CENTER" | "SPACE_BETWEEN"

仅适用于自动布局画板，否则忽略。确定自动布局画板的子画板应如何在主轴方向上对齐。

`counterAxisAlignItems`

Type: "MIN" | "MAX" | "CENTER"

仅适用于自动布局画板，否则忽略。确定自动布局画板的子画板应如何在反轴方向上对齐。

`paddingLeft`

Type: number

仅适用于采用自动布局的 Frame 图层节点。Frame 容器的左内边距。

`paddingRight`

Type: number

仅适用于采用自动布局的 Frame 图层节点。Frame 容器的右内边距。

`paddingTop`

Type: number

仅适用于采用自动布局的 Frame 图层节点。Frame 容器的上内边距。

`paddingBottom`

Type: number

仅适用于采用自动布局的 Frame 图层节点。Frame 容器的下内边距。

`itemSpacing`

Type: number

仅适用于采用自动布局的 Frame 图层节点。代表该 Frame 节点的子节点间的间距。

`counterAxisSpacing`

Type: number

仅适用于将 layoutWrap 设置为 WRAP 的自动布局框架。确定换行的距离。

`itemReverseZIndex`

Type: boolean

仅适用于自动布局画板。确定容器中图层的堆叠顺序。为 true 时，第一个图层将绘制在顶部。

`strokesIncludedInLayout`

Type: boolean

仅适用于自动布局画板。确定边框是否包含在布局计算中。当为 true 时，自动布局画板的行为类似于 css box-sizing: border-box。

`layoutGrids`

Type: ReadonlyArray<LayoutGrid>
Type Declaration: LayoutGrid

布局网格数组。

`gridStyleId`

Type: string

布局网格样式 Id。赋值为空即解绑样式。

`clipsContent`

Type: boolean

容器是否对超出的内容进行裁剪，即超出容器的图层是否可见。

`expanded`

Type: boolean 此容器是否在图层面板中显示为展开状态。

`opacity`

Type: number

读取或设置图层的透明度，其值必须在 [0, 1] 区间。

`blendMode`

Type: BlendMode
Type Declaration: BlendMode

图层的混合模式。

`isMask`

Type: boolean

图层是否是蒙版。

`effects`

Type: ReadonlyArray<Effect>

返回一个特效数组，具体数据结构可以查看 Effect。

`effectStyleId`

Type: string

当前节点所链接的特效样式的 id。即当前节点的 effects 属性所链接的 EffectStyle 对象的 id。赋值为空即解绑样式。

`x`

Type: number

图层节点的位置，等价于 relativeTransform[0][2]。

`y`

Type: number

图层节点的位置，等价于 relativeTransform[1][2]。

`width`

Readonly: true
Type: number

图层节点的宽度。

`height`

Readonly: true
Type: number

图层节点的高度。

`relativeTransform`

Type: Transform
Type Declaration: Transform

图层节点相对于其父节点的位置，以变换矩阵的方式呈现。注意：relativeTransform 对自动布局普通子图层不生效，带有绝对定位的子图层依然生效。

`absoluteTransform`

Readonly: true
Type: Transform
Type Declaration: Transform

图层节点相对于包含它的页面的位置，以变换矩阵的方式呈现。

`absoluteBoundingBox`

Readonly: true
Type: Rect | null
Type Declaration: Rect

不包括阴影或笔触等渲染属性的节点边界。

`getNestedBoundaryBox`

Type：getNestedBoundaryBox(): NestedBoundaryBox
Type Declaration: NestedBoundaryBox

获取当前图层及其所有子图层的 boundaryBox 信息

`absoluteRenderBounds`

Readonly: true
Type: Rect | null
Type Declaration: Rect

节点的实际边界，包括阴影、粗笔画和任何其他可能落在节点常规边界框之外的内容，这些边界框在 x、y、width 和中定义 height。这个属性里面的 x和y 代表节点在页面上的绝对位置。如果节点不可见，此值将为 null。

`constrainProportions`

Type: boolean

切换后，当用户通过属性面板调整图层大小时，使图层保持其比例。

`rotation`

Type: number

图层节点的旋转角度。值域为 [-180, 180]。其值等价于：

Math.atan2(-relativeTransform[1][0], relativeTransform[0][0]);

`layoutAlign`

Type: "STRETCH" | "INHERIT"

仅适用于自动布局画板的直接子级，否则忽略。确定图层是否应沿父级的反轴拉伸。默认为 INHERIT。

`layoutGrow`

Type: number

此属性仅适用于自动布局画板的直接子级，否则忽略。确定图层是否应沿父级的主轴拉伸。0 对应于固定大小，1 对应于拉伸。

`resize`

Type: resize(width: number, height: number): void

调整节点大小。如果节点包含具有约束的子节点，它会在调整大小期间应用这些约束。如果父级具有自动布局，则导致父级调整大小。

`resizeWithoutConstraints`

Type: resizeWithoutConstraints(width: number, height: number): void

调整节点大小。如果父级没有自动布局，则节点的子节点永远不会调整大小，即使这些子节点有约束。如果父级具有自动布局，则节点父级子节点和都会调整大小（不能忽略此约束）。

`rescale`

Type: rescale(scale: number): void

缩放图层节点，此 API 功能等同于使用工具栏中的缩放工具。

`constraints`

Type: Constraints
Type Declaration: Constraints

如果当前节点被包含在画板图层内，constraints表示约束的类型。

`cornerRadius`

Type: number | pixso.mixed

圆角。

`cornerSmoothing`

Type: number

控制角的平滑程度，值域为 [0, 1]。

`topLeftRadius`

Type: number

左上角的角度。必须是非负数，可以是小数。

`topRightRadius`

Type: number

右上角的角度。必须是非负数，可以是小数。

`bottomLeftRadius`

Type: number

左下角的角度。必须是非负数，可以是小数。

`bottomRightRadius`

Type: number

右下角的角度。必须是非负数，可以是小数。

`fills`

Type: ReadonlyArray<Paint> | pixso.mixed
Type Declaration: Paint

图层的填充。

// 设置 fills
node.fills = newFills;

`fillStyleId`

Type: string | pixso.mixed

当前节点所链接的填充样式的 id。即当前节点的 fills 属性所链接的 PaintStyle 对象的 id。赋值为空即解绑样式。

`strokes`

Type: ReadonlyArray<Paint>
Type Declaration: Paint

图层的描边。

`strokeStyleId`

Type: string

当前节点所链接的描边样式的 id。即当前节点的 strokes 属性所链接的 PaintStyle 对象的 id。赋值为空即解绑样式。

`strokeWeight`

Type: number

四个方向描边的粗细，以像素为单位。必须是非负数，可以是小数。需要注意，若设置了单边描边如strokeTopWeight，则以单边描边为准；若设置了 strokeWeight，会同时设置了四个方向的单边描边。

`strokeJoin`

Type: StrokeJoin | pixso.mixed
Type Declaration: StrokeJoin

边角的装饰。

'MITER': 直角。
'BEVEL': 斜切。
'ROUND': 圆角。

`strokeAlign`

Type: "CENTER" | "INSIDE" | "OUTSIDE"

描边相对于图层边界的对齐方式。

'CENTER': 居中。
'INSIDE': 内部。
'OUTSIDE': 外部。

`dashPattern`

Type: ReadonlyArray<number>

指定交替短划线和间隙长度的数字列表，以像素为单位。

`strokeCap`

Type: StrokeCap | pixso.mixed
Type Declaration: StrokeCap

端点的装饰。

`strokeMiterLimit`

Type: number

行程的斜接限制。这与 SVG 斜接限制相同。

您可以为矩形节点或画板状节点的四个边中的每一个设置单独的笔画粗细。与 strokeWeight 类似，这些值必须是非负的并且可以是小数。要隐藏一侧，请将值设置为 0。

设置 strokeWeight 设置所有四个边的值。

`strokeTopWeight`

Type: number

确定矩形节点或画板状节点上的顶部笔划粗细。必须是非负数，并且可以是小数。

`strokeBottomWeight`

Type: number

确定矩形节点或画板状节点上的底部笔划粗细。必须是非负数，并且可以是小数。

`strokeLeftWeight`

Type: number

确定矩形节点或画板状节点上的左笔画粗细。必须是非负数，并且可以是小数。

`strokeRightWeight`

Type: number

确定矩形节点或画板状节点上的右笔画粗细。必须是非负数，并且可以是小数。

`reactions`

Type: ReadonlyArray<Reaction>

此节点上的反应列表，其中包括原型中与此节点交互的方法以及该交互的行为。

`overflowDirection`

Type: "NONE" | "HORIZONTAL" | "VERTICAL" | "BOTH"

确定当画板包含超出画板边界的内容时，画板是否将在演示模式下滚动。反映原型选项卡中“溢出行为”中显示的值。

`numberOfFixedChildren`

Type: number

确定画板的哪些子级是滚动画板中的固定子级。

`overlayPositionType`

Readonly: true
Type: OverlayPositionType

当作为叠加层打开时，此画板的定位方式。

`OverlayBackground`

Readonly: true
Type: OverlayBackground

当作为叠加层打开时，此画板如何遮盖其下方的内容。

`overlayBackgroundInteraction`

Readonly: true
Type: overlayBackgroundInteraction

当作为叠加层打开时，用户如何与此画板下的内容进行交互。

`exportSettings`

Type: exportSettings: ReadonlyArray<ExportSettings>
Type Declaration: ExportSettings

节点的导出设置。

`exportAsync`

Type: exportAsync(settings?: ExportSettings): Promise<Uint8Array>
Type Declaration: ExportSettings

将节点导出为编码图像。

HWDC

`exportJsonAsync`

Type: exportJsonAsync(): Promise<string>

导出节点的 JSON 数据，该数据中包括节点的所有信息。

`exportHexAsync`

Type: exportHexAsync(hex: string): Promise<string>

导出节点的 Hex 数据，该数据中包括节点的所有信息。