{"id":3514,"url":"https://github.com/kaichunlin/android-transition","last_synced_at":"2025-08-12T01:30:58.032Z","repository":{"id":31788314,"uuid":"35354764","full_name":"kaichunlin/android-transition","owner":"kaichunlin","description":"Allows the easy creation of animated transition effects when the state of Android UI has changed","archived":false,"fork":false,"pushed_at":"2018-05-04T21:20:36.000Z","size":5911,"stargazers_count":611,"open_issues_count":3,"forks_count":78,"subscribers_count":27,"default_branch":"master","last_synced_at":"2024-06-20T03:49:01.062Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kaichunlin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-05-10T02:59:58.000Z","updated_at":"2024-04-02T17:44:18.000Z","dependencies_parsed_at":"2022-09-10T16:21:32.061Z","dependency_job_id":null,"html_url":"https://github.com/kaichunlin/android-transition","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaichunlin%2Fandroid-transition","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaichunlin%2Fandroid-transition/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaichunlin%2Fandroid-transition/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaichunlin%2Fandroid-transition/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kaichunlin","download_url":"https://codeload.github.com/kaichunlin/android-transition/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229624723,"owners_count":18100638,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-01-05T20:16:43.680Z","updated_at":"2024-12-13T22:30:38.128Z","avatar_url":"https://github.com/kaichunlin.png","language":"Java","funding_links":[],"categories":["Index `(light-weight pages)`","Java","Libraries","Index","Libs","库"],"sub_categories":["GUI","\u003cA NAME=\"Animations\"\u003e\u003c/A\u003eAnimations","[](https://github.com/JStumpp/awesome-android/blob/master/readme.md#animations)动画"],"readme":"# android-transition\n\n[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-android--transition-brightgreen.svg?style=flat)](http://android-arsenal.com/details/1/2013)\n[![Maven Central](http://img.shields.io/maven-central/v/com.github.kaichunlin.transition/core.svg)](http://search.maven.org/#search%7Cga%7C1%7Ccom.github.kaichunlin)\n\nAndroid-Transition allows the easy creation of view transitions that reacts to user inputs. The library is designed to be general enough such that the same transition can be applied to\ndiffernt UI components like [Drawer](https://developer.android.com/reference/android/support/v4/widget/DrawerLayout.html), [SlidingUpPanel](https://github.com/umano/AndroidSlidingUpPanel), [ViewPager](https://developer.android.com/reference/android/support/v4/view/ViewPager.html), [ObservableScrollView](https://github.com/ksoichiro/Android-ObservableScrollView) (work in progress), etc., as long as appropriate adapter is used.\n\n## Changelog\n\n**0.9.5**\n\n - Add [Animation.forceEndState()](https://github.com/kaichunlin/android-transition/blob/d2019b99dfb6b6293142757421ec781617f69d69/core/src/main/java/com/kaichunlin/transition/animation/Animation.java#L95)\n - Add [DefaultAnimationListener](https://github.com/kaichunlin/android-transition/blob/40f5aad24a7d8c0e626bb946c803a5842db653dd/core/src/main/java/com/kaichunlin/transition/animation/DefaultAnimationListener.java)\n - Add a bunch of delayed methods with varargs to [ViewTransitionBuilder](https://github.com/kaichunlin/android-transition/blob/40f5aad24a7d8c0e626bb946c803a5842db653dd/core/src/main/java/com/kaichunlin/transition/ViewTransitionBuilder.java) \u0026 [MenuItemTransitionBuilder](https://github.com/kaichunlin/android-transition/blob/40f5aad24a7d8c0e626bb946c803a5842db653dd/core/src/main/java/com/kaichunlin/transition/MenuItemTransitionBuilder.java)\n - Add [ColorTransition](https://github.com/kaichunlin/android-transition/blob/94f4f872020e78a58a3ae32d55a518c223af3dab/core/src/main/java/com/kaichunlin/transition/widget/ColorTransition.java)\n - Add [AutoReverseAnimationListener](https://github.com/kaichunlin/android-transition/blob/40f5aad24a7d8c0e626bb946c803a5842db653dd/core/src/main/java/com/kaichunlin/transition/animation/AutoReverseAnimationListener.java)\n - Reduce transient objects created by ViewTransitionBuilder\n - Update dependent library versions: (com.github.ksoichiro:android-observablescrollview:1.5.1 --\u003e 1.6.0, com.sothree.slidinguppanel:library:3.0.0 --\u003e  3.2.1\n\n**0.9.4**\n\nBecause somehow version 0.9.3 uploaded to Maven is broken :-/\n\n**0.9.3**\n\n - Many *TransitionBuilder methods now takes varargs\n - Add visible()/invisible()/gone() to *TransitionBuilder that modifies target View's visibility\n - Add [ScaledTransitionHandler](https://github.com/kaichunlin/android-transition/blob/fae47fef614f8994ad738768474f565c39fdcd2e/core/src/main/java/com/kaichunlin/transition/ScaledTransitionHandler.java)\n - Improve [Cascade](https://github.com/kaichunlin/android-transition/blob/master/core/src/main/java/com/kaichunlin/transition/Cascade.java)\n - Fix erroneously sharing some TransitionBuilder states when cloned\n - Remove android:allowBackup from AndroidManifest.xml\n - Minor optimizations\n\n**0.9.2**\n\n - Allow the transition/animation of a single MenuItem\n - Add ViewTransitionBuilder.height(int) / ViewTransitionBuilder.delayHeight(int)\n - AnimationManager/TransitionAnimation can specify either [AnimationController](https://github.com/kaichunlin/android-transition/blob/951d424e5a1db23f35eca472a2dd769a331a2a28/core/src/main/java/com/kaichunlin/transition/animation/AnimationController.java) or [AnimatorController](https://github.com/kaichunlin/android-transition/blob/951d424e5a1db23f35eca472a2dd769a331a2a28/core/src/main/java/com/kaichunlin/transition/animation/AnimatorController.java) (Animator is needed to animate MenuItems but is, for some reason, slow for certain animations like View height manipulation)\n - Reduce garbage generation and other optimizations\n - Fix memory leak with MenuItem transition\n - Fix incorrect state when reverse transiting a View with a range not between 0f and 1f\n - Remove AnimationManager.removeAnimation(Animation) to support optimization, may add it back in the future\n\n**0.9.1**\n\nFixed an embarrassing mistakenly-capitalized package name.\n\n**0.9.0**\n\n**Please note that due to change in scope and direction, the code has been overhauled in 0.9.x and is incompatible with 0.8.x.**\n\nOn the other hand now it only takes __8 lines of code__ to achieve the effect below that includes both non-interactive animation and interactive transition (drawer dragging):\n\n![](/github/animation_transition.gif)\n\nOn Android Studio update Gradle dependency to:\n```groovy\n    compile 'com.github.kaichunlin.transition:core:0.9.4'\n```\nTo add the corresponding slidinguppanel module:\n```groovy\n    compile 'com.github.kaichunlin.transition:slidinguppanel:0.9.1'\n```\n**0.8.3**\n\n[Android Support Annotations](http://tools.android.com/tech-docs/support-annotations) are applied across the codebase which should help catching incorrect usage early. On Android Studio update Gradle dependency to:\n```groovy\n    compile 'com.github.kaichunlin.transition:core:0.8.3'\n```\nNote that while many annotations such as @NonNull and @Nullable work on [SDK Build Tools](https://developer.android.com/tools/revisions/build-tools.html) 22.0.x, some annotations like @IntRange and @FlatRange only work when preview version (23.0.0 rc2) is used.\n\n--------\n### Download from Google Play\n\n[![Get it on Google Play](https://developer.android.com/images/brand/en_generic_rgb_wo_45.png)](https://play.google.com/store/apps/details?id=kaichunlin.transition.app)\n\nThe app on Google Play may not be the latest version.\n\nFeatures\n--------\n+ **View and MenuItem Transition**\n\n  view transition\n\n  ![](/github/slideup_default.gif)\n\n  MenuItem transition\n\n  ![](/github/menu_shrink_and_fade.gif)\n\n+ **Integrated Transition \u0026 Animation**\n\n  See Changelog for 0.9.0 above for an exmaple, and the \"Usage\" section below for sample code.\n\n+ **Interpolator**\n\n  It's very easy to apply standard Android Interpolator to the transition:\n\n  ([AccelerateDecelerateInterpolator](http://developer.android.com/reference/android/view/animation/AccelerateDecelerateInterpolator.html) v.s. [AnticipateInterpolator](http://developer.android.com/reference/android/view/animation/AnticipateInterpolator.html))\n\n  ![](/github/slideup_default.gif)\n  ![](/github/slideup_anticipate.gif)\n\n\n+ **Custom Adapters**\n  * [Drawer](https://developer.android.com/reference/android/support/v4/widget/DrawerLayout.html)\n  * [SlidingUpPanel](https://github.com/umano/AndroidSlidingUpPanel)\n  * [ViewPager](https://developer.android.com/reference/android/support/v4/view/ViewPager.html)\n  * [ObservableScrollView](https://github.com/ksoichiro/Android-ObservableScrollView) (work in progress)\n  * Write one yourself!\n\nIntegration\n--------\nThe simplest way to integrate Android-Transition is to grab them from Maven Central or jCenter. On Android Studio, add the code below to Gradle dependencies:\n```groovy\n    compile 'com.github.kaichunlin.transition:core:0.9.5'\n```\nAdapters that adapts to UI components not found in Android framework or Android Support Library are provided as their own libraries, the table below is the list of libraries:\n\n| Library       | Function           | Description in build.gradle  |\n|:-------------|:-------------|:-----|\n| core | Provides core transition function and adapters | com.github.kaichunlin.transition:core:0.9.5 |\n| slidinguppanel | [AndroidSlidingUpPanel](https://github.com/umano/AndroidSlidingUpPanel) Adapter | com.github.kaichunlin.transition:slidinguppanel:0.9.5|\n\nAs an example, if an app requires the _slidinguppanel_ module, which implicitly requires the _core_ module, then build.gradle will look like below:\n```groovy\n     dependencies {\n       //other dependencies\n       ...\n\n        compile 'com.github.kaichunlin.transition:slidinguppanel:0.9.5'\n     }\n```\nUsage\n--------\n+ [Transition](https://github.com/kaichunlin/android-transition/blob/674c3d2f0967f20d9f372a233651b2ae6b5ca90c/core/src/main/java/com/kaichunlin/transition/Transition.java) is the primary object used to specify the desired operation on a View. The primary way to create Transitions is through the use of [ViewTransitionBuilder](https://github.com/kaichunlin/android-transition/blob/674c3d2f0967f20d9f372a233651b2ae6b5ca90c/core/src/main/java/com/kaichunlin/transition/ViewTransitionBuilder.java) and [MenuItemTransitionBuilder](https://github.com/kaichunlin/android-transition/blob/674c3d2f0967f20d9f372a233651b2ae6b5ca90c/core/src/main/java/com/kaichunlin/transition/MenuItemTransitionBuilder.java).\n+ These two classes provide fluent API with capability similar to  [ViewPropertyAnimator](http://developer.android.com/reference/android/view/ViewPropertyAnimator.html). Example:\n \n  ```java\n  //create a Transition for the View with ID R.id.big_icon that rotates it by 360 degrees, applies different scaling on the X \u0026 Y axes, move it on the x axis by 200 pixels. \n    Transition transition = ViewTransitionBuilder.transit(findViewById(R.id.big_icon)).rotation(0f, 360f).scaleX(1f, 0.2f).scaleY(1f, 0f).translationX(200f)).build();\n  ```\n  \n+ Once created, Transition can be added to any [adapter](https://github.com/kaichunlin/android-transition/tree/674c3d2f0967f20d9f372a233651b2ae6b5ca90c/core/src/main/java/com/kaichunlin/transition/adapter), which will manage and initiate the Transition when the user is manipulating an interactive View such as [DrawerLayout](https://github.com/kaichunlin/android-transition/blob/674c3d2f0967f20d9f372a233651b2ae6b5ca90c/core/src/main/java/com/kaichunlin/transition/adapter/DrawerListenerAdapter.java):\n\n  ```java\n  mDrawerListenerAdapter.addTransition(transition);\n  ```\n\n+ [ViewTransitionBuilder](https://github.com/kaichunlin/android-transition/blob/674c3d2f0967f20d9f372a233651b2ae6b5ca90c/core/src/main/java/com/kaichunlin/transition/ViewTransitionBuilder.java) and [MenuItemTransitionBuilder](https://github.com/kaichunlin/android-transition/blob/674c3d2f0967f20d9f372a233651b2ae6b5ca90c/core/src/main/java/com/kaichunlin/transition/MenuItemTransitionBuilder.java) have the method [buildAnimation()](https://github.com/kaichunlin/android-transition/blob/674c3d2f0967f20d9f372a233651b2ae6b5ca90c/core/src/main/java/com/kaichunlin/transition/AbstractTransitionBuilder.java#L566) to create an [Animation](https://github.com/kaichunlin/android-transition/blob/master/core/src/main/java/com/kaichunlin/transition/animation/Animation.java) object:\n\n  ```java\n    Animation animation = ViewTransitionBuilder.transit(findViewById(R.id.big_icon)).rotation(0f, 360f).scaleX(1f, 0.2f).scaleY(1f, 0f).translationX(200f)).buildAnimation();\n    animation.startAnimation(300);\n  ```\n  \n+ The app/ folder is a sample app containing dozens of examples.\n\n\n#### Two steps to apply transition to any View ([sample code](https://github.com/kaichunlin/android-transition/blob/master/app/src/main/java/com/kaichunlin/transition/app/DrawerViewActivity.java)):\n\n  1. Use the adapter corresponding to the ViewGroup type:\n\n  ```java\n  //uses DrawerListenerAdapter to handle DrawerLayout user interactions\n  DrawerListenerAdapter mDrawerListenerAdapter = new DrawerListenerAdapter(mDrawerToggle, R.id.drawerList);\n  mDrawerListenerAdapter.setDrawerLayout(mDrawerLayout);\n  ```\n  2. Add desired transition to the adapter, [ViewTransitionBuilder](https://github.com/kaichunlin/android-transition/blob/master/transition/src/main/java/com/kaichunlin/transition/ViewTransitionBuilder.java) is used to build the transition:\n\n  ```java\n  mDrawerListenerAdapter.addTransition(\n  ViewTransitionBuilder.transit(findViewById(R.id.big_icon)).rotation(0f, 360f).scaleX(1f, 0.2f).scaleY(1f, 0f).translationX(200f));\n  ```\n\n---\n\n#### Three steps to apply transition to a MenuItem ([sample code](https://github.com/kaichunlin/android-transition/blob/master/app/src/main/java/com/kaichunlin/transition/app/DrawerMenuItemActivity.java)):\n\n1. Use the appropriate adapter that extends [MenuBaseAdapter](https://github.com/kaichunlin/android-transition/blob/master/transition/src/main/java/com/kaichunlin/transition/adapter/MenuBaseAdapter.java):\n\n  ```java\n    DrawerListenerAdapter mDrawerListenerAdapter = new DrawerListenerAdapter(mDrawerToggle, R.id.drawerList);\n    mDrawerListenerAdapter.setDrawerLayout(mDrawerLayout);\n  ```\n2. Let the adapter manage the creation of options menu:\n\n  ```java\n    @Override\n    public boolean onCreateOptionsMenu(Menu menu) {\n        mDrawerListenerAdapter.onCreateOptionsMenu(this, menu);\n\n        return super.onCreateOptionsMenu(menu);\n    }\n  ```\n3. Add desired transition to the adapter, [MenuItemTransitionBuilder](https://github.com/kaichunlin/android-transition/blob/master/transition/src/main/java/com/kaichunlin/transition/MenuItemTransitionBuilder.java) is used to build the transition:\n\n  ```java\n    //shared configuration\n    MenuItemTransitionBuilder builder = MenuItemTransitionBuilder.transit(toolbar).alpha(1f, 0.5f).scale(1f, 0f).cascade(0.3f).visibleOnStartAnimation(true).invalidateOptionOnStopTransition(this, true);\n    // create a transition to be used when the drawer transits from the closed state to the opened state\n    // notice that in most situations clone() should be used, i.e. builder.clone(), to prevent builder picking up effects that should only apply to a single transition\n    MenuItemTransition mShrinkClose = builder.translationX(0, 30).build();\n    // create a reverse transition to be used when the drawer transits from the opened state to the closed state\n    MenuItemTransition mShrinkOpen = builder.reverse().translationX(0, 30).build();\n    //tells adapter the transition and the menu options for both the opened and closed states\n    mDrawerListenerAdapter.setupOptions(this, new MenuOptionConfiguration(mShrinkOpen, R.menu.drawer), new MenuOptionConfiguration(mShrinkClose, R.menu.main));\n  ```\n\n---\n\n#### Animation\n\n\n---\n\n#### To apply both animation \u0026 transition:\n\n  This can be achieved with the code:\n\n  ```java\n\n        //Create an adapter that listens for ActionBarDrawerToggle state change and update transition states\n        DrawerListenerAdapter mDrawerListenerAdapter = new DrawerListenerAdapter(mDrawerToggle, R.id.drawerList);\n        mDrawerListenerAdapter.setDrawerLayout(mDrawerLayout);\n\n        //this builder is used to build both transition \u0026 animation effect\n        ViewTransitionBuilder mRotateEffectBuilder = ViewTransitionBuilder.transit(findViewById(R.id.big_icon)).rotation(0f, 360f).scaleX(1f, 0.2f).scaleY(1f, 0f).translationX(200f);\n        //build the desired transition and adds to the adapter\n        ViewTransition transition = mRotateEffectBuilder.build();\n        mDrawerListenerAdapter.addTransition(transition);\n\n        //since the start animation is the reverse of the transition, set the current view state to transition's final state\n        transition.setProgress(1f);\n        //init an animation and add a delay to prevent stutter, needs to be higher if animation is enabled\n        final IAnimation animation = mRotateEffectBuilder.reverse().buildAnimation();\n        animation.startAnimationDelayed(600, 32);\n  ```\nSee source of [DrawerViewActivity.java](https://github.com/kaichunlin/android-transition/blob/827c6f0aa7782400c542c365ae9b9c0f1e172d9c/app/src/main/java/com/kaichunlin/transition/app/DrawerViewActivity.java#L50-L66) for example.\n\n---\n\n#### Misc\n+ To clear all transitions from an adapter:\n\n  ```java\n    mDrawerListenerAdapter.clearTransition();\n  ```\n\n+ Share a common builder ([sample code](https://github.com/kaichunlin/android-transition/blob/master/app/src/main/java/com/kaichunlin/transition/app/SlidingUpPanelActivity.java)):\n\n  ```java\n  //calling adapter(mSlidingUpPanelLayoutAdapter) means that when builder.build() is called, the resultant transition will automatically be added to mSlidingUpPanelLayoutAdapter\n  ViewTransitionBuilder baseBuilder = ViewTransitionBuilder.transit().interpolator(mInterpolator).adapter(mSlidingUpPanelLayoutAdapter).rotationX(42f).scale(0.8f).translationYAsFractionOfHeight(-0.5f);\n\n  //calls clone() so any modification will not be propagated to other transitions build from the same builder\n  //adds a transition to view R.id.content_bg\n  baseBuilder.clone().target(findViewById(R.id.content_bg)).build();\n\n  //apply the same transition effect to a different view (R.id.content)\n  baseBuilder.clone().target(findViewById(R.id.content)).build();\n  ```\n\n+ Delay transition evaluation until layout is complete, this is required if a view's position/dimension is used in the evaluation, in such a case [ViewUtil](https://github.com/kaichunlin/android-transition/blob/master/transition/src/main/java/com/kaichunlin/transition/util/ViewUtil.java) provides a helper function ([sample code](https://github.com/kaichunlin/android-transition/blob/master/app/src/main/java/com/kaichunlin/transition/app/SlidingUpPanelActivity.java)):\n\n  ```java\n    ViewUtil.executeOnGlobalLayout(findViewById(R.id.rotate_slide), new ViewTreeObserver.OnGlobalLayoutListener() {\n      public void onGlobalLayout() {\n        //create ViewTransitionBuilder here\n      }\n    });\n  ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaichunlin%2Fandroid-transition","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkaichunlin%2Fandroid-transition","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaichunlin%2Fandroid-transition/lists"}