/InfiniteCycleViewPager

Infinite cycle ViewPager with two-way orientation and interactive effect.

Primary LanguageJavaApache License 2.0Apache-2.0

InfiniteCycleViewPager

Infinite cycle ViewPager with two-way orientation and interactive effect.

DevLight

Android Arsenal Android Download Crates.io Codacy Badge

U can check the sample app here.

Download

You can download a .aar from GitHub's releases page.

Or use Gradle:

compile 'com.github.devlight:infinitecycleviewpager:1.0.0'

Or Maven:

<dependency>
  <groupId>com.github.devlight</groupId>
  <artifactId>infinitecycleviewpager</artifactId>
  <version>1.0.0</version>
  <type>pom</type>
</dependency>

Or Ivy:

<dependency org='com.github.devlight' name='infinitecycleviewpager' rev='1.0.0'>
  <artifact name='$AID' ext='pom'></artifact>
</dependency>

Android SDK Version

InfiniteCycleViewPager requires a minimum SDK version of 11.

Sample

Parameters

For InfiniteCycleViewPager you can set such parameters as:

  • min scale:

    allows you to set the minimum scale of left and right bottom pages.

  • max scale:

    allows you to set the maximum scale of center top page.

  • min scale offset:

    allows you to set offset from edge to minimum scaled pages.

  • center scale offset:

    allows you to set offset from center when two pages appears.

  • model selected icon:

    allows you to set selected icon when current model is active.

  • medium scaled:

    allows you to set is scaling would be min -> max or min -> medium -> max.

  • scroll duration:

    allows you to set snap scrolling duration.

  • scroll interpolator:

    allows you to set snap scrolling interpolator.

  • page transform listener:

    allows you to set page transform listener.

Tips

Two-way widget need a lot of memory.

Infinite scroll available when item count more then 2.

You can set vertical or horizontal infinite cycle ViewPager.

Init

Check out in code init:

//      final VerticalInfiniteCycleViewPager infiniteCycleViewPager =
//                (VerticalInfiniteCycleViewPager) view.findViewById(R.id.vicvp);
        final HorizontalInfiniteCycleViewPager infiniteCycleViewPager =
                (HorizontalInfiniteCycleViewPager) view.findViewById(R.id.hicvp);
        infiniteCycleViewPager.setAdapter(...);
        infiniteCycleViewPager.setScrollDuration(500);
        infiniteCycleViewPager.setInterpolator(...);
        infiniteCycleViewPager.setMediumScaled(true);
        infiniteCycleViewPager.setMaxPageScale(0.8F);
        infiniteCycleViewPager.setMinPageScale(0.5F);
        infiniteCycleViewPager.setCenterPageScaleOffset(30.0F);
        infiniteCycleViewPager.setMinPageScaleOffset(5.0F);
        infiniteCycleViewPager.setOnInfiniteCyclePageTransformListener(...);

If you want to get item position just call this method:

infiniteCycleViewPager.getRealItem();

To update your ViewPager after some adapter update or else, you can call this method:

infiniteCycleViewPager.notifyDataSetChanged();

Other methods check out in sample.

And XML init:

<!--<com.gigamole.infinitecycleviewpager.VerticalInfiniteCycleViewPager-->
<com.gigamole.infinitecycleviewpager.HorizontalInfiniteCycleViewPager
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:icvp_interpolator="..."
    app:icvp_center_page_scale_offset="30dp"
    app:icvp_max_page_scale="0.8"
    app:icvp_medium_scaled="true"
    app:icvp_min_page_scale="0.5"
    app:icvp_min_page_scale_offset="5dp"
    app:icvp_scroll_duration="500"/>

Getting Help

To report a specific problem or feature request, open a new issue on Github.

License

Apache 2.0 and MIT. See LICENSE file for details.

Inspiration

Author

Made in DevLight Mobile Agency

Created by Basil Miller - @gigamole

Support

If you'd like to support future development and new product features, please make a payments on Gratipay and Beerpay or become a patron on Patreon.

Gratipay Beerpay Patreon

Also, if you use this library in applications that are available on Google Play, please report it to us or author.

Thanks in advance.