Array of Tokens to Set
What It Does
The Array of Tokens to Set node converts a flat array of tokens into a hierarchical token set structure. It transforms a simple list of tokens into a nested object structure, organizing tokens based on their names.
Inputs
| Name | Description | Type | Required |
|---|---|---|---|
| Tokens | A flat array of design tokens | List | Yes |
Outputs
| Name | Description | Type |
|---|---|---|
| Token Set | A hierarchical collection of tokens organized by their names | Object |
How to Use It
- Drag the Array of Tokens to Set node into your graph.
- Connect an array of tokens to the "Tokens" input.
- The node will organize the tokens into a hierarchical structure based on the name properties of each token.
- Use the resulting token set with nodes that require structured token collections.
Tips
- Token names with periods or slashes (e.g.,
colors.primaryorcolors/primary) will be converted into nested objects in the resulting set. - This node is useful for preparing tokens for export to file formats that expect a hierarchical structure.
- All token metadata is preserved during the conversion process.
See Also
- Token set to token array: For converting in the opposite direction.
- Group: For more customizable grouping operations on token arrays.
Use Cases
- Token Export Preparation: Convert a processed list of tokens back into a structured format for export.
- Token Organization: Automatically organize a flat list of tokens into a logical hierarchy.
- Token Structure Rebuilding: Restore hierarchical structure to tokens that have been flattened for processing.