DEV Community

Cover image for Flutter scrollable horizontal avatar list
Chris Bongers
Chris Bongers

Posted on • Originally published at daily-dev-tips.com

Flutter scrollable horizontal avatar list

In this article, you'll learn how to create a scrollable horizontal list, in our case filled with avatars.

However, feel free to put whatever you want on this list.
The result for today will look like this:

Flutter scrollable horizontal avatar list

For this article, we'll be starting from our basic Flutter application, which you can download on GitHub as well.

Render avatars in Flutter

Let's first start by rendering avatars in Flutter, as this will be the basis of our application.

Usually, we would be able to use a CircleAvatar widget in Flutter. I want to include a border around the widget for my version, so I'm using a container to wrap everything.

return Center(
  child: Container(
    width: 120.0,
    height: 120.0,
    padding: EdgeInsets.all(2),
    decoration: BoxDecoration(
      shape: BoxShape.circle,
      color: Colors.black,
    ),
    child: CircleAvatar(
      backgroundImage: NetworkImage('{YOUR_IMAGE}'),
    ),
  ),
);
Enter fullscreen mode Exit fullscreen mode

And with this, we get a circle image with a black border around it.

Flutter circle avatar

The last thing I'll do here is extracting this to be its very own widget so we can easily re-use it.
I use Visual Studio to extract this into its own widget resulting in the following code:

class SampleAvatar extends StatelessWidget {
  const SampleAvatar({
    Key? key,
  }) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Container(
      width: 120.0,
      height: 120.0,
      padding: EdgeInsets.all(2),
      decoration: BoxDecoration(
        shape: BoxShape.circle,
        color: Colors.black,
      ),
      child: CircleAvatar(
        backgroundImage: NetworkImage(
            'https://media-exp1.licdn.com/dms/image/C4D03AQFgZBilNtPUMA/profile-displayphoto-shrink_800_800/0/1604728137407?e=1632960000&v=beta&t=QKa1Nq3WKWQGEGaiKdZ1ovp1h6uAbwPZfihdqY2_pNU'),
      ),
    );
  }
}
Enter fullscreen mode Exit fullscreen mode

Making it easy for us to use like so:

SampleAvatar()
Enter fullscreen mode Exit fullscreen mode

Creating a horizontally scrollable list view in Flutter

Now that we have our sample avatar widget, let's go ahead and see how we can make a horizontally scrollable list including them.

return Container(
  margin: EdgeInsets.all(10.0),
  height: 140.0,
  child: ListView.separated(
    itemCount: 10,
    separatorBuilder: (BuildContext context, int index) {
      return SizedBox(
        width: 10,
      );
    },
    itemBuilder: (_, i) => SampleAvatar(),
    scrollDirection: Axis.horizontal,
  ),
);
Enter fullscreen mode Exit fullscreen mode

This code creates a container so we can add some margin and height to our scrollable list.
Inside, we render the ListView. I choose to use the separated one since we want some space between each item.

Then inside, we render each of our sample avatars.
And the most important part, we define the scrollDirection as Axis.horizontal making it scroll horizontally.

And that's all we need to create a horizontally scrollable list in Flutter.

If you are looking for the complete code for either our avatar widget or the full list view, you can find it on GitHub.

Thank you for reading, and let's connect!

Thank you for reading my blog. Feel free to subscribe to my email newsletter and connect on Facebook or Twitter

Top comments (0)