Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
73 changes: 4 additions & 69 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,70 +1,5 @@
LoopingViewPager
================
###Fix 2 issues:
1. blinking isuue when scrolling from first to last or from last to first;
2. disable scroll when there is only one item.

An android ViewPager extension allowing infinite scrolling.


You can use it with "standart" `PagerAdapter` (inflating the pager with `Views`),
but you can also use `FragmentPagerAdapter` which allows you to fill the pager with `Fragments`!

The ViewPager will actually create 2 additional Views/Fragments to fake the infinite loop.

This ViewPager is fully compatible with [ViewPagerIndicator][1], and [PagerSlidingTabStrip][2]!



Usage
-----

To use it simply change `<android.support.v4.view.ViewPager>` to `<com.imbryk.viewPager.LoopViewPager>`

If your `PagerAdapter` is used only to create `Views` (i.e. you don't use `FragmentPagerAdapter` or `FragmentStatePagerAdapter`),
then no more code changes are needed!


If you want to use `LoopViewPager` with `FragmentPagerAdapter` or `FragmentStatePagerAdapter`
additional changes in the adapter must be done.
The adapter must be prepared to create 2 extra items e.g.:
* The original adapter creates 4 items: `[0,1,2,3]`
* The modified adapter will have to create 6 items `[0,1,2,3,4,5]`
* with mapping `realPosition=(position-1)%count`
* `[0->3, 1->0, 2->1, 3->2, 4->3, 5->0]`


Sometimes "blinking" can be seen when paginating to first or last view (e.g. when you have a `NetworkImageView` in your layout).
To remove this effect, simply call setBoundaryCaching( true ) on your `LoopViewPager`,
or change `DEFAULT_BOUNDARY_CASHING` to true, if you want to set boundary caching
on all `LoopViewPager` instances. This will prevent the first and last element from being destroyed,
and every time they need to be displayed the existing instances will be used.


Sample
------
You can see a sample usage on [ViewPagerIndicator fork][3] (by [Jake Wharton][5])
or on [PagerSlidingTabStrip fork][4] (by [Andreas Stütz][6])

License
=======

Copyright 2013 Leszek Mzyk

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.



[1]: https://github.com/JakeWharton/Android-ViewPagerIndicator
[2]: https://github.com/astuetz/PagerSlidingTabStrip
[3]: https://github.com/imbryk/Android-ViewPagerIndicator/compare/master...loopingViewPager-demo
[4]: https://github.com/imbryk/PagerSlidingTabStrip/compare/master...loopingViewPager-demo
[5]: https://github.com/JakeWharton
[6]: https://github.com/astuetz
##use [LoopViewPager.java](https://github.com/TracyZhangLei/LoopingViewPager/blob/master/src/com/imbryk/viewPager/LoopViewPager.java) for instead
35 changes: 33 additions & 2 deletions src/com/imbryk/viewPager/LoopViewPager.java
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@
import android.support.v4.view.PagerAdapter;
import android.support.v4.view.ViewPager;
import android.util.AttributeSet;
import android.view.MotionEvent;

/**
* A ViewPager subclass enabling infinte scrolling of the viewPager elements
Expand All @@ -42,11 +43,36 @@
*/
public class LoopViewPager extends ViewPager {

private static final boolean DEFAULT_BOUNDARY_CASHING = false;
private static final boolean DEFAULT_BOUNDARY_CASHING = true;

OnPageChangeListener mOuterPageChangeListener;
private LoopPagerAdapterWrapper mAdapter;
private boolean mBoundaryCaching = DEFAULT_BOUNDARY_CASHING;
private boolean isCanScroll = true;

public boolean isCanScroll() {
return isCanScroll;
}

public void setCanScroll(boolean isCanScroll) {
this.isCanScroll = isCanScroll;
}

@Override
public boolean onTouchEvent(MotionEvent ev) {
if(isCanScroll)
return super.onTouchEvent(ev);
else
return false;
}

@Override
public boolean onInterceptTouchEvent(MotionEvent ev) {
if(isCanScroll)
return super.onInterceptTouchEvent(ev);
else
return false;
}


/**
Expand Down Expand Up @@ -84,7 +110,12 @@ public void setAdapter(PagerAdapter adapter) {
mAdapter = new LoopPagerAdapterWrapper(adapter);
mAdapter.setBoundaryCaching(mBoundaryCaching);
super.setAdapter(mAdapter);
setCurrentItem(0, false);
//fix blinking issue when item is scrolling from first to last,cause ViewPager instance item left current right at least,see more at setOffScreenLimit()
setCurrentItem(mAdapter.getRealCount(), false);
//disable scroll when realCount<2
if(mAdapter.getRealCount()<2){
setCanScroll(false);
}
}

@Override
Expand Down