CHILDREN

Gets info about all the child elements of the current item.

If you are in page data, then "children" is all items, including groups, shapes, lines and layers on the page.

If you are inside a group shape or on a layer, then "children" is all shapes within the group or layer.

📘

NOTE: "children" only reflects the immediate children of your current space. So, if a group shape is a "child" of your current space, then the shapes that are making up that group shape are not the "children" of the current space. They are "descendants", but NOT children. The group shape is the "child".

Syntax

=CHILDREN

Examples

In the following examples, the selected shape is a group with 4 shapes in it, with the following text and values:

=CHILDREN → ["Shape 1", "Shape 2", "Shape 3", "Shape 4"]
The array of all children of the current shape.

=CHILDREN."Property 1" → [1, 4, 2, 6]
The array of "Property 1" values of all children of the current shape.

=CHILDREN."Property 2" → [10, 18, 14]
The array of "Property 2" values of all children of the current shape.

📘

NOTE: In the example above, the "Property 2" shape data does not exist for shape "Shape 3", so no data is included in the resulting array.

=CHILDREN."Property 3" → #ERROR!
The value of the shape data named "Property 3" on this shape. In the example above, the property does not exist, so the result is an error.