Introduction

---

In this post I show you how to use a Horizontal RecyclerView to display list items with an image and text.

You'll learn to build a recyclerview adapter class from scratch and display images and text. To retrieve the images from the internet we use the "Glide" library.

Make sure to get the most up-to-date version of the Glide library. Outdated versions typically have issues. You can get the dependency here: https://github.com/bumptech/glide

This is a perfect example if you're a beginner and need a step-by-step example on how to use a Horizontal recyclerview in your android project.

All Source Code is available on my Github for free.

App Demo

---

Here's a visual of the simple app we'll be building:

The app will have a single activity: MainActivity.java

MainActivity will contain a RecyclerView with all the list items. User's will have the ability to scroll left or right on the list.

Dependencies

---

We'll start with the dependencies:

We have:

1. The RecyclerView support library that's required for using RecyclerViews
2. The CardView support library for using CardViews
3. The Glide library for retrieving and displaying images from the internet
4. And a CircleImageView library for displaying circular images

Remember to get the most up-to-date version of the Glide library: https://github.com/bumptech/glide

build.gradle (app file)

Layouts

---

Next we have the layouts.

activity_main.xml

activity_main is simple. There's just a RecyclerView widget with a vertical orientation for holding our list items.

layout_listitem.xml

layout_listitemis responsible for displaying the individual list items in the RecyclerView. It contains a CardView, an ImageView, and a TextView widget.

Java Classes

---

We have two java classes:

1. RecyclerViewAdapter.java
2. MainActivity.java

RecyclerViewAdapter.java

The RecyclerViewAdapter class is for adapting our individual list items to the RecyclerView list.

Notice there's nothing different here as compared to a regular RecyclerView adapter class. There's nothing special you need to do in the adapter to make it "horizontal". All the difference will be in MainActivity.

MainActivity.java

Notice the LinearLayoutManager object with a HORIZONTAL flag in the initRecyclerView method.

That's essentially the only difference between a regular Vertical RecyclerView and a Horizontal RecyclerView.

Internet Permissions

---

Don't forget to add internet permission to the manifest.

Summary

---

Hopefully this helped you integrate a Horizontal RecyclerView into your Android projects.

Staying in the Loop

If you want to stay in the loop and get an email when I write new blog posts, Follow me on Instagram or join the CodingWithMitch community on my website. It only takes about 30 seconds to register.

Authors

---

Mitch Tabian

codingwithmitch.com

Software Dev