Pinned section list view

Easy to use list view with pinned sections.

License	The Apache Software License, Version 2.0
GroupId	de.halfbit
ArtifactId	pinned-section-listview
Last Version	1.0.0
Release Date	Aug 20, 2016
Type	aar
Description	Pinned section list view Easy to use list view with pinned sections.
Project URL	https://github.com/beworker/pinned-section-listview/
Source Code Management	https://github.com/beworker/pinned-section-listview/

Download pinned-section-listview

Filename	Size
pinned-section-listview-1.0.0.pom
pinned-section-listview-1.0.0.aar	10 KB
pinned-section-listview-1.0.0-sources.jar	5 KB
pinned-section-listview-1.0.0-javadoc.jar	29 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/de.halfbit/pinned-section-listview/ -->
<dependency>
    <groupId>de.halfbit</groupId>
    <artifactId>pinned-section-listview</artifactId>
    <version>1.0.0</version>
    <type>aar</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/de.halfbit/pinned-section-listview/
implementation 'de.halfbit:pinned-section-listview:1.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/de.halfbit/pinned-section-listview/
implementation ("de.halfbit:pinned-section-listview:1.0.0")

Apache Buildr

'de.halfbit:pinned-section-listview:aar:1.0.0'

Apache Ivy

<dependency org="de.halfbit" name="pinned-section-listview" rev="1.0.0">
  <artifact name="pinned-section-listview" type="aar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='de.halfbit', module='pinned-section-listview', version='1.0.0')
)

Scala SBT

libraryDependencies += "de.halfbit" % "pinned-section-listview" % "1.0.0"

Leiningen

[de.halfbit/pinned-section-listview "1.0.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

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

1. Replace standard ListView with de.halfbit.pinnedsection.PinnedSectionListView in your layout.xml file.

  <de.halfbit.pinnedsection.PinnedSectionListView
      android:id="@android:id/list"
      android:layout_width="match_parent"
      android:layout_height="wrap_content" 
      />

2. Extend your ListAdapter in a way that it implements PinnedSectionListAdapter interface, in addition to what it already implements. Basically you need to add a single isItemViewTypePinned(int viewType) method. This method must return true for 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.

Grocery Sum

Slack

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.

Versions

Version
1.0.0 Aug 20, 2016