com.nhaarman.listviewanimations.itemmanipulation.animateaddition

Class AnimateAdditionAdapter<T>

java.lang.Object

android.widget.BaseAdapter

com.nhaarman.listviewanimations.BaseAdapterDecorator

com.nhaarman.listviewanimations.itemmanipulation.animateaddition.AnimateAdditionAdapter<T>

All Implemented Interfaces:

Adapter, ListAdapter, SectionIndexer, SpinnerAdapter, com.nhaarman.listviewanimations.util.Insertable, com.nhaarman.listviewanimations.util.ListViewWrapperSetter, com.nhaarman.listviewanimations.util.Swappable

public class AnimateAdditionAdapter<T>
extends com.nhaarman.listviewanimations.BaseAdapterDecorator

An adapter for inserting rows into the ListView with an animation. The root BaseAdapter should implement Insertable, otherwise an IllegalArgumentException is thrown. This class only works with an instance of ListView!

Usage:
- Wrap a new instance of this class around a BaseAdapter.
- Set a ListView to this class using setListView(android.widget.ListView).
- Call insert(int, Object) to animate the addition of an item.

Extend this class and override getAdditionalAnimators(android.view.View, android.view.ViewGroup) to provide extra Animators.

Field Summary

Fields inherited from interface android.widget.Adapter

IGNORE_ITEM_VIEW_TYPE, NO_SELECTION

Constructor Summary

Constructors

Constructor and Description
AnimateAdditionAdapter(BaseAdapter baseAdapter) Create a new AnimateAdditionAdapter with given BaseAdapter.

Method Summary

Methods

Modifier and Type	Method and Description
protected com.nineoldandroids.animation.Animator[]	getAdditionalAnimators(View view, ViewGroup parent) Override this method to provide additional animators on top of the default height and alpha animation.
View	getView(int position, View convertView, ViewGroup parent)
void	insert(int index, T... items) Inserts items, starting at given index.
void	insert(int index, T item) Inserts an item at given index.
void	insert(Iterable<Pair<Integer,T>> indexItemPairs) Inserts items at given indexes.
void	insert(Pair<Integer,T>... indexItemPairs) Inserts items at given indexes.
void	setAbsListView(AbsListView absListView) Deprecated. use setListView(android.widget.ListView) instead.
void	setInsertionAnimationDuration(long insertionAnimationDurationMs) Set the duration of the insertion animation.
void	setListView(ListView listView) Sets the ListView that is used for this AnimateAdditionAdapter.
void	setScrolldownAnimationDuration(long scrolldownAnimationDurationMs) Set the duration of the scrolldown animation per item for when items are inserted above the first visible item.
void	setShouldAnimateDown(boolean shouldAnimateDown) Sets whether the list should animate downwards when items are added above the first visible item.

Methods inherited from class com.nhaarman.listviewanimations.BaseAdapterDecorator

add, areAllItemsEnabled, getCount, getDecoratedBaseAdapter, getDropDownView, getItem, getItemId, getItemViewType, getListViewWrapper, getPositionForSection, getRootAdapter, getSectionForPosition, getSections, getViewTypeCount, hasStableIds, isEmpty, isEnabled, notifyDataSetChanged, notifyDataSetChanged, notifyDataSetInvalidated, registerDataSetObserver, setListViewWrapper, swapItems, unregisterDataSetObserver

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AnimateAdditionAdapter

public AnimateAdditionAdapter(BaseAdapter baseAdapter)

Create a new AnimateAdditionAdapter with given BaseAdapter.

Parameters:

baseAdapter - should implement Insertable, or be a BaseAdapterDecorator whose BaseAdapter implements the interface.

Method Detail

setAbsListView

@Deprecated
public void setAbsListView(AbsListView absListView)

Deprecated. use setListView(android.widget.ListView) instead.

Overrides:

setAbsListView in class com.nhaarman.listviewanimations.BaseAdapterDecorator

setListView

public void setListView(ListView listView)

Sets the ListView that is used for this AnimateAdditionAdapter.

setShouldAnimateDown

public void setShouldAnimateDown(boolean shouldAnimateDown)

Sets whether the list should animate downwards when items are added above the first visible item.

Parameters:

shouldAnimateDown - defaults to true.

setScrolldownAnimationDuration

public void setScrolldownAnimationDuration(long scrolldownAnimationDurationMs)

Set the duration of the scrolldown animation per item for when items are inserted above the first visible item.

Parameters:

scrolldownAnimationDurationMs - the duration in ms.

setInsertionAnimationDuration

public void setInsertionAnimationDuration(long insertionAnimationDurationMs)

Set the duration of the insertion animation.

Parameters:

insertionAnimationDurationMs - the duration in ms.

insert

public void insert(int index,
          T item)

Inserts an item at given index. Will show an entrance animation for the new item if the newly added item is visible. Will also call Insertable.add(int, Object) of the root BaseAdapter.

Parameters:

index - the index the new item should be inserted at.

item - the item to insert.

insert

public void insert(int index,
          T... items)

Inserts items, starting at given index. Will show an entrance animation for the new items if the newly added items are visible. Will also call Insertable.add(int, Object) of the root BaseAdapter.

Parameters:

index - the starting index the new items should be inserted at.

items - the items to insert.

insert

public void insert(Pair<Integer,T>... indexItemPairs)

Inserts items at given indexes. Will show an entrance animation for the new items if the newly added item is visible. Will also call Insertable.add(int, Object) of the root BaseAdapter.

Parameters:

indexItemPairs - the index-item pairs to insert. The first argument of the Pair is the index, the second argument is the item.

insert

public void insert(Iterable<Pair<Integer,T>> indexItemPairs)

Inserts items at given indexes. Will show an entrance animation for the new items if the newly added item is visible. Will also call Insertable.add(int, Object) of the root BaseAdapter.

Parameters:

indexItemPairs - the index-item pairs to insert. The first argument of the Pair is the index, the second argument is the item.

getView

public View getView(int position,
           View convertView,
           ViewGroup parent)

Specified by:

getView in interface Adapter

Overrides:

getView in class com.nhaarman.listviewanimations.BaseAdapterDecorator

getAdditionalAnimators

protected com.nineoldandroids.animation.Animator[] getAdditionalAnimators(View view,
                                                              ViewGroup parent)

Override this method to provide additional animators on top of the default height and alpha animation.

Parameters:

view - The View that will get animated.

parent - The parent that this view will eventually be attached to.

Returns:

a non-null array of Animators.