Chip.Builder

fun build(): Chip

Constructs the Chip defined by this builder.

fun setEndIcon(endIcon: CarIcon): Chip.Builder

Sets the icon to display at the end of the chip.

The icon must conform to DEFAULT.

A chip without an endIcon must set setTitle OR setStartIcon or the build will throw an exception. Without an endIcon, the host will render the chip with the passed in title and/or startIcon (depending on which has been set).

The icon will attempt to use the most specific tint supplied; this is, it will try to use the first tint found in the following priority: 1. setTint 2. setStylesetContentColor 3. setStyle content color 4. A host supplied color that matches the setSelected state Note that if the supplied color fails to meet contrast requirements, a host-supplied fallback that matches the selected state will be used.

Rasterized images such as (TYPE_BITMAP) images will not have any tints unless explicitly supplied through setTint..

fun setOnClickListener(onClickListener: OnClickListener): Chip.Builder

Sets the OnClickListener to be called when the chip is clicked.

Note that the listener relates to the UI events and will be executed on the main thread using getMainLooper.

fun setSelected(isSelected: Boolean): Chip.Builder

Sets the selected state of the chip, similar to how toggle has a selected state.

If the selected state is not set, the default will be false

If a custom style is provided through setStyle, changing this selected boolean value will not automatically change the color of this chip. The custom style must also be updated to reflect the selected state. See setStyle or setStyle for more details.

fun setStartIcon(startIcon: CarIcon): Chip.Builder

Sets the icon to display at the start of the chip.

The icon must conform to DEFAULT.

A chip without a startIcon must set setTitle OR setEndIcon or the build will throw an exception. Without a startIcon, the host will render the chip with the passed in title and/or endIcon (depending on which has been set).

The icon will attempt to use the most specific tint supplied; this is, it will try to use the first tint found in the following priority: 1. setTint 2. setStylesetContentColor 3. setStyle content color 4. A host supplied color that matches the setSelected state Note that if the supplied color fails to meet contrast requirements, a host-supplied fallback that matches the selected state will be used.

Rasterized images such as (TYPE_BITMAP) images will not have any tints unless explicitly supplied through setTint..

fun setStyle(style: ChipStyle): Chip.Builder

Sets the style of the chip.

This style overrides the style set in the ChipSection if one is provided. Any fields not explicitly set here or in the ChipSection will fall back to the host's default colors. If the style is not set or if the colors do not meet the contrast requirements, the host will set the chip styling to defaults based on the setSelected state.

fun setTitle(title: CarText): Chip.Builder

Sets the title of the chip, with support for multiple length variants.

A chip without a title must set setStartIcon OR setEndIcon or the build will throw an exception. Without a title, the host will render the chip with the passed in startIcon and/or endIcon (depending on which has been set).

The text must conform to TEXT_WITH_COLORS.

Developers can provide a shorter addVariant variant in case their title length exceeds the chip width limit enforced by the host.

fun setTitle(title: CharSequence): Chip.Builder

Sets the title of the chip.

A chip without a title must set setStartIcon OR setEndIcon or the build will throw an exception. Without a title, the host will render the chip with the passed in startIcon and/or endIcon (depending on which has been set).

The text must conform to TEXT_WITH_COLORS.