Bitbucket is a code hosting site with unlimited public and private repositories. We're also free for small teams!

Close

THIS REPOSITORY HAS MOVED TO GITHUB

Please refer to the repository on Github to receive updates. This repository will still be accessable in the future, but won't receive any updates.

ListViewAnimations (Play Store Demo)

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.

ListViewAnimations uses the NineOldAndroids library to support devices <3.0.
It also uses Roman Nurik's BETA SwipeDismissListViewTouchListener to support swipe to dismiss.

Known applications using ListViewAnimations

If you want your app to be listed as well please contact me via Twitter or Google Plus!

Setup

  • In Eclipse, just import the library as an Android library project.
  • Project > Clean to generate the binaries you need, like R.java, etc.
  • Then, just add ListViewAnimations as a dependency to your existing project and you're good to go!

Or:

  • Download the .jar file from the Downloads page
  • Add the .jar to your project's libs folder.

Usage

This library uses the Decorator Pattern to stack multiple BaseAdapterDecorators on each other:

  • Implement your own BaseAdapter, or reuse an existing one.
  • Stack multiple BaseAdapterDecorators on each other, with your BaseAdapter as a base.
  • Set the ListView to your last BaseAdapterDecorator.
  • Set your last BaseAdapterDecorator to the ListView.

Example:

/* This example will stack two animations on top of eachother */
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    MyListAdapter mAdapter = new MyListAdapter(this, getItems());
    SwingBottomInAnimationAdapter swingBottomInAnimationAdapter = new SwingBottomInAnimationAdapter(mAdapter);
    SwingRightInAnimationAdapter swingRightInAnimationAdapter = new SwingRightInAnimationAdapter(swingBottomInAnimationAdapter);

    // Or in short notation:
    swingRightInAnimationAdapter = 
        new SwingRightInAnimationAdapter(
            new SwingBottomInAnimationAdapter(
                    new MyListAdapter(this, getItems())));

    // Assign the ListView to the AnimationAdapter and vice versa
    swingRightInAnimationAdapter.setListView(getListView());
    getListView().setAdapter(swingRightInAnimationAdapter);
}

private class MyListAdapter extends com.haarman.listviewanimations.ArrayAdapter<String> {

    private Context mContext;

    public MyListAdapter(Context context, ArrayList<String> items) {
        super(items);
        mContext = context;
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        TextView tv = (TextView) convertView;
        if (tv == null) {
            tv = (TextView) LayoutInflater.from(mContext).inflate(R.layout.list_row, parent, false);
        }
        tv.setText(getItem(position));
        return tv;
    }
}

Custom AnimationAdapters

Instead of using the ready-made adapters in the .swinginadapters.prepared package, you can also implement your own AnimationAdapter. Implement one of the following classes:

  • ResourceAnimationAdapter
  • SingleAnimationAdapter
  • AnimationAdapter

See the examples.

Developed By

  • Niek Haarman

License

Copyright 2013 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.

Recent activity

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.