Home » Android » android – ViewPager offscreen page limit

android – ViewPager offscreen page limit

Posted by: admin April 23, 2020 Leave a comment


Is there a way to bypass the normal behavior of ViewPager and its offscreen page limit?
My ViewPager contains four fragments, each containing a gridview of images. The problem I have is that on instansiation of the ViewPager, two fragments are created, which results in that about 20 images (about 10 per fragment) is downloaded/fetched from catch simultaneously. Is it possible to disable the offscreen page limit?

My goal is to only download images when a fragment is selected, or only when the user is hovering the image. One way to achieve this is to use the onPageSelected listener and set a flag, which tells the GridViewAdapter if it’s allowed to download the image or not.

A second way that I can think of is to set a HoverListener on the ImageView, and only download the image on onHover, but that listener is only available in 4.0 and later.

Is there a better way to achieve this?

How to&Answers:

Is it possible to disable the offscreen page limit?

No. It is already set to the minimum possible value: one page to each side of the viewed page. This is necessary to have the animation effects work — you see parts of two fragments (original and new) at the same time.

My goal is to only download images when a fragment is selected, or only when the user is hovering the image.

Then load your grid with placeholder images, and do not load the real images until the page is changed.

Also, note that “hover” implies some sort of mouse or similar sort of pointer, which is not used on most Android devices.


Simply set the offscreen limit to one.

ViewPager mViewpager = (ViewPager)findView....


My goal is to only download images when a fragment is selected

You can use setUserVisibleHint(boolean isVisibleToUser) callback of the Fragment in your ViewPager.


You can also do this in xml using Android Data Binding:



Handle viewPager.addOnPageChangeListener(new ViewPager.SimpleOnPageChangeListener()

Inside it, remove extra views after position + 1 and before position - 1 using viewPager.removeViewAt(int) (i.e. limit the pager to have only 3 pages loaded: current, previous and next.

Then you should handle destroyItem in the viewpager adapter, recycle()ing the bitmaps in the destroyed view.

public void destroyItem(ViewGroup container, int position, Object object) {
    LinearLayout layout = (LinearLayout) object;
    ((ViewPager) container).removeView(layout);
    ImageView imgDisplay = (ImageView) layout.findViewById(R.id.quranPage);
    Drawable drawable = imgDisplay.getDrawable();
    if (drawable instanceof BitmapDrawable) {
        BitmapDrawable bitmapDrawable = (BitmapDrawable) drawable;
        Bitmap bitmap = bitmapDrawable.getBitmap();
        if (bitmap != null) //when reading page fails, this will be null


To avoid downloading the images without the user actually scrolling to the fragment you can override “setUserVisibilityHint (boolean visibleToUser)” and load your images only if “visibleToUser” becomes true


mViewPager.setOffscreenPageLimit(1); wont give what you want,it will load neighbor fragment if its not load already(it means it will load 2 fragment).

Lets say if you want to load all your fragment(4 fragment) at once, then only use setOffscreenPageLimit(3), else avoid using setOffscreenPageLimit.

I think you cannot change the default behavior of viewpager loading neighbor fragment.