BeautifulParallax

Additional

Language
Java
Version
N/A
Created
Aug 6, 2015
Updated
Jan 4, 2018 (Retired)
Owner
Florent CHAMPIGNY (florent37)
Contributors
The Gitter Badger (gitter-badger)
Florent CHAMPIGNY (florent37)
Santiago Castro (bryant1410)
3
Activity
Badge
Generate
Download
Source code

BeautifulParallax

Beautify your RecyclerViews with a great parallax effect !

Without Carpaccio

public class YOURAdapter extends RecyclerView.Adapter<YOURViewHolder> {

    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 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

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/

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.