JarCasting
JarCasting JarCasting

stickyheader

Sticky header

License

License
GroupId

GroupId

com.github.shuhart
ArtifactId

ArtifactId

stickyheader
Last Version

Last Version

1.1.0
Release Date

Release Date
Type

Type

aar
Description

Description

stickyheader
Sticky header
Project URL

Project URL

https://github.com/shuhart/StickyHeader

Download stickyheader

Filename Size
stickyheader-1.1.0.pom
stickyheader-1.1.0-sources.jar 3 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.shuhart/stickyheader/ -->
<dependency>
    <groupId>com.github.shuhart</groupId>
    <artifactId>stickyheader</artifactId>
    <version>1.1.0</version>
    <type>aar</type>
</dependency>
// https://jarcasting.com/artifacts/com.github.shuhart/stickyheader/
implementation 'com.github.shuhart:stickyheader:1.1.0'
// https://jarcasting.com/artifacts/com.github.shuhart/stickyheader/
implementation ("com.github.shuhart:stickyheader:1.1.0")
'com.github.shuhart:stickyheader:aar:1.1.0'
<dependency org="com.github.shuhart" name="stickyheader" rev="1.1.0">
  <artifact name="stickyheader" type="aar" />
</dependency>
@Grapes(
@Grab(group='com.github.shuhart', module='stickyheader', version='1.1.0')
)
libraryDependencies += "com.github.shuhart" % "stickyheader" % "1.1.0"
[com.github.shuhart/stickyheader "1.1.0"]

Dependencies

compile (1)

Group / Artifact Type Version
androidx.recyclerview » recyclerview jar 1.1.0

Project Modules

There are no modules declared in this project.

StickyHeader

The StickyHeader was created mainly because most popular libraries for sticky headers are too complicated or offer much more features than needed. Some of these libraries also break DiffUtils. For performance reason, a header view is created only once while view types and click listeners are not supported.

Also, by customizing this view via supplied adapter, a new sticky header will replace the previous one.

Sample

Usage

  1. Add mavenCentral() to repositories block in the gradle file.
  2. Add implementation 'com.github.shuhart:stickyheader:1.1.0 to the dependencies.
  3. Look into the sample for additional details on how to use and configure the library.

An adapter that extends StickyAdapter is necessary for the StickyHeaderItemDecorator that is used to create and bind sticky headers:

@Override
public int getHeaderPositionForItem(int itemPosition) {
    // Return a position of a header that represents an item at adapter position.
    // For the header itself return the same itemPosition.
}

@Override
public void onBindHeaderViewHolder(RecyclerView.ViewHolder holder, int headerPosition) {
    // Update a header content here.
}

@Override
public RecyclerView.ViewHolder onCreateHeaderViewHolder(ViewGroup parent) {
    // Create a ViewHolder for a header (called only once).
}

Then, attach it to the RecyclerView:

StickyHeaderItemDecorator decorator = new StickyHeaderItemDecorator(adapter);
decorator.attachToRecyclerView(recyclerView);

How it works

  • A ViewHolder is created by the adapter to reuse and bind every header.
  • A header view is drawn on top of the RecyclerView using onDrawOver() callback of ItemDecoration.

License

Copyright 2018 Bogdan Kornev.

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.1.0