UltraRecyclerView

中文文档

Project UltraRecyclerView is a RecyclerView extension that encapsulates multiple features.

Screenshots

Main Feature

• support horizontal scrolling and vertical scrolling
• support pager snap. support setting align gravity (start, center and end) and margin
• support switching views circularly. For example, if there are 3 views to display in a RecyclerView, it should switch back to the first view after the third view.
• support auto-scrolling feature，implemented timer with Handler.
• BannerView has a built-in indicator. support setting bottom margin, height, inner margin, and width and color of the selected and default status.

you can combine multiple features at the same time.

Usage

Please find the latest version(1.0.0 so far) in maven repository. The newest version has been upload to jcenter, make sure you have added at least one of these repositories.

Using Gradle:

// gradle
implementation 'com.jimmysun:ultrarecyclerview:1.1.0'

or grab via Maven:

// pom.xml in maven
<dependency>
	<groupId>com.jimmysun</groupId>
	<artifactId>ultrarecyclerview</artifactId>
	<version>1.1.0</version>
	<type>pom</type>
</dependency>

Create your own layout using a UltraRecyclerView:

activity_recycler_view.xml

<com.jimmysun.ultrarecyclerview.UltraRecyclerView
    android:id="@+id/ultra_recycler_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:orientation="vertical"
    app:alignGravity="start"
    app:alignMargin="0dp"
    app:infiniteLoop="true"/>

or using a BannerView:

<com.jimmysun.ultrarecyclerview.BannerView
    android:id="@+id/banner_view"
    android:layout_width="match_parent"
    android:layout_height="150dp"
    app:alignGravity="center"
    app:alignMargin="0dp"
    app:infiniteLoop="true"
    app:indicatorGravity="bottom|center_horizontal"
    app:indicatorBottomMargin="8dp"
    app:indicatorLeftMargin="8dp"
    app:indicatorRightMargin="8dp"
    app:indicatorSelectedColor="#FFFFFFFF"
    app:indicatorDefaultColor="#4D868E9E"
    app:indicatorSelectedWidth="10dp"
    app:indicatorDefaultWidth="10dp"
    app:indicatorHeight="2dp"
    app:indicatorMargin="5dp"
    app:indicatorVisibility="visible"/>

You can follow my tutorial below on how to use UltraRecyclerView:

mUltraRecyclerView = findViewById(R.id.ultra_recycler_view);
// initialize MyAdapter, which extends RecyclerView.Adapter
mUltraRecyclerView.setAdapter(new MyAdapter(RecyclerView.VERTICAL));
// set orientation
mUltraRecyclerView.setOrientation(RecyclerView.VERTICAL);
// set pager snap, including align gravity and margin
mUltraRecyclerView.setPagerSnap(Gravity.START, 0);
// set an infinite loop
mUltraRecyclerView.setInfiniteLoop(true);
// start auto-scroll
mUltraRecyclerView.startAutoScroll(2000);
mUltraRecyclerView.setAutoScrollSpeed(500);

or use BannerView in java:

mBannerView = findViewById(R.id.banner_view);
// initialize MyAdapter, which extends RecyclerView.Adapter
mBannerView.setAdapter(new MyAdapter(RecyclerView.HORIZONTAL));
// set pager snap
mBannerView.setPagerSnap(Gravity.CENTER);
// set an infinite loop
mBannerView.setInfiniteLoop(true);
// set style of indicator
mBannerView.setIndicatorGravity(Gravity.BOTTOM | Gravity.CENTER_HORIZONTAL);
mBannerView.setIndicatorBottomMargin(24);
mBannerView.setIndicatorSelectedColor(Color.GREEN);
mBannerView.setIndicatorDefaultColor(Color.WHITE);

For other API reference,see this to read more.

FAQ

• How to refresh data? you can refresh data by the below method:
  • ultraRecyclerView.refresh();

DEMO

Demo Project

LICENSE

UltraRecyclerView is available under the MIT license.