platform_theming_api_common_attributes/com.tomtom.ivi.platform.theming.api.common.attributes/createComponents

createComponents

@IviExperimental(reasons = [])
fun <SF : Enum<SF>, IviThemeCategoryStylingFlavor> IviThemeCategory.createComponents(stylingFlavors: Set<SF>, idProvider: (SF) -> String): Set<IviThemeComponent.WithStylingFlavorType<SF>>

Creates IviThemeComponents for theming the IviThemeCategory receiver instance. An IviThemeComponent is created for each styling flavor in stylingFlavors.

The returned IviThemeComponents are parameterized by an IviThemeCategoryStylingFlavor enum type SF. Use this method when additional type-safety and compile-time checks are desired. Use createComponent without the stylingFlavor argument to create an IviThemeComponent without the additional type-safety. See IviThemeCategoryStylingFlavor for more information and an example.

The IviThemeComponent.label value of the returned instances are set to IviThemeCategoryStylingFlavor.label from each styling flavor in stylingFlavors. The IviThemeComponent.id value of the returned instances are set to the value returned by the idProvider. The idProvider is invoked for each styling flavor in stylingFlavors.

Parameters

stylingFlavors

Enum class values of enum type SF.

SF

The enum class type that defines a set of IviThemeCategory styling flavors. This type provides type-safety and allows for checking at compile time if all styling flavors are exhausted. See IviThemeCategoryStylingFlavor for more information and an example.

idProvider

Called to provide a unique identifier of each styling flavor in stylingFlavors. The following naming convention is applicable: <company>.<product>.themecomponent.<category>.<id>. For example: com.tomtom.ivi.themecomponent.color.dark.

@IviExperimental(reasons = [])
inline fun <SF : Enum<SF>, IviThemeCategoryStylingFlavor> IviThemeCategory.createComponents(noinline idProvider: (SF) -> String): Set<IviThemeComponent.WithStylingFlavorType<SF>>

Creates IviThemeComponents for theming the IviThemeCategory receiver instance. An IviThemeComponent is created for each styling flavor defined by the enum type SF.

The returned IviThemeComponents are parameterized by an IviThemeCategoryStylingFlavor enum type SF. Use this method when additional type-safety and compile-time checks are desired. Use createComponent without the stylingFlavor argument to create an IviThemeComponent without the additional type-safety. See IviThemeCategoryStylingFlavor for more information and an example.

The IviThemeComponent.label value of the returned instances are set to IviThemeCategoryStylingFlavor.label from each styling flavor defined by the enum type SF. The IviThemeComponent.id value of the returned instances are set to the value returned by the idProvider. The idProvider is invoked for each styling flavor defined by the enum type SF.

Parameters

SF

The enum class type that defines a set of IviThemeCategory styling flavors. This type provides type-safety and allows for checking at compile time if all styling flavors are exhausted. See IviThemeCategoryStylingFlavor for more information and an example.

idProvider

Called to provide a unique identifier of each styling flavor. The following naming convention is applicable: <company>.<product>.themecomponent.<category>.<id>. For example: com.tomtom.ivi.themecomponent.color.dark.