class CompactChip : LayoutElementBuilders.LayoutElement


ProtoLayout component CompactChip that represents clickable object with the text.

The CompactChip is Stadium shape and has a max height designed to take no more than one line of text of TYPOGRAPHY_CAPTION1 style with included margin for tap target to meet accessibility requirements. Width of the chip is adjustable to the text size.

The recommended set of ChipColors styles can be obtained from ChipDefaults., e.g. COMPACT_PRIMARY_COLORS to get a color scheme for a primary .

When accessing the contents of a container for testing, note that this element can't be simply casted back to the original type, i.e.:

CompactChip chip = new CompactChip...
Box box = new Box.Builder().addContent(chip).build();

CompactChip myChip = (CompactChip) box.getContents().get(0);
will fail.

To be able to get CompactChip object from any layout element, fromLayoutElement method should be used, i.e.:

CompactChip myChip = CompactChip.fromLayoutElement(box.getContents().get(0));

Summary

Nested types

Builder class for CompactChip.

Public functions

java-static CompactChip?

Returns CompactChip object from the given LayoutElement (e.g. one retrieved from a container's content with container.getContents().get(index)) if that element can be converted to CompactChip.

ChipColors

Returns chip color of this Chip.

ModifiersBuilders.Clickable

Returns click event action associated with this Chip.

TypeBuilders.StringProp?

Returns content description of this CompactChip.

String?

Returns icon id from this CompactChip if it has been added.

String

Returns text content of this Chip if it was set.

Boolean

Returns whether the text content of this Chip was set.

Public functions

fromLayoutElement

Added in 1.0.0
java-static fun fromLayoutElement(element: LayoutElementBuilders.LayoutElement): CompactChip?

Returns CompactChip object from the given LayoutElement (e.g. one retrieved from a container's content with container.getContents().get(index)) if that element can be converted to CompactChip. Otherwise, it will return null.

getChipColors

Added in 1.0.0
fun getChipColors(): ChipColors

Returns chip color of this Chip.

getClickable

Added in 1.0.0
fun getClickable(): ModifiersBuilders.Clickable

Returns click event action associated with this Chip.

getContentDescription

Added in 1.2.0
fun getContentDescription(): TypeBuilders.StringProp?

Returns content description of this CompactChip.

getIconContent

Added in 1.0.0
fun getIconContent(): String?

Returns icon id from this CompactChip if it has been added. Otherwise, it returns null.

getText

Added in 1.0.0
fun getText(): String

Returns text content of this Chip if it was set. If the text content wasn't set (either with setTextContent or constructor, this method will return an empty String. Whether text content exists on this Chip, that can be checked with hasText.

hasText

Added in 1.2.0
fun hasText(): Boolean

Returns whether the text content of this Chip was set.