GridTemplate

@CarProtocol
public final class GridTemplate implements Template


A template representing a grid of items.

Template Restrictions In regards to template refreshes, as described in onGetTemplate, this template is considered a refresh of a previous one if:
  • The previous template is in a loading state (see setLoading, or
  • The template title has not changed, and the number of grid items and the title of each grid item have not changed.

Summary

Nested types

public final class GridTemplate.Builder

A builder of GridTemplate.

Constants

static final int

Represents a preference to crop all grid item images into the shape of a circle.

static final int

Represents a preference to keep the images as-is without modifying their shape.

static final int

Represents a large size for all grid items within a template.

static final int

Represents a medium size for all grid items within a template.

static final int

Represents a small size for all grid items within a template.

Public methods

boolean
@Nullable ActionStrip

Returns the ActionStrip for this template or null if not set.

@NonNull List<Action>

Returns the list of additional actions.

@Nullable Action

Returns the Action that is set to be displayed in the header of the template, or null if not set.

int

Returns the item image shape.

int

Returns the grid item size, which applies to all grid items in the template.

@Nullable ItemList

Returns the ItemList instance that contains the grid items to display or null if not set.

@Nullable CarText

Returns the title of the template or null if not set.

int
boolean

Returns whether the template is loading.

@NonNull String

Constants

ITEM_IMAGE_SHAPE_CIRCLE

Added in 1.4.0-rc02
@ExperimentalCarApi
@RequiresCarApi(value = 7)
public static final int ITEM_IMAGE_SHAPE_CIRCLE = 2

Represents a preference to crop all grid item images into the shape of a circle.

ITEM_IMAGE_SHAPE_UNSET

Added in 1.4.0-rc02
@ExperimentalCarApi
@RequiresCarApi(value = 7)
public static final int ITEM_IMAGE_SHAPE_UNSET = 1

Represents a preference to keep the images as-is without modifying their shape.

This is the default setting.

ITEM_SIZE_LARGE

Added in 1.4.0-rc02
@ExperimentalCarApi
@RequiresCarApi(value = 7)
public static final int ITEM_SIZE_LARGE = 4

Represents a large size for all grid items within a template.

See also
setItemSize

ITEM_SIZE_MEDIUM

Added in 1.4.0-rc02
@ExperimentalCarApi
@RequiresCarApi(value = 7)
public static final int ITEM_SIZE_MEDIUM = 2

Represents a medium size for all grid items within a template.

See also
setItemSize

ITEM_SIZE_SMALL

Added in 1.4.0-rc02
@ExperimentalCarApi
@RequiresCarApi(value = 7)
public static final int ITEM_SIZE_SMALL = 1

Represents a small size for all grid items within a template. This is the default size.

See also
setItemSize

Public methods

equals

Added in 1.4.0-rc02
public boolean equals(@Nullable Object other)

getActionStrip

Added in 1.0.0
public @Nullable ActionStrip getActionStrip()

Returns the ActionStrip for this template or null if not set.

See also
setActionStrip

getActions

Added in 1.4.0-rc02
@ExperimentalCarApi
@RequiresCarApi(value = 7)
public @NonNull List<ActiongetActions()

Returns the list of additional actions.

See also
addAction

getHeaderAction

Added in 1.0.0
public @Nullable Action getHeaderAction()

Returns the Action that is set to be displayed in the header of the template, or null if not set.

See also
setHeaderAction

getItemImageShape

Added in 1.4.0-rc02
@ExperimentalCarApi
@RequiresCarApi(value = 7)
public int getItemImageShape()

Returns the item image shape.

All item images in the grid are cropped into the specified shape.

getItemSize

Added in 1.4.0-rc02
@ExperimentalCarApi
@RequiresCarApi(value = 7)
public int getItemSize()

Returns the grid item size, which applies to all grid items in the template.

See also
setItemSize

getSingleList

Added in 1.0.0
public @Nullable ItemList getSingleList()

Returns the ItemList instance that contains the grid items to display or null if not set.

See also
setSingleList

getTitle

Added in 1.0.0
public @Nullable CarText getTitle()

Returns the title of the template or null if not set.

See also
setTitle

hashCode

Added in 1.4.0-rc02
public int hashCode()

isLoading

Added in 1.0.0
public boolean isLoading()

Returns whether the template is loading.

See also
setLoading

toString

Added in 1.4.0-rc02
public @NonNull String toString()