/MultiSnapRecyclerView

Android library for multiple snapping of RecyclerView

Primary LanguageJavaApache License 2.0Apache-2.0

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.