kidfolk / StickyGridHeaders

An Android Library that makes it easy to make grid views with sectioned data and headers that stick to the top.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

StickyGridHeaders

StickyGridHeaders is an Android library that provides a GridView that shows items in sections with headers. By default the section headers stick to the top like the People app in Android 4.x but this can be turned off. StickyGridHeaders also automatically sizes its rows to the largest item in the row.

StickyGridHeaders has been designed to be adapter compatible with, and was inspired by, StickyListHeaders.

Usage

StickyGridHeadersGridView replaces the use of a GridView in your application and is used in the same manner. To get all the functionality your ListAdapter must implement one of either StickyGridHeadersBaseAdapter or StickyGridHeadersSimpleAdapter. The choice of the implementation allows you to decide between the 'Simple' version which automatically does some housework to enable the grid sections and headers, or the 'Base' version which leaves that work to you so you can implement a specific solution for your data set.

StickyGridHeaders provides some custom XML attributes so you can customise StickyGridHeadersGridView in your XML layouts. To use the attributes you just need to add a custom namespace to your layout.

xmlns:app="http://schemas.android.com/apk/res-auto"

To see a list of the current attributes provided, refer to attrs.xml.

Compatibility

The simple adapter interface has the same signature as StickyListHeadersAdapter so if you are using the StickyListHeaders library your adapters are already ready for StickyGridHeaders.

Example

Example App Portrait Screenshots The example source code is included in this repository.

License

Copyright 2013 Tonic Artos

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.

About

An Android Library that makes it easy to make grid views with sectioned data and headers that stick to the top.

License:Apache License 2.0