Fournir une vue Fiche

Créez mieux avec Compose
Créez des interfaces utilisateur attrayantes avec un minimum de code à l'aide de Jetpack Compose pour l'OS Android TV.
<ph type="x-smartling-placeholder"></ph> Compose pour la télévision →

Dans la leçon précédente, vous avez créé un navigateur de catalogue, implémenté dans un fragment de navigation, affiche une liste d'éléments multimédias. Dans cette leçon, vous allez créer des vues de fiches pour vos éléments multimédias les présenter dans le fragment de navigation.

BaseCardView et les sous-classes affichent les métadonnées associées à un élément multimédia. La ImageCardView utilisée dans cette leçon affiche une image pour le contenu ainsi que le titre de l'élément multimédia.

Consultez également l'exemple d'implémentation dans le <ph type="x-smartling-placeholder"></ph> Exemple d'application Leanback pour en savoir plus.

Vue Fiche de l&#39;application

Figure 1 : Vue sous forme de fiche contenant l'image de l'application exemple Leanback lorsque celle-ci est sélectionnée.

Créer un présentateur de carte

Un Presenter génère des vues et leur associe des objets à la demande. Dans le fragment de navigation dans lequel votre application présente son contenu à l'utilisateur, vous créez un élément Presenter pour les fiches de contenu et le transmettre à l'adaptateur qui ajoute le contenu à l'écran. Dans le code suivant, CardPresenter est créé. dans le onLoadFinished() rappel de 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();
}

Créer une vue Fiche

Au cours de cette étape, vous allez créer le présentateur de carte avec un conteneur de vue pour la vue de carte qui décrit vos éléments de contenu multimédia. Notez que chaque présentateur ne doit créer qu'un seul type de vue. Si vous avez deux types de vues Fiche, vous avez besoin de deux présentateurs de fiche.

Dans Presenter, implémentez une onCreateViewHolder() qui crée un conteneur de vue pouvant être utilisé pour afficher un élément de contenu:

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);
...

Dans la méthode onCreateViewHolder(), créer une vue Fiche pour les éléments de contenu. L'exemple suivant utilise un ImageCardView

Lorsqu'une fiche est sélectionnée, elle s'agrandit par défaut. Si vous souhaitez indiquer une autre couleur pour la fiche sélectionnée, appeler setSelected() comme indiqué ici:

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);
        }
    };
...

Lorsque l'utilisateur ouvre votre application, le Presenter.ViewHolder affiche les objets CardView pour vos éléments de contenu. Vous devez les définir pour recevoir le curseur du contrôleur du pavé directionnel en appelant setFocusable(true) et setFocusableInTouchMode(true), comme indiqué dans le code suivant:

Kotlin

    ...
    cardView.isFocusable = true
    cardView.isFocusableInTouchMode = true
    return ViewHolder(cardView)
}

Java

...
    cardView.setFocusable(true);
    cardView.setFocusableInTouchMode(true);
    return new ViewHolder(cardView);
}

Lorsque l'utilisateur sélectionne l'élément ImageCardView, celui-ci se développe. pour faire apparaître sa zone de texte avec la couleur d'arrière-plan que vous spécifiez, comme illustré dans la figure 1.