DiscreteScrollView

The library is a RecyclerView-based implementation of a scrollable list, where current item is centered and can be changed using swipes. It is similar to a ViewPager, but you can quickly and painlessly create layout, where views adjacent to the currently selected view are partially or fully visible on the screen.

Gradle

Add this into your dependencies block.

compile 'com.yarolegovich:discrete-scrollview:1.2.0'

Sample

Please see the sample app for examples of library usage.

Wiki

General

The library uses a custom LayoutManager to adjust items' positions on the screen and handle scroll, however it is not exposed to the client code. All public API is accessible through DiscreteScrollView class, which is a simple descendant of RecyclerView.

If you have ever used RecyclerView - you already know how to use this library. One thing to note - you should NOT set LayoutManager.

Usage:

1. Add DiscreteScrollView to your layout either using xml or code:
2. Create your implementation of RecyclerView.Adapter. Refer to the sample for an example, if you don't know how to do it.
3. Set the adapter.
4. You are done!

<com.yarolegovich.discretescrollview.DiscreteScrollView
android:id="@+id/picker"android:layout_width="match_parent"android:layout_height="wrap_content"app:dsv_orientation="horizontal|vertical" /> <!-- orientation is optional, default is horizontal -->

DiscreteScrollViewscrollView = findViewById(R.id.picker);
scrollView.setAdapter(newYourAdapterImplementation());

API

Layout

scrollView.setOrientation(Orientationo); //Sets an orientation of the viewscrollView.setOffscreenItems(count); //Reserve extra space equal to (childSize * count) on each side of the view

Related to the current item:

scrollView.getCurrentItem(); //returns adapter position of the currently selected item or -1 if adapter is empty.scrollView.scrollToPosition(intposition); //position becomes selectedscrollView.smoothScrollToPosition(intposition); //position becomes selected with animated scrollscrollView.setItemTransitionTimeMillis(intmillis); //determines how much time it takes to change the item on fling, settle or smoothScroll

Transformations

One useful feature of ViewPager is page transformations. It allows you, for example, to create carousel effect. DiscreteScrollView also supports page transformations.

scrollView.setItemTransformer(transformer);
publicinterfaceDiscreteScrollItemTransformer {
/** * In this method you apply any transform you can imagine (perfomance is not guaranteed). * @param position is a value inside the interval [-1f..1f]. In idle state: * |view1| |currentlySelectedView| |view2| * -view1 and everything to the left is on position -1; * -currentlySelectedView is on position 0; * -view2 and everything to the right is on position 1. */voidtransformItem(Viewitem, floatposition); }

Because scale transformation is the most common, I included a helper class - ScaleTransformer, here is how to use it:

cityPicker.setItemTransformer(newScaleTransformer.Builder()
.setMaxScale(1.05f) .setMinScale(0.8f) .setPivotX(Pivot.X.CENTER) // CENTER is a default one
.setPivotY(Pivot.Y.BOTTOM) // CENTER is a default one
.build());

You may see how it works on GIFs.

Infinite scroll

Infinite scroll is implemented on the adapter level:

InfiniteScrollAdapterwrapper = InfiniteScrollAdapter.wrap(yourAdapter);
scrollView.setAdapter(wrapper);

An instance of InfiniteScrollAdapter has the following useful methods:

intgetRealItemCount();
intgetRealCurrentPosition();
intgetRealPosition(intposition);
/* * You will probably want this method in the following use case: * int targetAdapterPosition = wrapper.getClosestPosition(targetPosition); * scrollView.smoothScrollTo(targetAdapterPosition); * To scroll the data set for the least required amount to reach targetPosition. */intgetClosestPosition(intposition); 

Currently InfiniteScrollAdapter handles data set changes inefficiently, so your contributions are welcome.

Callbacks

• Scroll state changes:

scrollView.addScrollStateChangeListener(listener);
scrollView.removeScrollStateChangeListener(listener);
publicinterfaceScrollStateChangeListener<TextendsViewHolder> {
voidonScrollStart(TcurrentItemHolder, intadapterPosition); //called when scroll is started, including programatically initiated scrollvoidonScrollEnd(TcurrentItemHolder, intadapterPosition); //called when scroll ends/** * Called when scroll is in progress.  * @param scrollPosition is a value inside the interval [-1f..1f], it corresponds to the position of currentlySelectedView. * In idle state: * |view1| |currentlySelectedView| |view2| * -view1 is on position -1; * -currentlySelectedView is on position 0; * -view2 is on position 1. * @param currentHolder - ViewHolder of a current view * @param newCurrent - ViewHolder of a view that moved closer to the center */voidonScroll(floatscrollPosition, @NonNullTcurrentHolder, @NonNullTnewCurrentHolder); }

• Scroll:

scrollView.addScrollListener(listener);
scrollView.removeScrollListener(listener);
publicinterfaceScrollListener<TextendsViewHolder> {
//The same as ScrollStateChangeListener, but for the cases when you are interested only in onScroll()voidonScroll(floatscrollPosition, @NonNullTcurrentHolder, @NonNullTnewCurrentHolder);
}

• Current selection changes:

scrollView.addOnItemChangedListener(listener);
scrollView.removeOnItemChangedListener(listener);
publicinterfaceOnItemChangedListener<TextendsViewHolder> {
/** * Called when new item is selected. It is similar to the onScrollEnd of ScrollStateChangeListener, except that it is  * also called when currently selected item appears on the screen for the first time. * viewHolder will be null, if data set becomes empty  */voidonCurrentItemChanged(@NullableTviewHolder, intadapterPosition); }

Special thanks

Thanks to Tayisiya Yurkiv for sample app design and beautiful GIFs.

License

Copyright 2017 Yaroslav Shevchuk
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.