Android library for multiple snapping of RecyclerView
Switch branches/tags
Nothing to show
Clone or download
Latest commit 7425c78 Jul 13, 2018
Permalink
Failed to load latest commit information.
app fix snap count Feb 13, 2018
arts Add files via upload Aug 4, 2017
gradle/wrapper version up Aug 12, 2017
multisnaprecyclerview bug fix Feb 13, 2018
.gitignore fix gitigrore Feb 28, 2018
LICENSE Initial commit Aug 1, 2017
README.md Update README.md Jul 13, 2018
build.gradle version up Aug 12, 2017
gradle.properties version up Feb 13, 2018
gradlew version up Aug 12, 2017
gradlew.bat version up Aug 12, 2017
local.properties fix gitigrore Feb 28, 2018
settings.gradle Initial commit Aug 1, 2017

README.md

MultiSnapRecyclerView

Gradle

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

Features

Platform 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.
  • test code.

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





Usage

Use MultiSnapRecyclerView in your xml file.

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

and simply set a layout manager.

LinearLayoutManager layoutManager = new LinearLayoutManager(this);
multiSnapRecyclerView.setLayoutManager(layoutManager);
multiSnapRecyclerView.setAdapter(adapter);
multiSnapRecyclerView.setOnSnapListener(new OnSnapListener() {
    @Override
    public void snapped(int position) {
        // do something with the position of the snapped view
    }
});


Sample

Clone this repo and check out the app module.

Change Log

Version: 1.2.0

  • control of speed when scrolling through

Version: 1.1.0

  • return snapped position in OnSnapListener

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.