|
1 | | -# ItemAnimators |
2 | | -ItemAnimators: Supercharged Animators for your RecyclerView |
| 1 | +#ItemAnimators [](https://maven-badges.herokuapp.com/maven-central/com.mikepenz/itemanimators) [](https://gitter.im/mikepenz/itemanimators?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) |
| 2 | + |
| 3 | +The **ItemAnimators** library comes with a huge collections of pre-created Animators for your RecyclerView. |
| 4 | +It was created so developers can easly animate their RecyclerView. It also takes care about correctly handling all view states so you don't have to. |
| 5 | + |
| 6 | +> **DISCLAIMER**: this library does not animate items on scroll, just when added, removed, moved, or changed |
| 7 | +
|
| 8 | +#Preview |
| 9 | +##Screenshots |
| 10 | + |
| 11 | +#Include in your project |
| 12 | +##Using Maven |
| 13 | +```javascript |
| 14 | +compile('com.mikepenz:itemanimators:0.1.0-SNAPSHOT@aar') { |
| 15 | + transitive = true |
| 16 | +} |
| 17 | + |
| 18 | +//only on the SNAPSHOT repo right now: |
| 19 | +repositories { |
| 20 | + maven { url "https://oss.sonatype.org/content/repositories/snapshots/" } |
| 21 | +} |
| 22 | +``` |
| 23 | + |
| 24 | +##How to use |
| 25 | +```java |
| 26 | +//just provide the animator to your RecyclerView |
| 27 | +mRecyclerView.setItemAnimator(new ScaleUpAnimator()); |
| 28 | + |
| 29 | +//now it will automatically take care of all animations when you add, remove, chanage, move items |
| 30 | +//It is very important that you use the correct notify methods if items were changed, otherwise the adapter can't animate the items |
| 31 | +//Read more: http://developer.android.com/reference/android/support/v7/widget/RecyclerView.Adapter.html#notifyDataSetChanged() |
| 32 | +//If you want those things out of the box have a look at the **FastAdapter** it handles everything correctly for you |
| 33 | +//https://github.com/mikepenz/FastAdapter |
| 34 | +``` |
| 35 | + |
| 36 | +#Developed By |
| 37 | + |
| 38 | +* Mike Penz |
| 39 | + * [mikepenz.com](http://mikepenz.com) - <mikepenz@gmail.com> |
| 40 | + * [paypal.me/mikepenz](http://paypal.me/mikepenz) |
| 41 | + |
| 42 | +#License |
| 43 | + |
| 44 | + Copyright 2016 Mike Penz |
| 45 | + |
| 46 | + Licensed under the Apache License, Version 2.0 (the "License"); |
| 47 | + you may not use this file except in compliance with the License. |
| 48 | + You may obtain a copy of the License at |
| 49 | + |
| 50 | + http://www.apache.org/licenses/LICENSE-2.0 |
| 51 | + |
| 52 | + Unless required by applicable law or agreed to in writing, software |
| 53 | + distributed under the License is distributed on an "AS IS" BASIS, |
| 54 | + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 55 | + See the License for the specific language governing permissions and |
| 56 | + limitations under the License. |
0 commit comments