EpsilonOrionis / UltimateRecyclerView

A RecyclerView(advanced and flexible version of ListView) with refreshing,loading more,animation and many other features.

UltimateRecyclerView

###Version:0.3.0

####Master branch:

####Dev branch:

#####Project website:UltimateRecyclerView

###Description UltimateRecyclerView is a RecyclerView(advanced and flexible version of ListView) with pulling to refresh, loading more, swiping to dismiss, draging and drop, animations ,show or hide toolbar and FAB when scrolling and many other features.You can use it just like RecyclerView.

Notice that UltimateRecyclerView is a project under development.

###Features:

• Swipe to refresh(using android.support.v4.widget.SwipeRefreshLayout)
• Many kinds of animations
• Swipe to dismiss
• Parallax head view
• Drag and drop
• Loading more when reach the last item(infinite scrolling)
• Custom views in loading more
• Showing or hiding toolbar and floating button when scrolling

###Changes in 0.3.0:

• add a empty view when the adapter do not have data
• add some colorful styles of swipe to refresh
• add swapAdapter() ,getAdapter() etc.
• Custom FAB style
• add support for scrollbars of RecyclerView

###Upcoming features:

• More animations
• Add sticky header like instagram
• ...

Upcoming changes in UltiamteRecyclerview 0.4.0:

If you have some good idea, please tell us.My email is cymcsg # gmail.com.And it is a good idea to put your idea on the issue.

####Welcome to fork and pull request.

###If you want to use a rapid development framework for developing apps,you can try UltimateAndroid Framework.

###Screenshot

###Sample

You can clone the project and compile it yourself (it includes a sample), or you can check it out already compiled at Google Play

Notice that it might not be the latest version

###Quick Setup（Basic Usage） ######1.Integration

repositories {
        jcenter()
    }
dependencies {
    ...
    compile 'com.marshalchen.ultimaterecyclerview:library:0.3.0'
}

#####2.Usage:

<com.marshalchen.ultimaterecyclerview.UltimateRecyclerView
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:id="@+id/ultimate_recycler_view"
        app:recyclerviewClipToPadding="true"
        app:recyclerviewPadding="2dp">
        </com.marshalchen.ultimaterecyclerview.UltimateRecyclerView>

#####3.Features:
Loading more:

  ultimateRecyclerView.enableLoadmore();

Set ParallaxHeader:

 ultimateRecyclerView.setParallaxHeader(getLayoutInflater().inflate(R.layout.parallax_recyclerview_header, ultimateRecyclerView.mRecyclerView, false));
        ultimateRecyclerView.setOnParallaxScroll(new UltimateRecyclerView.OnParallaxScroll() {
            @Override
            public void onParallaxScroll(float percentage, float offset, View parallax) {
                Drawable c = toolbar.getBackground();
                c.setAlpha(Math.round(127 + percentage * 128));
                toolbar.setBackgroundDrawable(c);
            }
        });

Set swipe to refresh:

 ultimateRecyclerView.setOnRefreshListener(new SwipeRefreshLayout.OnRefreshListener() {
            @Override
            public void onRefresh() {
                new Handler().postDelayed(new Runnable() {
                    @Override
                    public void run() {
                        simpleRecyclerViewAdapter.insert("Refresh things", 0);
                        ultimateRecyclerView.setRefreshing(false);
                        //   ultimateRecyclerView.scrollBy(0, -50);
                        linearLayoutManager.scrollToPosition(0);
                    }
                }, 1000);
            }
        });

Set swipe to dismiss:

  ultimateRecyclerView.setSwipeToDismissCallback(new SwipeToDismissTouchListener.DismissCallbacks() {
            @Override
            public SwipeToDismissTouchListener.SwipeDirection dismissDirection(int position) {
                return SwipeToDismissTouchListener.SwipeDirection.BOTH;
            }
            @Override
            public void onDismiss(RecyclerView view, List<SwipeToDismissTouchListener.PendingDismissData> dismissData) {
                for (SwipeToDismissTouchListener.PendingDismissData data : dismissData) {
                    simpleRecyclerViewAdapter.remove(data.position);
                }
            }
            @Override
            public void onResetMotion() {
                isDrag = true;
            }
            @Override
            public void onTouchDown() {
                isDrag = false;
            }
        });

Drag and drop:

   dragDropTouchListener = new DragDropTouchListener(ultimateRecyclerView.mRecyclerView, this) {
           @Override
           protected void onItemSwitch(RecyclerView recyclerView, int from, int to) {
               simpleRecyclerViewAdapter.swapPositions(from, to);
               simpleRecyclerViewAdapter.clearSelection(from);
               simpleRecyclerViewAdapter.notifyItemChanged(to);
               if (actionMode != null) actionMode.finish();
               Logs.d("switch----");
           }
           @Override
           protected void onItemDrop(RecyclerView recyclerView, int position) {
               Logs.d("drop----");
               ultimateRecyclerView.enableSwipeRefresh(true);
           }
       };
       dragDropTouchListener.setCustomDragHighlight(getResources().getDrawable(R.drawable.custom_drag_frame));
       ultimateRecyclerView.mRecyclerView.addOnItemTouchListener(dragDropTouchListener);

Animations:

  ultimateRecyclerView.setItemAnimator(Type.values()[position].getAnimator());
  ultimateRecyclerView.getItemAnimator().setAddDuration(300);
  ultimateRecyclerView.getItemAnimator().setRemoveDuration(300);

Showing and hiding toolbar and floating button:

  ultimateRecyclerView.setScrollViewCallbacks(new ObservableScrollViewCallbacks() {
            @Override
            public void onScrollChanged(int scrollY, boolean firstScroll, boolean dragging) {           
             }
            @Override
            public void onDownMotionEvent() {
            }
            @Override
            public void onUpOrCancelMotionEvent(ObservableScrollState observableScrollState) {
                if (observableScrollState == ObservableScrollState.DOWN) {
                     ultimateRecyclerView.showToolbar(toolbar, ultimateRecyclerView,getScreenHeight());
                } else if (observableScrollState == ObservableScrollState.UP) {
                      ultimateRecyclerView.hideToolbar(toolbar,ultimateRecyclerView,getScreenHeight());
                } else if (observableScrollState == ObservableScrollState.STOP) {
                }
            }
        });        

Show empty view when the adapter is null:

<com.marshalchen.ultimaterecyclerview.UltimateRecyclerView
...
app:recyclerviewEmptyView="@layout/empty_view"/>

Show custom FloatingView(Both menu and button are fine. It is easy to set click event on them) when the adapter is null:

<com.marshalchen.ultimaterecyclerview.UltimateRecyclerView
...
 app:recyclerviewFloatingActionView="@layout/floating_view"/>

Set custom colorful style of pull to refresh:

 <com.marshalchen.ultimaterecyclerview.CustomUltimateRecyclerview
 .../>

Using CustomUltimateRecyclerview instead of UltimateRecyclerView ultimateRecyclerView.setCustomSwipeToRefresh();

Set scrollbars of RecyclerView by set attributes of UltimateRecyclerView in xml layout:

<com.marshalchen.ultimaterecyclerview.UltimateRecyclerView
        app:recyclerviewScrollbars="vertical" />                

Note that set scrollbars of RecyclerView dynamically by code is NOT SUPPORTED refer to this

####If you want to see more details,you can check the demo.

###Thanks

• Use animators from recyclerview-animators
• Deal with different types of LayoutManager fromSuperRecyclerView
• Divider of recyclerviewRecyclerView-FlexibleDivider
• Another kind of swipeScrollableItemList
• Parallax header of the recyclerviewandroid-parallax-recyclerview
• Swipe to dismiss and drag dropDynamicRecyclerView
• Floating action button FloatingActionButton
• Colorful pull to refresh Ultra Pull To Refresh

If there are someone who I do not mention here,please accept my sincerely appologies and tell me.

License

Copyright 2015 Marshal Chen

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.