Easy to use ListView with pinned sections for Android 2.1 and higher. Pinned section is a header view which sticks to the top of the list until at least one item of that section is visible.
Features
This list properly implements many features which are missing from other implementations. These are
- Fast scroll
- Headers and footers
- Clickable pinned sections
Besides this it doesn't create any unnecessary views, layouts etc. It's really lean.
Watch this video to see PinnedSectionListView in action.
Usage example
- Replace standard
ListViewwithde.halfbit.pinnedsection.PinnedSectionListViewin yourlayout.xmlfile.
<de.halfbit.pinnedsection.PinnedSectionListView
android:id="@android:id/list"
android:layout_width="match_parent"
android:layout_height="wrap_content"
/>
- Extend your
ListAdapterin a way that it implementsPinnedSectionListAdapterinterface, in addition to what it already implements. Basically you need to add a singleisItemViewTypePinned(int viewType)method. This method must returntruefor all view types which have to be pinned.
// Our adapter class implements 'PinnedSectionListAdapter' interface
class MyPinnedSectionListAdapter extends BaseAdapter
implements PinnedSectionListAdapter {
...
// We implement this method to return 'true' for all view types we want to pin
@Override
public boolean isItemViewTypePinned(int viewType) {
return viewType == <type to be pinned>;
}
}
That's all. You are done! A working example can also be found in example folder.
Use with Gradle
Add this to your module-level build.gradle:
dependencies {
compile "de.halfbit:pinned-section-listview:1.0.0"
}
Used by
Let us know if you use this library in your application and we will mention it here.
License
Copyright 2013-2016 Sergej Shafarenka, halfbit.de
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.
722 Nov 10, 2022
762 Nov 23, 2022
187 Dec 22, 2022
2.3k Dec 26, 2022
1.1k Nov 10, 2022
639 Nov 17, 2022
851 Dec 3, 2022
447 Nov 15, 2022
446 Nov 20, 2022
461 Nov 11, 2022
314 Nov 10, 2022
164 Nov 28, 2022
191 Nov 25, 2022
5 Sep 9, 2022
3.5k Dec 16, 2022
52 Nov 1, 2022
9.6k Dec 30, 2022
5.5k Jan 5, 2023