SpringX is an Android library that allows developers to easily use SpringAnimation.
| Demo1 | Demo2 |
|---|---|
 |
 |
Include the jcenter repository to your root build.gradle file:
repositories {
jcenter()
}
And then add dependency to your module build.gradle:
dependencies {
implementation 'com.github.lcdsmao:springx:0.0.2'
}You can manually create the ViewPropertySpringAnimator or use the extension function:
val spring = ViewPropertySpringAnimator(view) // Always create a new one
// or
val spring = view.spring() // Reuse the one that associated with this viewThe syntax of ViewPropertySpringAnimator is simliar to ViewPropertyAnimator:
spring
.rotation(30f)
.scaleX(2f)
.scaleY(2f)
.y(500f)
.x(500f)
.start()Complicated controls are also allowed:
spring
.defaultDampingRatio(0.7f) // default damping ratio for all animations
.defaultStiffness(5f) // default stiffness for all animations
.rotation(30f)
.translationX(100f) {
startVelocity = 30f // set start velocity of TRANSLATION_X
dampingRatio = 0.3f // override the damping ratio
onUpdate { spring, value, velocity ->
// the update listener that associated with TRANSLATION_X
}
}
.translationY(200f) {
onUpdate { spring, value, velocity ->
// the update listener that associated with TRANSLATION_Y
}
onEnd { spring, canceled, value, velocity ->
// the end listener that associated with TRANSLATION_Y
}
}
.setListener(
onEnd = {
// the end listener will be called when all animations end
}
)This library is inspired by the talk: Motional Intelligence: Build Smarter Animations (Google I/O'19)
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Copyright 2019 Mao Yufeng
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.