<h1 align="center">Metaphor </h1> 💠Android Material's motion system animations. <a href="https://devlibrary.withgoogle.com/authors/AndroidPoet"><img alt="Google" src="https://user-images.githubusercontent.com/13647384/162663007-d911f6ce-ac1b-4754-a63b-eadbef38087f.svg"/></a> <a href="https://opensource.org/licenses/Apache-2.0"><img alt="License" src="https://img.shields.io/badge/License-Apache%202.0-blue.svg"/></a> <a href="https://medium.com/@androidpoet/metaphor-make-your-app-shine-with-material-motion-animations-73e5ffc698b4"><img alt="Medium" src="https://user-images.githubusercontent.com/13647384/162663072-9d93cb76-1af0-49fc-b003-372e536ae171.svg"/></a> <a href="https://github.com/AndroidPoet"><img alt="Profile" src="https://user-images.githubusercontent.com/13647384/162662962-82e3c1eb-baf8-4e21-ad26-d4c4e3c31e44.svg"/> <a href="https://androidweekly.net/issues/issue-509"><img alt="Android Weekly" src="https://androidweekly.net/issues/issue-509/badge"/></a> </a> <a href="https://mailchi.mp/kotlinweekly/kotlin-weekly-295"><img alt="Kotlin Weekly" src="https://img.shields.io/badge/Featured%20in%20kotlinweekly-Issue%20%20295-blue.svg"/></a> <img src="https://user-images.githubusercontent.com/13647384/176620969-686a3d1b-cf5c-4689-8a3e-ee7c35293a95.png" width="20%"/>

Who's using Metaphor?

👉 Check out who's using Metaphor

Include in your project

Gradle

Add the dependency below to your module's build.gradle file:

dependencies {
    implementation("io.github.androidpoet:metaphor:1.1.6")
}

Metaphor provides support for all four motion patterns defined in the Material spec.

Container transform
Shared axis
Fade through
Fade

Container transform How to use In Fragments


//Start Fragments onclick// 
val extras = FragmentNavigatorExtras(view to item.pos.toString())
val action = ArtistListFragmentDirections.navToCharacterDetailFragment(item)
findNavController().navigate(action, extras)

//start fragment 
// inside on onViewCreated  
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    hold() // this is function is really important for the "ContainerTransform" it will hold the currant fragment view

}


//destination fragment		

// inside on onViewCreated  
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    val metaphor = MetaphorFragment.Builder(fragment)
        .setExitDuration(300)
        .setView(view)
        .setTransitionName(args.data.pos.toString())
        .setExitAnimation(MetaphorAnimation.ContainerTransform)
        .setMotion(MaterialArcMotion())
        .build()
    metaphor.animate()
}

Container transform How to use in views

//call this method with startView and add end view set Animation you want to perform


viewBinding.fabDetail.setOnClickListener {
    val meta = MetaphorView.Builder(viewBinding.fabDetail)
        .setDuration(300)
        .setEndView(viewBinding.controls)
        .setMetaphorAnimation(MetaphorAnimation.ContainerTransform)
        .setMotion(MaterialArcMotion())
        .build()
    meta.animate()
}

Shared axis How to use In Fragments


//start fragment 

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // FadeThrough inside fragment

    val metaphor = MetaphorFragment.Builder(fragment)
        .setEnterDuration(300)
        .setEnterAnimation(MetaphorAnimation.SharedAxisXForward)
        .build()
    metaphor.animate()
}

//destination fragment		

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // FadeThrough inside fragment

    val metaphor = MetaphorFragment.Builder(fragment)
        .setEnterDuration(300)
        .setEnterAnimation(MetaphorAnimation.SharedAxisXForward)
        .build()
    metaphor.animate()
}

Shared axis How to use in views

//call this method with startView and add end view set Animation you want to perform

viewBinding.fabDetail.setOnClickListener {
    val meta = MetaphorView.Builder(viewBinding.fabDetail)
        .setDuration(300)
        .setEndView(viewBinding.controls)
        .setMetaphorAnimation(MetaphorAnimation.SharedAxisXForward)
        .build()
    meta.animate()
}

Fade through How to use In Fragments


//start fragment 

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // FadeThrough inside fragment

    val metaphor = MetaphorFragment.Builder(fragment)
        .setEnterDuration(300)
        .setEnterAnimation(MetaphorAnimation.FadeThrough)
        .build()
    metaphor.animate()
}

//destination fragment		

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // FadeThrough inside fragment

    val metaphor = MetaphorFragment.Builder(fragment)
        .setEnterDuration(300)
        .setEnterAnimation(MetaphorAnimation.FadeThrough)
        .build()
    metaphor.animate()
}

Fade through How to use in views


//call this method with startView and add end view set Animation you want to perform


viewBinding.fabDetail.setOnClickListener {
    val meta = MetaphorView.Builder(viewBinding.fabDetail)
        .setDuration(300)
        .setEndView(viewBinding.controls)
        .setMetaphorAnimation(MetaphorAnimation.FadeThrough)
        .build()
    meta.animate()
}

Fade How to use In Fragments


//start fragment 
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // FadeThrough inside fragment

    val metaphor = MetaphorFragment.Builder(fragment)
        .setEnterDuration(300)
        .setEnterAnimation(MetaphorAnimation.MaterialFade)
        .build()
    metaphor.animate()
}

//destination fragment		

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // FadeThrough inside fragment

    val metaphor = MetaphorFragment.Builder(fragment)
        .setEnterDuration(300)
        .setEnterAnimation(MetaphorAnimation.Fade)
        .build()
    metaphor.animate()
}

Fade How to use in views


//call this method with startView and add end view set Animation you want to perform

viewBinding.fabDetail.setOnClickListener {
    val meta = MetaphorView.Builder(viewBinding.fabDetail)
        .setDuration(300)
        .setEndView(viewBinding.controls)
        .setMetaphorAnimation(MetaphorAnimation.Fade)

        .build()
    meta.animate()
}

Supported Animations

MetaphorAnimation.None
MetaphorAnimation.ContainerTransform
MetaphorAnimation.FadeThrough
MetaphorAnimation.Fade
MetaphorAnimation.SharedAxisXForward
MetaphorAnimation.SharedAxisYForward
MetaphorAnimation.SharedAxisZForward
MetaphorAnimation.SharedAxisXBackward
MetaphorAnimation.SharedAxisYBackward
MetaphorAnimation.SharedAxisZBackward
MetaphorAnimation.ElevationScaleGrow
MetaphorAnimation.ElevationScale

Create Metaphor Fragment with Kotlin DSL

We can also create an instance of the MetaphorFragment with the Kotlin DSL.

  val meta = metaphorFragment(this) {
    setEnterAnimation(MetaphorAnimation.Fade)
    setView(view)
    build()
}
meta.animate()

Create Metaphor View with Kotlin DSL

We can also create an instance of the MetaphorView with the Kotlin DSL.

val meta = metaphorView(it) {
    setDuration(300)
    setEndView(viewBinding.controls)
    setMetaphorAnimation(MetaphorAnimation.Fade)
    setMotion(MaterialArcMotion())
    build()
}

meta.animate()

images credit:https://unsplash.com/

Find this repository useful? :heart:

Support it by joining stargazers for this repository. :star: Also, follow me on GitHub for more cool projects! 🤩

License

Copyright 2022 AndroidPoet (Ranbir Singh)

Licensed under the Apache License, Version 2.0 (the "License");
y

Metaphor

Install / Use

README