SuperSLiM is a configurable layout manager for the RecyclerView. It provides a vertical scrolling list of sections. Each section may have a header, and can have its own unique layout. The section layouts can be one of the provided layouts, or can be of your own creation.
SuperSLiM also has a maintained wiki with guides and documentation to help you out.
Feature Overview
Section Headers
- Sticky headers
- Material design headers
- Header overlays
Section Layouts
- Linear (like ListView)
- Grid (like GridView)
- Staggered Grid - not yet implemented
- or create your own
Support for RTL languages
See the Roadmap for more details and future development.
How do I get it?
Add the following to your build.gradle file.
dependencies {
compile 'com.tonicartos:superslim:+'
}+ is a wildcard, the latest version is displayed in the maven badge at the top of this page.
How do I use it?
Read the Getting Started wiki page for easy to follow instructions.
SuperSLiM is documented in the wiki so you can easily get stuck in.
Support
- Wiki
- Google+ Community
- Stack Overflow (Please tag questions with superslim).
Samples
Included in the repository.
Acknowledgements
Android Arsenal for its indexing of third party libraries.
Thanks to Dave Smith for his introduction to writing a RecyclerView LayoutManager over at Wires are Obsolete, and to Lucas Rocha for his TwoWayView Library which is worth checking out too.
License
Copyright (C) 2014, 2015 Tonic Artos
SuperSLiM is largely original with some pieces from from Lucas Rocha's
TwoWayView Library and the AOSP.
Copyright (C) 2014 Lucas Rocha
Copyright (C) 2014 The Android Open Source Project
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.