Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pranavpandey/dynamic-motion
Provide additional functionality to Android MotionLayout.
https://github.com/pranavpandey/dynamic-motion
android animation constraint layout library motion view-pager
Last synced: 2 months ago
JSON representation
Provide additional functionality to Android MotionLayout.
- Host: GitHub
- URL: https://github.com/pranavpandey/dynamic-motion
- Owner: pranavpandey
- License: apache-2.0
- Created: 2018-11-03T18:54:44.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-12-07T16:22:23.000Z (about 1 year ago)
- Last Synced: 2024-04-13T21:55:48.018Z (9 months ago)
- Topics: android, animation, constraint, layout, library, motion, view-pager
- Language: Java
- Homepage: https://dynamic.pranavpandey.com
- Size: 6.75 MB
- Stars: 37
- Watchers: 8
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Dynamic Motion
[](https://www.apache.org/licenses/LICENSE-2.0.html)
[](https://travis-ci.org/pranavpandey/dynamic-motion)
[](https://search.maven.org/artifact/com.pranavpandey.android/dynamic-motion)
A library to provide additional functionality for [MotionLayout][motion-layout] on
Android 4.3 (API 18) and above.
> Since v1.0.0, it is dependent on Java 8.
Since v1.1.0, it is targeting Java 17 to provide maximum compatibility.
Since v1.2.0, the minimum SDK is Android 4.4 (API 19) to comply with the latest policies.
It has `DynamicMotionLayout` which has a built-in `ViewPager` to create parallax effects which will
open a huge set of possibilities for the original `MotionLayout`.
---
## Contents
- [Installation](#installation)
- [Usage](#usage)
- [Replace](#replace)
- [Page count](#page-count)
- [Motion scene](#motion-scene)
- [License](#license)
---
## Installation
It can be installed by adding the following dependency to your `build.gradle` file:
```groovy
dependencies {
implementation 'com.pranavpandey.android:dynamic-motion:1.2.0'
}
```
---
## Usage
It is divided into 3 simple steps and whole layout can be configured by just using the `xml` files.
> For a complete reference, please read the [documentation][documentation].
### Replace
First, replace the original `MotionLayout` with `DynamicMotionLayout` in `xml` file.
```xml
...
```
### Page count
Set page count for `ViewPager` to divide the `transition` between different pages.
```xml
...
```
```java
// At runtime
dynamicMotionLayout.setPageCount(int, @Nullable ViewPager2.OnPageChangeCallback);
```
### Motion scene
Add a motion scene and use `KeyFrameSet` and `KeyAttribute` to animate the views across different
pages. Please check the [sample][sample] for a [demo scene][demo scene].
```xml
...
```
---
## Author
Pranav Pandey
[](https://github.com/pranavpandey)
[](https://twitter.com/intent/follow?screen_name=pranavpandeydev)
[](https://paypal.me/pranavpandeydev)
---
## License
Copyright 2018-2024 Pranav Pandey
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.
[documentation]: https://pranavpandey.github.io/dynamic-motion
[motion-layout]: https://developer.android.com/reference/android/support/constraint/motion/MotionLayout
[sample]: ./sample
[demo scene]: ./sample/src/main/res/xml/motion_scene.xml