findAll
Searches the entire document tree. Returns all nodes for which callback
returns true.
Supported On:
Signature
findAll(callback?: (node: PageNode | SceneNode) => boolean): Array<PageNode | SceneNode>
Parameters
callback
A function that evaluates whether to return the provided node
. If this argument is omitted, findAll
returns all nodes in the subtree.
Remarks
Nodes are included in back-to-front order. Parents always appear before their children, and children appear in same relative order before their children, and children appear in same relative order as in the children
array.
This traversal method is known as "pre-order traversal".
Note that the root node itself is not included.
Example: find all nodes whose name is "Color":
const colors = figma.root.findAll(n => n.name === "Color")
caution
⚠ Large documents in Figma can have tens of thousands of nodes. Be careful using this function as it could be very slow. Please refer to our recommendations for how to optimize document traversals.