Skip to content

TakuSemba/MultiSnapRecyclerView

Repository files navigation

MultiSnapRecyclerView

Gradle

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

Features

Build Status Download License API

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

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.