Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ramotion/garland-view-android
:octocat: ≡ GarlandView seamlessly transitions between multiple lists of content. Made by @Ramotion
https://github.com/ramotion/garland-view-android
android animation component java library material-design ui
Last synced: 21 days ago
JSON representation
:octocat: ≡ GarlandView seamlessly transitions between multiple lists of content. Made by @Ramotion
- Host: GitHub
- URL: https://github.com/ramotion/garland-view-android
- Owner: Ramotion
- License: mit
- Created: 2017-08-11T15:28:38.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2020-04-06T13:37:14.000Z (over 4 years ago)
- Last Synced: 2024-10-15T09:01:44.985Z (21 days ago)
- Topics: android, animation, component, java, library, material-design, ui
- Language: Java
- Homepage: https://www.ramotion.com/garland-view-android/
- Size: 15.7 MB
- Stars: 1,835
- Watchers: 60
- Forks: 255
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
GARLAND VIEW [JAVA]
Garland View seamlessly transitions between multiple lists of content
___
We specialize in the designing and coding of custom UI for Mobile Apps and Websites.
Stay tuned for the latest updates:
[](http://twitter.com/Ramotion)
[](https://paypal.me/Ramotion)
# Check this library on other platforms:
## Requirements
- Android 4.4 KitKat (API lvl 19) or greater
- Your favorite IDE
## Installation
Just download the package from [here](http://central.maven.org/maven2/com/ramotion/garlandview/garland-view/0.3.3/garland-view-0.3.3.aar) and add it to your project classpath, or just use the maven repo:
Gradle:
```groovy
compile 'com.ramotion.garlandview:garland-view:0.3.3'
```
SBT:
```scala
libraryDependencies += "com.ramotion.garlandview" % "garland-view" % "0.3.3"
```
Maven:
```xml
com.ramotion.garlandview
garland-view
0.3.3
```
## Basic usage
`GarlandView` consists of classes for inner items that are scrolled vertically
and outer items that are scrolled horizontally, and each of which contains
one inner item.
First of all, you need to implement the classes necessary to create internal items: InnerItem and InnerAdapter.
`InnerAdapter` is an abstract class inherited from RecyclerView.Adapter.
It works only with InnerItem - ViewHolder.
In `InnerItem`, you need to override the `getInnerLayout` method, which must return
the main layout of the inner item.
Next, you need to override the classes required for external items: `HeaderItem` and` HeaderAdapter`.
`HeaderAdapter` is an abstract class inherited from RecyclerView.Adapter,
It works only with HeaderItem - ViewHolder.
In `HeaderItem`, you need to redefine 4 methods:` getHeader`, `getHeaderAlphaView`,` isScrolling`, `getViewGroup`.
The method `getViewGroup` should return InnerRecyclerView.
The `isScrolling` method must return the InnerRecyclerView's scrolling state.
The `getHeaderAlpha` method should return an alpha-layout, which will be used for dimming (hiding header's views).
The `getHeader` method must return the main layout of the header, an outer item.
Finally, place `TailRecyclerView` in the Activity's layout. Next, create a TailLayoutManager and
specify it as a LayoutManager for `TailRecyclerView`.
Here are the attributes of `TailRecyclerView` you can specify in the XML layout:
* `itemStart` - Outer item left and right offset size.
* `itemGap` - Distance between outer items.
## 🗂 Check this library on other language:
## 📄 License
Garland View Android is released under the MIT license.
See [LICENSE](./LICENSE) for details.
This library is a part of a selection of our best UI open-source projects
If you use the open-source library in your project, please make sure to credit and backlink to www.ramotion.com
## 📱 Get the Showroom App for Android to give it a try
Try this UI component and more like this in our Android app. Contact us if interested.
