GridTemplate.Builder

Builder()

Returns an empty Builder instance.

@ExperimentalCarApi
@RequiresCarApi(value = 7)
fun addAction(action: Action): GridTemplate.Builder

Adds a template scoped action outside of the grid items. This action will be displayed as a floating action button.

fun build(): GridTemplate

Constructs the template defined by this builder.

If none of the header Action, the header title or the action strip have been set on the template, the header is hidden.

fun setActionStrip(actionStrip: ActionStrip): GridTemplate.Builder

Sets the ActionStrip for this template.

Unless set with this method, the template will not have an action strip.

@RequiresCarApi(value = 7)
fun setHeader(header: Header): GridTemplate.Builder

Sets the Header for this template.

The end header actions will show up differently inside vs outside of a map template. See addEndHeaderAction for more details.

fun setHeaderAction(headerAction: Action): GridTemplate.Builder

Sets the Action that will be displayed in the header of the template.

Unless set with this method, the template will not have a header action.

@ExperimentalCarApi
fun setItemImageShape(itemImageShape: Int): GridTemplate.Builder

Sets the item image shape for this template.

Grid item images will all be cropped to the specified shape. If set to ITEM_IMAGE_SHAPE_UNSET, the images will be rendered as-is without changing the shape.

If not set, default to ITEM_IMAGE_SHAPE_UNSET.

@ExperimentalCarApi
fun setItemSize(gridItemSize: Int): GridTemplate.Builder

Sets a relative size of all grid items in the template.

This setting will affect the grid item image size and minimum width of each item. It can also impact the number of items displayed per row depending on screen size. These values may change in the future.

This setting takes precedence over the IMAGE_TYPE_LARGE setting for determining the grid item image size.

If this is not called, the default value is ITEM_SIZE_SMALL

fun setLoading(isLoading: Boolean): GridTemplate.Builder

Sets whether the template is in a loading state.

If set to true, the UI shows a loading indicator where the grid content would be otherwise. The caller is expected to call invalidate and send the new template content to the host once the data is ready. If set to false, the UI shows the ItemList contents added via setSingleList.

fun setSingleList(list: ItemList): GridTemplate.Builder

Sets a single ItemList to show in the template.

fun setTitle(title: CharSequence): GridTemplate.Builder

Sets the title of the template.

Unless set with this method, the template will not have a title.

Only DistanceSpans and DurationSpans are supported in the input string.