apple developer

home tech-notes github twitter stackoverflow dev.to

Accessing and Modifying the Node Tree

See the objects and functions you use to control the node tree’s composition.


You create the node tree by creating parent-child relationships between nodes. Each node maintains an ordered list of children, referenced by reading the node’s children property. The order of the children in the tree affects many aspects of scene processing, including hit testing and rendering, so it’s important to organize the node tree appropriately.

Method Description
addChild(_:) Adds a node to the end of the receiver’s list of child nodes.
insertChild(_:at:) Inserts a child into a specific position in the receiver’s list of child nodes.
removeFromParent() Removes the receiving node from its parent.

When you need to directly traverse the node tree, you use the properties in the following table to uncover the tree’s structure.

Property Description
children The array of SKNode objects that are the receiving node’s children.
parent If the node is a child of another node, this property holds the parent. Otherwise, it holds nil.
scene If the node is included anywhere in a scene, this property returns the scene node that is the root of the tree. Otherwise it holds nil.

download this page as .md

download this page as .pdf

back to SpriteKit documentation