Metaphor

💠Android Material's motion system animations.

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? ❤️

Support it by joining stargazers for this repository. ⭐
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");
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.

AndroidPoet / Metaphor