An open API service indexing awesome lists of open source software.

https://github.com/florent37/BeautifulParallax

Beautify your RecyclerViews with a great parallax effect !
https://github.com/florent37/BeautifulParallax

Last synced: 6 months ago
JSON representation

Beautify your RecyclerViews with a great parallax effect !

Awesome Lists containing this project

README

          

# BeautifulParallax


Android app on Google Play

[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-BeautifulParallax-brightgreen.svg?style=flat)](http://android-arsenal.com/details/1/2257)

Beautify your RecyclerViews with a great parallax effect !

[![gif](https://github.com/florent37/BeautifulParallax/blob/master/screens/giphy.gif)](https://youtu.be/EE0rTgFg2t4)

# Without Carpaccio

```java
public class YOURAdapter extends RecyclerView.Adapter {

ParallaxViewController parallaxViewController = new ParallaxViewController();

@Override
public void onAttachedToRecyclerView(RecyclerView recyclerView) {
super.onAttachedToRecyclerView(recyclerView);
parallaxViewController.registerImageParallax(recyclerView);
}

@Override
public YOURViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.your_view, parent, false);
YOURViewHolder yourViewHolder = new YOURViewHolder(view);
parallaxViewController.imageParallax(yourViewHolder.yourImageView());
return yourViewHolder;
}

}
```

# Carpaccio

## RecyclerView

First, add a [Carpaccio tags](http://www.github.com/florent37/Carpaccio) to your View, then add a com.github.florent37.beautifulparallax.ParallaxViewController

You can now use registerImageParallax() in your [carpaccio tags](http://www.github.com/florent37/Carpaccio)

```xml

```

* ImageViewController : enable mapping POJO with url($object.backgroundUrl)
* TextViewController : enable mapping POJO with setText($object.title)
* CommonViewController : enable mapping a POJO List with adapter(object,R.layout.cell)

## Cell

In your viewholder/cell, just add in your [carpaccio tags](http://www.github.com/florent37/Carpaccio) : imageParallax()

```xml

```

# Download

Add into your **build.gradle**

[![Download](https://api.bintray.com/packages/florent37/maven/BeautifulParallax/images/download.svg)](https://bintray.com/florent37/maven/BeautifulParallax/_latestVersion)

```groovy
compile ('com.github.florent37:beautifulparallax:1.0.0@aar'){
transitive=true
}

compile ('com.github.florent37:Carpaccio:(CARPACCIO LAST VERSION)@aar'){
transitive=true
}
```

# Dependencies

[Carpaccio](http://www.github.com/florent37/Carpaccio) : Data Mapping and Smart views for Android

[NineOldAndroid](nineoldandroids.com) : Android library for using the Honeycomb (Android 3.0) animation API on all versions of the platform back to 1.0!

# Community

Looking for contributors, feel free to fork !

Tell me if you're using my library in your application, I'll share it in this README

# Credits

Author: Florent Champigny
www.florentchampigny.com/


Android app on Google Play


Follow me on Google+


Follow me on Twitter


Follow me on LinkedIn

License
--------

Copyright 2015 florent37, Inc.

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.