takusemba/multisnaprecyclerview

Android library for multiple snapping of RecyclerView

MultiSnapRecyclerView

Gradle

dependencies {
    implementation 'com.github.takusemba:multisnaprecyclerview:x.x.x'
}

Features

This is an Android Library for multiple snapping of RecyclerView. MultiSnapRecyclerView easily provides a snapping feature to your recycler view. What this does are clean, neat, and powerful.

• gravitated snapping to start end and center.
• snap count to specify the number of items to scroll over.
• supports horizontal and vertical scrolling.
• listener to be called when snapped.
• sample code.
• support reverse layout.

Make sure to use LinearManger. Other managers are not supported.

Usage

There are two ways to use MultiSnapRecyclerView.

You can either use MultiSnapRecyclerView in your layout.

<com.takusemba.multisnaprecyclerview.MultiSnapRecyclerView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:msrv_gravity="start" or center, end
        app:msrv_interval="2" items to scroll over
        app:msrv_ms_per_inch="100" /> // speed of scrolling through.

Or you can simply attach MultiSnapHelper to your normal RecyclerView.

val multiSnapHelper = MultiSnapHelper(gravity, interval, speedMsPerInch)
multiSnapHelper.attachToRecyclerView(recyclerView)

Sample

Clone this repo and check out the app module.

Author

• Taku Semba
  • Github - (https://github.com/takusemba)
  • Twitter - (https://twitter.com/takusemba)
  • Facebook - (https://www.facebook.com/takusemba)

Licence

Copyright 2017 Taku Semba.

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.

multisnaprecyclerview's Issues

it is not available to set item which i want to set in center

i set app:msrv_gravity="center",how can i set any item to "center" or use the code to let it scroll to next item?can u help me

How to center the visible items afte snapping/

I have a requirement where I need to center the items shown to the user, is that applicable?

Alternatives to msrv_speed_ms_per_inch

Hello and thank you for your library, it helped me a lot! However, I found an issue in your implementation.
In fact there are two issues in one:

1. ms/inch is not a speed, it's inversion of speed, so the word "speed" in the attribute name is very confusing;
2. It would be better to have some alternative attribute to define constant snap time.

I'll explain the second issue as it is more important.
If you swipe your recyclerview on a small screen in portrait mode with (for example) msrv_speed_ms_per_inch=50, it will change the page pretty fast. But if you'll try it on a bigger device (on a tablet), it will scroll really slow, because it has a larger surface and it takes more time to reach target point.

Instead, it would be better to declare a constant time for snap helper, that will be equally fast on both devices.

java.lang.IllegalArgumentException: other than LinearLayoutManger is not supported

use MultiSnapRecyclerView in a RecyclerView item

                MultiSnapRecyclerView snapRecyclerView = null;
                SkipAppAdapter appAdapter = new SkipAppAdapter(snapRecyclerView, data.getFastInDataBean());
                snapRecyclerView = holder.getView(R.id.snapRecycleView);
                LinearLayoutManager layoutManager = new LinearLayoutManager(getContext(), LinearLayoutManager.HORIZONTAL, false);
                snapRecyclerView.setLayoutManager(layoutManager);
                snapRecyclerView.setAdapter(appAdapter);

                snapRecyclerView.setOnSnapListener(new OnSnapListener() {
                    @Override
                    public void snapped() {
                        // do something
                    }
                });

Set snapGravity programmatically

Currently, there is no way to set it programmatically. You can only do it in XML.

Backward scrolling sometimes snaps twice

I have a horizontal MultiSnapRV, my XML code:

<com.takusemba.multisnaprecyclerview.MultiSnapRecyclerView
        android:id="@+id/rv_weeks"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        app:msrv_gravity="start"
        app:msrv_snap_count="7" />

When I scroll it forward, it works amazing and smooth. But if I scroll backward, sometimes it scrolls 14 positions, not 7. Is it bug or I missed something?

Hi, thank you for the request.

Hi, thank you for the request.

I'm just wondering if recyclerView.smoothScrollToPosition(position) does not work for your case?
It would be helpful if you could give me a situation you want to scroll with `SnapHelpe

Snap Programatically

hey!
is it possible to snap to a particular position of the list?

e.g. something like rvLevels.scroolToPostion(postion);

>for me

Shell or other controller

Originally posted by @Richiejames32 in #29 (comment)

RecyclerView scrolling is too slow.

Hi TakuSemba,

After attaching your code the recycler scroll works too slow.
Either it's just scroll to msrv_snap_count or if we define higher value then it skips all the items.

mLayout is null

When running the app, it throws "java.lang.IllegalArgumentException: other than LinearLayoutManger is not supported" being that at onAttachedToWindow, mLayout is null therefore is not an instance of LinearLayoutManager.

So what's happening here?

Richiejack32

Not able to show last item with gravity start

I found a bug where the list is preventing the last item to be shown when app:msrv_gravity="start" is set.

Screen recording of issue with library's sample app:
end not snapping with gravity start normal font.mp4.zip

Phone: OnePlus One
Android Version: 6.0.1

Edit
Apparently this happens to first item when app:msrv_gravity="start" is set with app:msrv_interval="2"

The rolling speed is too slow, can you adjust the rolling speed?

Version 1.1.0 released, but code here shows it's 1.0.3

This repository seems to not be up to date with what has been released.

How to get the middle value

Hey, Your did a good work. I want to know, how to get the middle value of the adapter programmatically.

Any idea how to handle screen orientation?

Gravity: Center
Snap Count: 1
Orientation: Vertical
Portrait: showing multiple items depends on the item height
Landscape: showing one item in fullscreen
I did recycler_view.scrollToPosition() in onConfigurationChanged.
Portrait -> Landscape is working fine
Landscape -> Portrait: the item is in top, instead of center, until you scroll again

snap last item with ItemDecoration

It was able to snap last item at v1.3.4, however after upgrading to v2.0.1 it will bounce back to the previous item rather than focus on the last item.

Snap to the clicked item of RecyclerView

Hi,

One more enhancement, if we click on any item of the RecyclerView then snap the selected position.

I.e. we can snap via two modes, one by touching the item or by scrolling to it.

A warning appear.

A warning appears when i swipe from the recyclerview.
The test machine is the Nexus 5x android 7.0 version api 24.
Can I ignore it?

E/RecyclerView: Smooth Scroll action is being updated too frequently. Make sure you are not changing it unless necessary

New Feature as requirement

Hi,
Can you disable multiple scrolling of items...?

Import library issue

sorry, I forgot to upload jar to jCenter.
for now, you have to use this library importing through my maven repository like this

// set marven url
repositories {
  maven { url 'https://dl.bintray.com/takusemba/maven' }
}

// compile library in dependencies
dependencies {
    compile 'com.github.takusemba:multisnaprecyclerview:x.x.x'
}

Im adding this to jCenter now. After few hours you can import this library just like this below

dependencies {
    compile 'com.github.takusemba:multisnaprecyclerview:x.x.x'
}

Is it possible to snap every X views?

For example, suppose I have tens of views to scroll through. If the user scrolled x/2 and a bit more, it will get to the X view.

The application may be doing too much work on its main thread.

The application may be doing too much work on its main thread. When I am scrolling back. It was crashed.

It's not available to fragment?

It's alway report "other than LinearLayoutManger is not supported"