This function retrieves all tokens from the targeted design system as a flattened array. Note that this function will retrieve all tokens of all types. If you want tokens for just one type, use ds.tokensByType with appropriate type instead.
This function retrieves all tokens of a specified type from the targeted design system as a flattened array. The type can be any of the design token types.
Because groups don't contain the tokens they carry by default (only their IDs in tokenIds property), this function retrieves all tokens of a specified group from the targeted design system as a flattened array. The type can be any of the design token types.
Example Use
Example Payload
Definition
1
{*
2
Following construct will:
3
- Fetch all groups of type "Color"
4
- Iterate through the groups
5
- For each group, fetch the associated token
6
- Iterate through tokens
7
- List token names and associated groups
8
*}
9
{[ const groups = @ds.tokenGroupsOfType("Color") /]}
This function retrieves all token groups as a flat list.
Note that this function doesn't retrieve tokens that belong to this group. To fetch the token values as well, request the tokens by using ds.tokensByGroupId(group.id) for each group that you are interested in.
Example Use
Example Payload
Definition
1
{*
2
Following construct will:
3
- Fetch all groups in design system
4
- Iterate through the groups
5
- For each group, fetch the associated token
6
- Iterate through tokens
7
- List token names and associated groups, with their respective type
Similarly to ds.allTokenGroups , this function retrieves all token groups defined inside the design system. However, in this case, instead of returning all groups a flat array, it returns trees instead. There will be exactly as many trees in the resulting array as there are token categories (ie. one for colors, one for gradients, and so on).
This function always gets you the root of each category. You can iterate through the tree recursively by using traverse flow, recursive for variant.
Example Use
Example Payload
Definition
1
{*
2
Following construct will:
3
- Fetch all group roots
4
- Iterate through all root groups
5
- For each group, traverse all subgroups
6
- List all subgroups
7
- Note: Alternatively use `traverse` instead of `traverseChildren` to include root groups in the list
8
*}
9
{[ const groups = @ds.allTokenGroupTrees() /]}
10
{[ for rootGroup in groups ]}
11
---
12
{[ traverse rootGroup property subgroups into subgroup ]}
This function retrieves all token groups of one token type as a flat list. The result is the same as with ds.allTokenGroups, but other types than the provided one are filtered out.
Example Use
Example Payload
Definition
1
{*
2
Following construct will:
3
- Fetch all groups of type "Color"
4
- Iterate through the groups
5
- For each group, fetch the associated token
6
- Iterate through tokens
7
- List token names and associated groups, with their respective type
Similarly to ds.allTokenGroups , this function retrieves all token groups defined inside the design system for one specific token type. However, in this case, instead of returning all groups a flat array, it returns the root group instead. There is always only one root group per token type, so the result of this call is an object.
You can iterate through the tree recursively by using traverse flow, recursive for variant.
Example Use
Example Payload
Definition
1
{*
2
Following construct will:
3
- Fetch group root "Color"
4
- Traverse all groups from root
5
- List the group tree
6
*}
7
{[ const group = @ds.tokenGroupTreeByType("Color") /]}
8
​
9
{[ traverse group property subgroups into subgroup ]}
This function retrieves the group that directly contains the provided token id. There is always one group that contains one design token. This function is especially useful in injected blueprints, as you don't have to be passing groups with tokens - and can just request them instead.
Example Use
Example Payload
Definition
1
{*
2
Following construct will:
3
- Fetch token from context - context is property that gets created when you inject something
4
- Fetch group to which it belongs
5
- List all tokens under the same group as the provided token
6
*}
7
​
8
{[ const token = context.token /]}
9
{[ let group = @ds.tokenGroupContainingTokenId(token.id) /]}
This function retrieves metadata about the design system which is currently executed. You can use it to enhance exported files with additional information such as the design system name.
Currently exporting from {{ designSystem.name }} design system
Copied!
1
{
2
"id":"70",
3
"workspaceId":"20",
4
"name":"Nebula",
5
"description":"Our amazing little design system",
6
"isPublic":false,
7
"basePrefixes":[],
8
"source":{
9
"source":"Figma",
10
"fileId":"123456789123456789",
11
"fileName":"Nebula Design System"
12
}
13
}
Copied!
1
ds.currentDesignSystem(): DesignSystem
Copied!
​
Design System Versions
ds.currentDesignSystemVersion
This function retrieves the design system version which is currently executed. You can use it to enhance exported files with additional information such as the version name.
This function retrieves all design system versions for the design system that is being used when exporting. You can, for example, use it to quickly create release notes of the entire design system.