Android Horizontal ListView

Due popularity, I have decided to create a GitHub repo for this project. Please checkout the code at: Pull requests are welcome! 😉

Licensed under MIT License Copyright (c) 2011 Paul Soucy, (

The Android API seems to be lacking a Horizontal ListView widget. Basically, what I needed was something exactly like the Gallery widget but without the center-locking feature. After much googling (and finding dead ends like this or this), I eventually came to the conclusion that a Horizontal ListView simply did not exist. So I built my own…

My Android Horizontal ListView implementation has the following features:

  • Subclass AdapterView so I can make use of adapters
  • Fast – make use of recycled views when possible
  • Items are clickable – (accepts AdapterView.OnItemClickListener)
  • Scrollable
  • No center-locking
  • Simple – is that so much to ask?

If you find this helpful, let me know, I would love to hear your feedback.

How to use:
Horizontal ListView is ment to be a drop-in replacement for a standard ListView. Here is some quick demo code to get you started:

package; import; import android.os.Bundle; import android.view.LayoutInflater; import android.view.View; import android.view.ViewGroup; import android.widget.BaseAdapter; import android.widget.TextView; import; public class HorizontalListViewDemo extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.listviewdemo); HorizontialListView listview = (HorizontialListView) findViewById(; listview.setAdapter(mAdapter); } private static String[] dataObjects = new String[]{ "Text #1", "Text #2", "Text #3" }; private BaseAdapter mAdapter = new BaseAdapter() { @Override public int getCount() { return dataObjects.length; } @Override public Object getItem(int position) { return null; } @Override public long getItemId(int position) { return 0; } @Override public View getView(int position, View convertView, ViewGroup parent) { View retval = LayoutInflater.from(parent.getContext()).inflate(R.layout.viewitem, null); TextView title = (TextView) retval.findViewById(; title.setText(dataObjects[position]); return retval; } }; }



Download code from GitHub

old download link: [download id=”1″]

adapter.notifyDataSetChanged() now saves position in list instead of starting at begining

Added code to respond to adapter.notifyDataSetChanged()

added mScroller.forceFinished(true); to the onDown function of mOnGesture so the user con stop the scroll on tap.

Paul Soucy

Read more posts by this author.