Using Figma Variants with react-figma

October 29, 2020 · 2 min read

Ilya Lesik

TL;DR Give me a code!

Variants is an amazing new feature of Figma, which lets you combine variations of the same component — simplifying the asset panel and mapping components more closely to code.

Figma Variants, source: figma.com

We were waiting for their launch since the announcement and started the implementation of Variants support in react-figma right after the Figma API Version 1, Update 18 release. Figma API got several new APIs:

Type ComponentSetNode — A component set contains the variants of a component.
combineAsVariants method — Creates a new ComponentSetNode by combining all the nodes in nodes, which should all have type ComponentNode.
importComponentSetByKeyAsync method.

`ComponentSet` component

We added a new component for Figma Variants support: the ComponentSet. It’s accepts a set of Component nodes as the children prop. We created an example with a button that has three variants: primary, dangerous, and secondary:

<ComponentSet name="Button">
    <Component name="variant=Primary">
        <PrimaryButton text="Primary" />
    </Component>
    <Component name="variant=Dangerous">
        <DangerousButton text="Dangerous" />
    </Component>
    <Component name="variant=Secondary">
        <SecondaryButton text="Secondary" />
    </Component>
</ComponentSet>

(see complete code here)

You can try the result of the rendering here or watch a demo gif:

Demo Gif

Conclusion

Variants are a really useful feature, especially for design systems creation. So, enjoy it with react-figma too!

Happy coding! 🙌

Thanks

Yaroslav Losev @losyear - fact checking, editing
Lera Lesik @Lera_Lesik - cover image

ComponentSet component#

Conclusion#

Thanks#

Links#

`ComponentSet` component

Conclusion

Thanks

Links