ashnehete/FlipView

Flipping views like Gmail & beyond

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.ashnehete:FlipView:'
	}

	dependencies {
		implementation("com.github.ashnehete:FlipView:")
	}

	<dependency>
	    <groupId>com.github.ashnehete</groupId>
	    <artifactId>FlipView</artifactId>
	    <version></version>
	</dependency>


                            
    libraryDependencies += "com.github.ashnehete" % "FlipView" % ""


                            
    :dependencies [[com.github.ashnehete/FlipView ""]]

Readme

FlipView

GMail like View & beyond - Master branch: v1.1.1 of 2016.04.07

Changes in this fork

Added prefix (fv_) to all the attributes to avoid name clashes in a project using different libraries with attributes having same name.

Concept

FlipView is a ViewGroup (FrameLayout) that is designed to display 2 views/layouts by flipping the front one in favor of the back one, and vice versa. Optionally more views can be displayed in series one after another or can cycle with a interval.

Usage is very simple. You just need to add this View to any layout and you customize the behaviours by assigning values to the optional properties in the layout or programmatically. Please, refer to those attributes documentation for more details.

Not less, FlipView extends android.widget.ViewFlipper that extends android.widget.ViewAnimator, which means you can call all public functions of these two Android views.

Main functionalities

Visible during design time ;-)
Custom In/Out animation + entry animation + rear ImageView animation
Custom layout, ImageView & TextView for front layout.
Custom layout, ImageView for rear layout.
Custom background Drawable & color.
AutoStart cycle animation with custom interval.
PictureDrawable for SVG resources.

Showcase

Showcase1 Showcase2

#Setup Import the library into your project using Gradle with JCenter

dependencies {
	compile 'eu.davidea:flipview:1.1.1'
}

Using bintray.com

repositories {
	maven { url "http://dl.bintray.com/davideas/maven" }
}
dependencies {
	compile 'eu.davidea:flipview:1.1.1@aar'
}

Pull requests / Issues / Improvement requests

Feel free to contribute and ask!

#Usage Supported attributes with default values:

<eu.davidea.flipview.FlipView
	xmlns:app="http://schemas.android.com/apk/res-auto"
	android usual attrs
	(see below).../>

|ViewAnimator|| |:---|:---| | android:inAnimation="@anim/grow_from_middle_x_axis" | Identifier for the animation to use when a view is shown. | android:outAnimation="@anim/shrink_to_middle_x_axis" | Identifier for the animation to use when a view is hidden. | android:animateFirstView="true" | Defines whether to animate the current View when the ViewAnimation is first displayed.

|ViewFlipper|| |:---|:---| | android:autoStart="false" | When true, automatically start animating. | android:flipInterval="3000" | Time before next animation.

| FlipView || |:---|:---| | android:clickable="false" | (!!) Set this if you want view reacts to the tap and animate it. | app:fv_checked="false" | Whether or not this component is showing rear layout at startup. | app:fv_animateDesignLayoutOnly="false" | true, animate front and rear layouts from settings + child views; false, exclude all layouts and animate only child views from design layout if any. (This attribute cannot be changed at runtime). | app:fv_animationDuration="100" | Set the main animation duration. | app:fv_anticipateInAnimationTime="0" | Anticipate the beginning of InAnimation, this time is already subtracted from the main duration (new delay is: main duration - anticipation time). | app:fv_enableInitialAnimation="false" | Whether or not the initial animation should start at the beginning. | app:fv_initialLayoutAnimation="@anim/scale_up" | Starting animation. | app:fv_initialLayoutAnimationDuration="250" | Starting animation duration. | app:fv_frontLayout="@layout/flipview_front" | Front view layout resource (for checked state -> false). | app:fv_frontBackground="<OvalShape Drawable generated programmatically>" | Front drawable resource (for checked state -> false). | app:fv_frontBackgroundColor="<Color.GRAY set programmatically>" | Front view color resource (for checked state -> false). | app:fv_frontImage="@null" | Front image resource (for checked state -> false). | app:fv_frontImagePadding="0dp" | Front image padding. | app:fv_rearLayout="@layout/flipview_rear" | Rear view layout resource (for checked state -> true). | app:fv_rearBackground="<OvalShape Drawable generated programmatically>" | Rear drawable resource (for checked state -> true). | app:fv_rearBackgroundColor="Color.GRAY set programmatically" | Rear view color resource (for checked state -> true). | app:fv_rearImage="@drawable/ic_action_done" | Rear accept image resource. | app:fv_rearImagePadding="0dp" | Rear image padding. | app:fv_animateRearImage="true" | Whether or not the rear image should animate. | app:fv_rearImageAnimation="@anim/scale_up" | Rear image animation. | app:fv_rearImageAnimationDuration="150" | Rear image animation duration. | app:fv_rearImageAnimationDelay="animationDuration" | Rear image animation delay (depends the animation/duration it can be smart setting a specific delay. For Gmail effect set this to 0).

|Not changeable values (in ms)|| |:---|:---| | DEFAULT_INITIAL_DELAY = 500 | This gives time to the activity to load all tree views before starting cascade initial animation. | SCALE_STEP_DELAY = 35 | This gives an acceptable nice loading effect. | STOP_LAYOUT_ANIMATION_DELAY = 1500 | This gives the time to perform all entry animations but to stop further animations when screen is fully rendered.

Limitations

Transparency has a little glitch when used with elevation, you could see shadow In the shape: more transparent the color is more visible the shadow is.
Using layer type software on the entire layout it removes the shadow/elevation.
Stroke and background color on custom Drawable should be preset by the user: too complex to determine the type of the Drawable used in order to change its color.

Change Log

v1.1.1 - 2016.04.07

Added support to enable/disable flipping programmatically. Overridden setClickable() and setEnabled() [See #8].
Adapted demo App to show how to make clickable/enabled/disabled the view.

v1.1.0 - 2015.11.05

New attribute app:rearImageAnimationDelay with relative method.
Fixed bugs #4 #5 #6.
Overridden showNext() & showPrevious() methods from ViewAnimator: now they perform the flip accordingly with the existing settings and register its state.
Since the FlipView uses shapes to define its border and shadows, one can use app:frontBackground & app:rearBackground for the custom Drawable with the desired shape, color and stroke, which always override inner Drawables. Alternatively you can do this also by assigning the resource to android:background of the custom layout. Because of that, at runtime, the method setChildBackgroundDrawable(child, drawable) has been reviewed (#2 #3).
Instead, if you want to use the inner Drawable (OvalShape) and only change color, you can do it at design time with app:frontBackgroundColor & app:rearBackgroundColor and at runtime with the new method setChildBackgroundColor(child, color): it always creates an OvalShape with the custom color (#2 #3). Note: setBackgroundColor is the method of android.view.View, so it does the default job!
First version of ShapeDrawables static methods (Oval, Arc, RoundRect).
Added new static method to enable/disable logs at runtime, debug logs are disabled by default.
Added methods to retrieve front and rear ImageViews and front TextView objects.
Automatic layer type software when setting PictureDrawable for SVG files (applied on ImageView reference only!).
Adapted demo App to show how AutoStart works and how 2 entire layouts can be animated ;-)

Old releases

See releases for old versions.

v1.0.0 - 2015.11.01

License

Copyright 2016 Davide Steduto

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.