An Android library which allows developers to easily add animations to ListView items
Java
Latest commit 25124c5 Mar 16, 2015 @nhaarman Update CONTRIBUTING.md

README.md

ListViewAnimations (Play Store Demo) Build Status

ListViewAnimations is an Open Source Android library that allows developers to easily create ListViews with animations. Feel free to use it all you want in your Android apps provided that you cite this project and include the license in your app.

Features

ListViewAnimations provides the following features:

  • Appearance animations for items in ListViews, GridViews, other AbsListViews;
    • Built in animations include Alpha, SwingRightIn, SwingLeftIn, SwingBottomIn, SwingRightIn and ScaleIn.
    • Other animations can easily be added
    • StickyListHeaders is supported, other implementations can easily be added.
  • Swipe-to-Dismiss, Swipe-To-Dismiss with contextual undo;
  • Drag-and-Drop reordering;
  • Animate addition of items;
  • Smoothly expand your items to reveal more content;

Setup

The library consists of separate modules:

  • lib-core: The core of the library, and contains appearance animations.
  • lib-manipulation: Contains the item manipulation options, such as Swipe-to-Dismiss, and Drag-and-Drop.
  • lib-core-slh: An extension of lib-core to support StickyListHeaders.

When using lib-manipulation or lib-core-slh, lib-core is included as well.

Add the following to your build.gradle:

repositories {
    mavenCentral()
}

dependencies {
    compile 'com.nhaarman.listviewanimations:lib-core:3.1.0@aar'
    compile 'com.nhaarman.listviewanimations:lib-manipulation:3.1.0@aar'
    compile 'com.nhaarman.listviewanimations:lib-core-slh:3.1.0@aar'
}

Or:

Or:

Add the following to your pom.xml:

<dependency>
    <groupId>com.nhaarman.listviewanimations</groupId>
    <artifactId>lib-core</artifactId>
    <version>3.1.0</version>
</dependency>
<dependency>
    <groupId>com.nhaarman.listviewanimations</groupId>
    <artifactId>lib-manipulation</artifactId>
    <version>3.1.0</version>
</dependency>
<dependency>
    <groupId>com.nhaarman.listviewanimations</groupId>
    <artifactId>lib-core-slh</artifactId>
    <version>3.1.0</version>
</dependency>

Getting Started

Contribute

Please do! I'm happy to review and accept pull requests.
Please read Contributing before you do.

Developed By

  • Niek Haarman

Special Thanks

License

Copyright 2014 Niek Haarman

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.