easyandroid / android-parallax-recyclerview

An adapter which could be used to achieve a parallax effect on RecyclerView.

android-parallax-recycleview

USAGE

• Create your object list and pass it to the constructor of ParallaxRecyclerAdapter

   List<String> myContent = new ArrayList<String>(); //or another object list
   ParallaxRecyclerAdapter myAdapter = new ParallaxRecyclerAdapter(myContent); //pass the list to the constructor
  

• Implement ParallaxRecyclerAdapter.RecyclerAdapterMethods.

   myAdapter.implementRecyclerAdapterMethods(new ParallaxRecyclerAdapter.RecyclerAdapterMethods() {
                           @Override
                           public void onBindViewHolder(RecyclerView.ViewHolder viewHolder, int i) {
                                   //If you're using your custom handler (as you should of course) you need to cast viewHolder to it.
                                   ((MyCustomViewHolder) viewHolder).textView.setText(myContent.get(i)); //your bind holder routine.
                           }
  
                           @Override
                           public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup viewGroup, int i) {
                                   //Here is where you inflate your row and pass it to the constructor of your ViewHolder
                                   return new MyCustomViewHolder(LayoutInflater.from(viewGroup.getContext()).inflate(R.layout.myRow, viewGroup, false));
                           }
  
                           @Override
                           public int getItemCount() {
                                   //return the content of your array
                                   return myContent.size();
                           }
   });
  

• Now we set the parallax header. You need to pass the RecyclerView too to implement the scroll listeners.

   myAdapter.setParallaxHeader(LayoutInflater.from(this).inflate(R.layout.myParallaxView, myRecycler, false), myRecyclerView);
  

There a few other listeners you can implement:

     void onClick(View v, int position); //Event triggered when you click on a item of the adapter

     void onParallaxScroll(float percentage, float offset, View parallax); //Event triggered when the parallax is being scrolled.

License

Copyright (c) 2011 Pedro Oliveira

Licensed under the Apache License, Version 2.0