Android: putting a ViewPager inside a ListView


So, I’ve been Googling for a while to find a clean, reasonable approach for putting a ViewPager inside of a ListView (or any vertically scrolling element). The problem with putting a ViewPager inside a ListView is that it takes only a small amount of vertical (Y) delta before the ListView begins to consume touch events instead of delegating to the child in order to enable the scrolling of the ListView. That’s fine, but the problem often occurs after the ViewPager has already started processing a page change (when dragging horizontally), producing a poor user experience resulting in the improper pagination and scrolling of the two views.

There are a few ways to try to handle this.

  1. You could not do it at all (thanks Dianne and Mark)
  2. You can set a touch listener on the ListView and try to delegate the touches based on which view you think needs to get the touches and what actions need to occur based on those touches.
  3. You can also combine a touch listener with GestureDetector to try to make the implementation a little less cumbersome. The problem is that in some ListViews, our layouts are a little more complex than single item rows of text. If the item layout has for instance a Button, we’d then need to properly delegate the touch event down to the Button. This obviously has huge ramifications for implementation and testing.

In order to avoid the aforementioned shenanigans, I added an OnPageChangeListener to the ViewPager and based on the state of the pager, forced a touch delegate from the Activity.

Contrived example:

class MyActivity extends Activity {
    private ViewPager mViewPager;
    private View mTouchTarget;

    protected void onCreate(Bundle icicle) {

        mViewPager = (ViewPager) findViewById(;

        mViewPager.setOnPageChangeListener(new OnPageChangeListener() {

            private int mPreviousState = ViewPager.SCROLL_STATE_IDLE;

            public void onPageSelected(int position) {
                // NO-OP

            public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
                // NO-OP

            public void onPageScrollStateChanged(int state) {
                // All of this is to inhibit any scrollable container from consuming our touch events as the user is changing pages
                if (mPreviousState == ViewPager.SCROLL_STATE_IDLE) {
                    if (state == ViewPager.SCROLL_STATE_DRAGGING) {
                        mTouchTarget = mViewPager;
                } else {
                    if (state == ViewPager.SCROLL_STATE_IDLE || state == ViewPager.SCROLL_STATE_SETTLING) {
                        mTouchTarget = null;

                mPreviousState = state;

    public boolean dispatchTouchEvent(MotionEvent ev) {
        if (mTouchTarget != null) {
            boolean wasProcessed = mTouchTarget.onTouchEvent(ev);

            if (!wasProcessed) {
                mTouchTarget = null;

            return wasProcessed;

        return super.dispatchTouchEvent(ev);

Now, we have a ViewPager that retains control of touch events once the page starts changing and releases it when paging is idle or settling.

6 thoughts on “Android: putting a ViewPager inside a ListView

  1. Would you recommend doing any kind of graphical representation of the state lock out during the scrolling? Not that I would expect users to (NOT) want to try to push a button while the content is scrolling past their fingers, but if there’s any kind of event delay, I can see a possible inconsistency with the UI’s ability to accept a touch call and its visual representation.

    • Dallas Gutauckis

      The state lock (touch lock) is only enabled while the user is still touching/pointing the view. To press a button or other view means that the user would have to lift his finger and press again, at which point the touch delegating would no longer occur, thereby allowing the user to press the appropriate view. The reason for the touch lock is to prevent the ListView from consuming touch events when it starts to see vertical movement while touching the inner (ViewPager) view.

      So, no, I don’t think a visual indication is needed for this touch lock.

  2. sc

    I try to put viewpager in listview, but only the first viewpager is shown. Other viewpagers are blank.

    when i scroll down and back to the top, the first viewpager disappear too.

    Do you have any idea how to put viewpager in every listview row?

    holder.pager = (ViewPager) convertView.findViewById(;

    CustomePagerAdapter customPagerAdapter = new CustomePagerAdapter(fragmentManager, data);

  3. Bad example, where is the listView?? The Activity have a listView and the adapter, then the adapter is who controls the viewpagers inside the rows…

Leave a Reply