Skip to content

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

License

Notifications You must be signed in to change notification settings

Nammari/InfiniteCycleViewPager

 
 

Repository files navigation

InfiniteCycleViewPager

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

DevLight

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 your want to get item position just call this metho:

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.

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 100.0%