AndroidSwipeableCardStack

Change log:

• provide option to infinitly swipe in a loop
• card rotation setting
• card gravity setting
• undo animation

Thanks for contributions from: https://github.com/raeehttps://github.com/rebus007

A tinder like swipeable card stack component. Provide "swipe to like" effects. Easy to customize card views.

See youtube demo : https://www.youtube.com/watch?v=YsMnLJeouf8&feature=youtu.be A Demo App is also included in the source.

Installation

Use jitpack

repositories {
maven { url "https://jitpack.io" }
}
dependencies {
compile 'com.github.wenchaojiang:AndroidSwipeableCardStack:0.*.*'
}

OR manually

1. Download released .aar file [Download current release] (https://github.com/wenchaojiang/AndroidSwipeableCardStack/releases/)

2. put it into your project lib dir, "libs" for example.

3. put following lines to your gradle.build file

repositories {
flatDir {
dirs 'libs'
}
}
dependencies {
compile(name:'android-card-stack-0.*.*', ext:'aar')
}

Configuration

Put CardStack in your layout file

<com.wenchao.cardstack.CardStack
android:id="@+id/container"android:layout_width="match_parent"android:layout_height="match_parent"android:clipChildren="false"android:clipToPadding="false"android:gravity="center"android:padding="10dp"app:card_enable_loop="true"app:card_enable_rotation="true"app:card_gravity="top"app:card_margin="10dp"app:card_stack_size="4"/>

Create your card view layout file.

Example: card_layout.xml, contain only a TextView

<?xml version="1.0" encoding="utf-8"?>
<LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"android:orientation="vertical"android:layout_width="match_parent"android:layout_height="match_parent">
<TextViewandroid:id="@+id/content"android:layout_width="wrap_content"android:layout_height="wrap_content"
/>
</LinearLayout>

Implement your own adapter for the card stack. The CardStack will accept ArrayAdapter. The Following example extends a simple ArrayAdapter, overriding getView() to supply your customized card layout

publicclassCardsDataAdapterextendsArrayAdapter<String> {
@OverridepublicViewgetView(intposition, finalViewcontentView, ViewGroupparent){
//supply the layout for your cardTextViewv = (TextView)(contentView.findViewById(R.id.content));
v.setText(getItem(position));
returncontentView;
}
}

Get the CardStack instance in your activity

protectedvoidonCreate(BundlesavedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_my);
mCardStack = (CardStack)findViewById(R.id.container);
mCardStack.setContentResource(R.layout.card_content);
mCardStack.setStackMargin(20);
}

Finally, set the adapter

mCardAdapter = newCardsDataAdapter(getApplicationContext(),0);
mCardAdapter.add("test1");
mCardAdapter.add("test2");
mCardAdapter.add("test3");
mCardAdapter.add("test4");
mCardAdapter.add("test5");
mCardStack.setAdapter(mCardAdapter);

Listening to card stack event

implement CardStack.CardEventListener, and set it as listener mCardStack.setListener(yourListener);

ClassYourListenerextendsCardStack.CardEventListener{
//implement card event interface@OverridepublicbooleanswipeEnd(intdirection, floatdistance) {
//if "return true" the dismiss animation will be triggered //if false, the card will move back to stack//distance is finger swipe distance in dp//the direction indicate swipe direction//there are four directions// 0 | 1// ----------// 2 | 3return (distance>300)? true : false;
}
@OverridepublicbooleanswipeStart(intdirection, floatdistance) {
returntrue;
}
@OverridepublicbooleanswipeContinue(intdirection, floatdistanceX, floatdistanceY) {
returntrue;
}
@Overridepublicvoiddiscarded(intid, intdirection) {
//this callback invoked when dismiss animation is finished. 
}
@OverridepublicvoidtopCardTapped() {
//this callback invoked when a top card is tapped by user. 
}
}