Na lição anterior, você criou um navegador de catálogo, implementado em um fragmento de navegação, que exibe uma lista de itens de mídia. Nesta lição, você vai criar as visualizações de card para seus itens de mídia e apresentá-las no fragmento de navegação.
A classe
BaseCardView
e as subclasses mostram os metadados associados a um item de mídia. A classe
ImageCardView
usada nesta lição exibe uma imagem para o conteúdo junto ao título do item de mídia.
Veja também a implementação no app de exemplo do Leanback .
![Visualização de card de apps](https://developer.android.com/static/images/tv/card-view.png?authuser=6&hl=pt)
Figura 1. Visualização de card do app de amostra de Leanback quando selecionado.
Criar uma apresentação de card
Um Presenter
gera visualizações e vincula objetos a elas
sob demanda. No fragmento de navegação em que o app apresenta conteúdo ao usuário, crie um
Presenter
para os cards de conteúdo e transmita-o ao adaptador
que adiciona o conteúdo à tela. No código abaixo, o CardPresenter
é criado
no callback onLoadFinished()
do LoaderManager
:
Kotlin
override fun onLoadFinished(loader: Loader<HashMap<String, List<Movie>>>, data: HashMap<String, List<Movie>>) { rowsAdapter = ArrayObjectAdapter(ListRowPresenter()) val cardPresenter = CardPresenter() var i = 0L data.entries.forEach { entry -> val listRowAdapter = ArrayObjectAdapter(cardPresenter).apply { entry.value.forEach { movie -> add(movie) } } val header = HeaderItem(i, entry.key) i++ rowsAdapter.add(ListRow(header, listRowAdapter)) } val gridHeader = HeaderItem(i, getString(R.string.more_samples)) val gridRowAdapter = ArrayObjectAdapter(GridItemPresenter()).apply { add(getString(R.string.grid_view)) add(getString(R.string.error_fragment)) add(getString(R.string.personal_settings)) } rowsAdapter.add(ListRow(gridHeader, gridRowAdapter)) adapter = rowsAdapter updateRecommendations() }
Java
@Override public void onLoadFinished(Loader<HashMap<String, List<Movie>>> arg0, HashMap<String, List<Movie>> data) { rowsAdapter = new ArrayObjectAdapter(new ListRowPresenter()); CardPresenter cardPresenter = new CardPresenter(); int i = 0; for (Map.Entry<String, List<Movie>> entry : data.entrySet()) { ArrayObjectAdapter listRowAdapter = new ArrayObjectAdapter(cardPresenter); List<Movie> list = entry.getValue(); for (int j = 0; j < list.size(); j++) { listRowAdapter.add(list.get(j)); } HeaderItem header = new HeaderItem(i, entry.getKey()); i++; rowsAdapter.add(new ListRow(header, listRowAdapter)); } HeaderItem gridHeader = new HeaderItem(i, getString(R.string.more_samples)); GridItemPresenter gridPresenter = new GridItemPresenter(); ArrayObjectAdapter gridRowAdapter = new ArrayObjectAdapter(gridPresenter); gridRowAdapter.add(getString(R.string.grid_view)); gridRowAdapter.add(getString(R.string.error_fragment)); gridRowAdapter.add(getString(R.string.personal_settings)); rowsAdapter.add(new ListRow(gridHeader, gridRowAdapter)); setAdapter(rowsAdapter); updateRecommendations(); }
Criar uma visualização de card
Nesta etapa, você vai criar o apresentador de card com um armazenador de visualização para a visualização de card que descreve os itens de conteúdo de mídia. Observe que cada apresentador precisa criar apenas um tipo de visualização. Se você tiver dois tipos de visualização de card, precisará de dois apresentadores.
No Presenter
, implemente um callback
onCreateViewHolder()
que crie um armazenador de visualização que pode ser usado para mostrar um item de conteúdo:
Kotlin
private const val CARD_WIDTH = 313 private const val CARD_HEIGHT = 176 class CardPresenter : Presenter() { private lateinit var mContext: Context private lateinit var defaultCardImage: Drawable override fun onCreateViewHolder(parent: ViewGroup): Presenter.ViewHolder { mContext = parent.context defaultCardImage = mContext.resources.getDrawable(R.drawable.movie) ...
Java
@Override public class CardPresenter extends Presenter { private Context context; private static int CARD_WIDTH = 313; private static int CARD_HEIGHT = 176; private Drawable defaultCardImage; @Override public ViewHolder onCreateViewHolder(ViewGroup parent) { context = parent.getContext(); defaultCardImage = context.getResources().getDrawable(R.drawable.movie); ...
No método onCreateViewHolder()
,
crie uma visualização de card para itens de conteúdo. O exemplo a seguir usa um
ImageCardView
.
Quando um card é selecionado, o comportamento padrão o expande para um tamanho maior. Se você quiser designar
uma cor diferente para o card selecionado, chame setSelected()
,
conforme mostrado aqui:
Kotlin
... val cardView = object : ImageCardView(context) { override fun setSelected(selected: Boolean) { val selected_background = context.resources.getColor(R.color.detail_background) val default_background = context.resources.getColor(R.color.default_background) val color = if (selected) selected_background else default_background findViewById<View>(R.id.info_field).setBackgroundColor(color) super.setSelected(selected) } } ...
Java
... ImageCardView cardView = new ImageCardView(context) { @Override public void setSelected(boolean selected) { int selected_background = context.getResources().getColor(R.color.detail_background); int default_background = context.getResources().getColor(R.color.default_background); int color = selected ? selected_background : default_background; findViewById(R.id.info_field).setBackgroundColor(color); super.setSelected(selected); } }; ...
Quando o usuário abre seu app, o Presenter.ViewHolder
mostra os objetos CardView
dos itens de conteúdo. Você precisa configurá-los para receber
foco do controlador de botão direcional chamando setFocusable(true)
e setFocusableInTouchMode(true)
,
conforme mostrado no código a seguir:
Kotlin
... cardView.isFocusable = true cardView.isFocusableInTouchMode = true return ViewHolder(cardView) }
Java
... cardView.setFocusable(true); cardView.setFocusableInTouchMode(true); return new ViewHolder(cardView); }
Quando o usuário seleciona a ImageCardView
, ela se expande
para revelar a área de texto com a cor de fundo especificada, como mostrado na Figura 1.