UltraViewPager
ProjectUltraViewPager is a ViewPager extension that encapsulates multiple features, mainly to provide a unified solution for multi-page switching scenarios.
Main Feature
- support horizontal scrolling and vertical scrolling
- support multi views in one viewpager
- support switching views circularly. For example, if there are 3 views to display in a ViewPager, it should switch back to the first view after the third view.
- support auto-scrolling feature，implemented timer with Handler.
- support setting max-height and max-width for this ViewPager.
- support setting the aspect ratio for UltraViewPager.
- UltraViewPager has a built-in indicator. support circle and icon style.
- built-in two kind of page tansition animation.
you can combine multiple features at the same time.
Design
UltraViewPager is a super extension for ViewPager. It's actually a RelativeLayout in order to display ViewPager and Indicator.UltraViewPager offers some common method delegate for ViewPager, you can also invoke more method by call getViewPager() and get the actual ViewPager.
In order to achieve vertical scroll, through exchanging MotionEvent in onInterceptTouchEvent and onTouchEvent.For more details, you can read the source code.
Usage
Please find the latest version(1.0.7.7 so far) in maven repository. The newest version has been upload to jcenter and MavenCantral, make sure you have added at least one of these repositories.
Using Gradle:
//gradle
compile ('com.alibaba.android:ultraviewpager:1.0.7.7@aar') {
transitive = true
}
or grab via Maven:
//pom.xml in maven
<dependency>
<groupId>com.alibaba.android</groupId>
<artifactId>ultraviewpager</artifactId>
<version>1.0.7.7</version>
<type>aar</type>
</dependency>
Create your own layout using a UltraViewPager:
activity_pager.xml
<com.tmall.ultraviewpager.UltraViewPager
android:id="@+id/ultra_viewpager"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_centerInParent="true"
android:background="@android:color/darker_gray" />
You can follow my tutorial below on how to use UltraViewPager:
UltraViewPager ultraViewPager = (UltraViewPager)findViewById(R.id.ultra_viewpager);
ultraViewPager.setScrollMode(UltraViewPager.ScrollMode.HORIZONTAL);
//initialize UltraPagerAdapter，and add child view to UltraViewPager
PagerAdapter adapter = new UltraPagerAdapter(false);
ultraViewPager.setAdapter(adapter);
//initialize built-in indicator
ultraViewPager.initIndicator();
//set style of indicators
ultraViewPager.getIndicator()
.setOrientation(UltraViewPager.Orientation.HORIZONTAL)
.setFocusColor(Color.GREEN)
.setNormalColor(Color.WHITE)
.setRadius((int)TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, 5, getResources().getDisplayMetrics()));
//set the alignment
ultraViewPager.getIndicator().setGravity(Gravity.CENTER_HORIZONTAL | Gravity.BOTTOM);
//construct built-in indicator, and add it to UltraViewPager
ultraViewPager.getIndicator().build();
//set an infinite loop
ultraViewPager.setInfiniteLoop(true);
//enable auto-scroll mode
ultraViewPager.setAutoScroll(2000);
For other API reference,see this to read more.
FAQ
- How to refresh data? you can refresh data by any one below three method:
- ultraViewPager.refresh();
- ultraViewPager.getWrapAdapter().notifyDataSetChanged();
- mViewPager.getViewPager().getAdapter().notifyDataSetChanged();
DEMO
Contributing
Before you open an issue or create a pull request, please read Contributing Guide first.
LICENSE
UltraViewPager is available under the MIT license.
![[寻求帮助]关于刷新无效的问题](https://avatars.githubusercontent.com/u/4349848?v=4)
![[bug] 首页的pagerAdapter内容改变并没有更新banner里的内容](https://avatars.githubusercontent.com/u/14876888?v=4)
1.7k Dec 10, 2022
992 Nov 10, 2022
2.7k Dec 30, 2022
180 Nov 18, 2022
1 Mar 1, 2022
1 Jan 23, 2019
1.8k Dec 13, 2022
2.5k Dec 31, 2022
10.2k Jan 3, 2023
7k Jan 1, 2023
8.2k Dec 29, 2022
2.2k Jan 4, 2023
692 Dec 14, 2022
716 Sep 15, 2022
437 Dec 29, 2022
253 Nov 16, 2022
212 Nov 28, 2022
251 Nov 29, 2022