Themes within Airkit provide a way to brand an application to create a particular look and feel. There's the ability to import/export themes, change the visual properties of any type of controls, or add specific variants for each control, all configured within Theme Builder. This article will cover the following topics:
- Modifying a Variant
- Adding a Variant
- Changing Styles in a Theme
- Adding a Style Class to a Theme
- Exporting and Importing Themes
A variant in Airkit is a set of styling properties for a specific control, similar to a class in CSS. Variants are used to create style uniformity across an application. For example, labels have multiple variants such as a body text variant or a headline variant, and these variants can be selected when adding a label control to an application. Each of these variants have different properties associated with them and can be maintained and edited within Theme Builder. When a variant is edited, then that change will reflect across all instances of that control using that variant. Variants are also seen when adding a control in an application. When adding a control, there is the option to select the different variants available with the option to modify it later as well.
Modifying a Variant
For example, an application uses a mix of body text and headline text and there is a requirement to change all the headline text to have a bold font weight. Instead of identifying all of the label controls with a headline text and overriding the styles, the headline text variant can be edited.
Go to Theme Builder and open the Label Variant accordion in the tree. Select largeHeadline, which is the largeHeadline variant that would be used across the application.
When largeHeadline is selected, the inspector will show all of the style properties that are associated with largeHeadline. Any changes made here will reflect across all instances of largeHeadline in an application, unless the styles are overrode in Activity Builder. To change the font weight of the largeHeadline to bold, change the dropdown from Regular to Bold under the Font properties.
After saving, the changes will then reflect in the application.
Adding a Variant
If none of the variants that come default fit the need of an application or the application requires additional variants, there is the ability to add a variant to any of the controls. This example will show how to add a Button Variant.
Go to Theme Builder and click on the '+' icon at the Theme level in the tree. Select 'Button'.
Select the 'Button Variant' accordion in the tree and there will be a variant called 'default 2' which was the variant just added. The variant can also be renamed to a name that is more fitting for that variant.
Select 'default 2' and see the inspector. In the inspector is where the different style properties can be set. Once the styles are set, save the application and the variant can be used throughout the application.
There is also the ability to duplicate variants as well. To duplicate variants, click on the 'Duplicate' icon to make an exact copy of the selected variant.
Changing Styles in a Theme
In Theme Builder, there are different levels at which styles can be applied. Styles can be applied by variant or they can be applied to affect the entire application. Themes consist of Colors, Sizes, and Fonts and include theme variables that can be referenced throughout the application and control variants. These styles are also used by all the default variants as well, so when configured, it will also affect the default variants.
To change a style in a Theme, go to Theme Builder and click on 'Theme' in the tree. The inspector will then show all of the different theme variables that can be configured.
Then select a property to change. For example, to change the primary color of the brand of an application, click on the hex value of the brandPrimary property and change the color. This change will automatically affect all controls and variants that use the brandPrimary property for that control.
Changing style properties at the Theme level is useful for creating a stylesheet for an application without having to change colors, fonts, or sizes in many areas.
Adding a Theme Variable
If a theme requires additional styles, there is also the ability to add additional color, size, or font theme variables. To add a Theme Variable, go the Theme Builder and with Theme selected in the tree, click on the '+' icon next to one of the Theme properties. This will create a new Color, Size, or Font variable to be used across the application or variants.
Exporting and Importing Themes
Themes can be imported or exported into an application within Theme Builder. This is useful for when there are multiple applications that will have the same look and feel, without having to rebuild out a Theme or specific variants in Theme builder for each application.
To export a Theme, go to Theme Builder and click on the export icon. This will download a .JSON file that contains all of the style properties from the Theme that was exported.
To import a Theme, go to Theme Builder of the application that will be using the downloaded theme, and click on the import icon. Then click on 'Import a new theme' and select the Theme.json file that was exported. This will import the theme to the application!
Themes and control variants provide a mechanism to quickly and efficiently style an application. They help bring a uniform look and feel to applications and help standardize how the different controls look across the application. For more information on styling, see: