/BeautifulParallax

Beautify your RecyclerViews with a great parallax effect !

Primary LanguageJavaApache License 2.0Apache-2.0

BeautifulParallax

Android Arsenal

Beautify your RecyclerViews with a great parallax effect !

Android app on Google Play

gif

##RecyclerView

First, add a Carpaccio tags to your View, then add a com.github.florent37.beautifulparallax.ParallaxViewController

You can now use registerImageParallax() in your carpaccio tags

    <com.github.florent37.carpaccio.Carpaccio
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:app="http://schemas.android.com/apk/res-auto"
        android:id="@+id/carpaccio"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:register="
            com.github.florent37.carpaccio.controllers.CommonViewController;
            com.github.florent37.carpaccio.controllers.ImageViewController;
            com.github.florent37.carpaccio.controllers.TextViewController;
            com.github.florent37.beautifulparallax.ParallaxViewController;
        ">

        <android.support.v7.widget.RecyclerView
                    android:layout_width="match_parent"
                    android:layout_height="match_parent"
                    android:tag="
                        registerImageParallax();
                        adapter(object,cell_sample);
                " />

    <com.github.florent37.carpaccio.Carpaccio>
  • 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 : imageParallax()

    <FrameLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:clipChildren="true"
        android:clipToPadding="true">

        <!-- this image must be higher than the cell, to enable parallax ! -->

        <ImageView
            android:layout_width="match_parent"
            android:layout_height="250dp"
            android:scaleType="centerCrop"
            android:tag="
                imageParallax();
                url($object.backgroundUrl);
            " />

    </FrameLayout>

#Download

Add into your build.gradle

Download

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

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

#Dependencies

Carpaccio : Data Mapping and Smart views for Android

NineOldAndroid : 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/

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.