Text
A block of text set in one font. The box (w, h) holds the lines; with auto width the box grows to fit the text, otherwise it keeps its size and the text can wrap inside it.
In a formula, a node is called by its name in the layers panel: Text1.content
Properties
fontWeightString#
'bold' draws heavy letters, 'normal' regular ones.
Default 'normal' · 'normal' | 'bold' · animatable
fontStyleString#
'italic' slants the letters, 'normal' keeps them upright.
Default 'normal' · 'normal' | 'italic' · animatable
textDecorationString#
'line-through' strikes a line through the text in the fill colour, 'none' draws no line.
Default 'none' · 'none' | 'line-through' · animatable
textAlignString#
Where each line sits across the box width: 'left', 'center' or 'right'.
Default 'left' · 'left' | 'center' | 'right' · animatable
verticalAlignString#
Where the block of lines sits in the box height: 'top', 'middle' or 'bottom'.
Default 'top' · 'top' | 'middle' | 'bottom' · animatable
lineHeightNumber#
Height of one line as a multiple of the font size. 1.2 is 120% of fontSize.
Default 1.2 · 0.5 – 5 · animatable
letterSpacingNumber#
Extra px added after every character. Negative values pull letters closer.
Default 0 · -100 – 400 · animatable
wordWrapBoolean#
Breaks lines at spaces to fit the box width. Works only when autoWidth is off.
Default false · animatable
autoWidthBoolean#
The box width follows the longest line. Turn it off to keep w fixed.
Default true · animatable
Transform from Transform
xNumber#
Horizontal position of the node's origin, in pixels from its parent's origin.
The origin is the point the node turns and scales around (the small circle you can drag on the canvas). Setting x moves the whole node so that its origin lands there.
pixels · animatable
yNumber#
Vertical position of the node's origin, in pixels from its parent's origin. Larger values are lower.
pixels · animatable
wNumber#
Width of the node in pixels.
On a skewed node this is the width you see on screen, not the width of the box before the skew.
0 – ∞ · pixels · animatable
rotationNumber#
How far the node is turned around its origin, in degrees. Positive values turn it clockwise.
degrees · animatable
skewNumber#
How far the node is slanted along its own horizontal axis, in degrees.
Accepted values are -89 to 89, and 0 means no slant. The node stays anchored at its origin. A skewed node reports a wider w, because w is the width you see on screen. Bones and skeletons ignore skew.
degrees
Fill from Fill
fillsPaint[]#
The list of paints that fill the inside of the shape.
Paints are drawn in list order, so each one covers the one before it. A new shape starts with one grey solid paint. An empty list leaves the shape unfilled. Read a single paint with fills[0].
animatable
Appearance from Appearance
opacityNumber#
How opaque the node is, from 0 (invisible) to 1 (solid).
It applies to the node and everything inside it. It multiplies with the opacity of each paint.
Default 1 · 0 – 1 · animatable
blendModeBlendMode#
How the node mixes its colours with what is behind it, for example MULTIPLY or SCREEN.
NORMAL just draws over the background. The other values are NORMAL, PASS_THROUGH, MULTIPLY, SCREEN, OVERLAY, DARKEN, LIGHTEN, COLOR_DODGE, COLOR_BURN, HARD_LIGHT, SOFT_LIGHT, DIFFERENCE, EXCLUSION, HUE, SATURATION, COLOR and LUMINOSITY.
Default 'NORMAL' · animatable
visibleBoolean#
Whether the node is drawn. Set it to false to hide the node and everything inside it.
A hidden node still exists, so formulas can read and change its properties.
Default true · animatable
Node methods every node has them
is(typeOrTag: String) → Booleanmethod#
True when the node is of this type or carries this tag.
typeOrTagA node type such as 'RECT', or a tag.
clone() → Nodemethod#
Makes a copy of the node and returns it, so code can place and change the copy.
destroy()method#
Marks the node for removal; it is taken out of the scene at the end of the frame.
appendChild(child: Node) → Nodemethod#
Moves child into this node as its last child and returns it.
insertBefore(newChild: Node, refChild: Node | null) → Nodemethod#
Moves newChild into this node, just before refChild, and returns it.
refChildThe child to insert before; null appends at the end.
removeChild(child: Node) → Nodemethod#
Takes child out of this node and returns it.
replaceChildren(...nodes: Node)method#
Replaces all of this node's children with the given nodes, in that order.
insertAdjacentElement(position: 'afterbegin' | 'beforeend', element: Node) → Node | nullmethod#
Moves element into this node, as its first or last child.
position'afterbegin' puts it first, 'beforeend' last. Any other position does nothing and returns null.
on(event: String, fn: Function)method#
Calls fn each time fire(event) is called on this node. These are the node's own messages, not the Events panel: a click does not reach on('click').
off(event: String, fn: Function)method#
Stops calling fn for event.
fnThe same function that was passed to on.
fire(event: String, ...args: any)method#
Calls every function added with on(event) on this node, in the order they were added.
...argsPassed on to every listener.