EasyFlipView

EasyFlipView

A quick and easy flip view through which you can create views with two sides like credit cards, poker cards etc.

✔️ Changelog

Changes exist in the releases tab.

Installation

Add this in your app's build.gradle file:

dependencies {
  implementation 'com.wajahatkarim:EasyFlipView:3.0.3'
}

From the version 3.0.0, this library will only support Android X naming artifacts. If you want to use the android.support versions, then use 2.1.2 version.

Or add EasyFlipView as a new dependency inside your pom.xml

<dependency> 
  <groupId>com.wajahatkarim</groupId>
  <artifactId>EasyFlipView</artifactId> 
  <version>3.0.3</version>
  <type>pom</type> 
</dependency>

❔ Usage

XML

EasyFlipView In XML layouts("Vertical")

<com.wajahatkarim3.easyflipview.EasyFlipView
	android:layout_width="match_parent"
	android:layout_height="wrap_content"
	app:flipOnTouch="true"
	app:flipEnabled="true"
	app:flipDuration="400"
	app:flipType="vertical"
	app:flipFrom="front"
	app:autoFlipBack="true"
	app:autoFlipBackTime="1000"
	>

	
	<include layout="@layout/flash_card_layout_back"/>
        
	
	<include layout="@layout/flash_card_layout_front"/>

</com.wajahatkarim3.easyflipview.EasyFlipView>

EasyFlipView In XML layouts("Horizontal")

<com.wajahatkarim3.easyflipview.EasyFlipView
	android:layout_width="match_parent"
	android:layout_height="wrap_content"
	app:flipOnTouch="true"
	app:flipEnabled="true"
	app:flipDuration="400"
	app:flipFrom="right"
	app:flipType="horizontal"
	app:autoFlipBack="false"
	>

	
	<include layout="@layout/flash_card_layout_back"/>

	
	<include layout="@layout/flash_card_layout_front"/>

</com.wajahatkarim3.easyflipview.EasyFlipView>

Customizations & Attributes

All customizable attributes for EasyFlipView

In Code (Java)

…

Flip Animation Listener

EasyFlipView easyFlipView = (EasyFlipView) findViewById(R.id.easyFlipView);
easyFlipView.setOnFlipListener(new EasyFlipView.OnFlipAnimationListener() {
            @Override
            public void onViewFlipCompleted(EasyFlipView flipView, EasyFlipView.FlipState newCurrentSide) 
            {
                
                // ...
                // Your code goes here
                // ...
                
            }
        });

❌ Known Issues

Clipping when rotation animation is running

To avoid clipping of top/bottom while flipping the view, you can disable it through XML like this

Add android:clipChildren="false" to the parent/root view of EasyFlipView component. And add android:clipToPadding="false" to the EasyFlipView itself. Special thanks to @ueen for this fix #64

EasyFlipView in RecyclerViews

The EasyFlipView doesn't flip when used in RecyclerView. This is because the EasyFlipView uses the onTouch() method to intercept the touch events and flip the view accordingly. One easier solution is to disable the flipOnTouch attribute in XML by this.

app:flipOnTouch="false"

Now, your RecyclerView will scroll but the EasyFlipView will not flip or animate on touch etc. You will have to manually flip the view by calling the method mYourFlipView.flipTheView() inside the adapter or ViewHolder class of the RecyclerView. For example,

…

The EasyFlipView has a strange behaviour when the back and front layouts are a CardView. To workaround it, wrap your CardView in a FrameLayout or other ViewGroup.

Donations

This project needs you! If you would like to support this project's further development, the creator of this project or the continuous maintenance of this project, feel free to donate. Your donation is highly appreciated (and I love food, coffee and beer). Thank you!

PayPal

• Donate $5: Thank's for creating this project, here's a tea (or some juice) for you!
• Donate $10: Wow, I am stunned. Let me take you to the movies!
• Donate $15: I really appreciate your work, let's grab some lunch!
• Donate $25: That's some awesome stuff you did right there, dinner is on me!
• Donate $50: I really really want to support this project, great job!
• Donate $100: You are the man! This project saved me hours (if not days) of struggle and hard work, simply awesome!
• Donate $2799: Go buddy, buy Macbook Pro for yourself!

Of course, you can also choose what you want to donate, all donations are awesome!

Developed By

Wajahat Karim

• Website (http://wajahatkarim.com)
• Twitter (http://twitter.com/wajahatkarim)
• Medium (http://www.medium.com/@wajahatkarim3)
• LinkedIn (http://www.linkedin.com/in/wajahatkarim)

Special Thanks

• iGio90 for adding dynamic views support Pull Request # 10
• Sachin Varma for adding vertical animations support Pull Request # 12
• Sachin Varma for adding multi-dimension animations support Pull Request # 23
• Sachin Varma for adding multi-dimension animations support Pull Request # 23
• Daniel Luque for updating the targetSdk to 28 Pull Request # 30
• Aditya Zope for adding the feature to flip card only once. Pull Request # 33
• Bruno Correia for removing <application> tag from AndroidManifest.xml. Pull Request # 38 and fixing the card animation glitch issue Pull Request # 39

How to Contribute

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

License

Copyright 2018 Wajahat Karim

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.