Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/jpardogo/ListBuddies

Android library to achieve in an easy way, the behaviour of the home page in the Expedia app, with a pair of auto-scroll circular parallax ListViews.
https://github.com/jpardogo/ListBuddies

android-library autoscroll expedia listview listviews

Last synced: about 2 months ago
JSON representation

Android library to achieve in an easy way, the behaviour of the home page in the Expedia app, with a pair of auto-scroll circular parallax ListViews.

Awesome Lists containing this project

README 

        
ListBuddies

===========



**This library is not maintained anymore and there will be no further releases**



Android library of a pair of auto-scroll circular parallax ListViews like the ones on the expedia app home page.



A video example of this library is on this [youtube video][1].  





 




I would appreciate any kind of help to improve this library. Thanks



Usage

-----



You must declare the following view in your xml layout:



```xml



```



There are a bunch of optional custom attributes:



```xml



```



If you prefere to create it dynamically use:



```java

    

    ListBuddiesLayout listBuddies = new ListBuddiesLayout(this);

    listBuddies.setGap(mMarginDefault)

                .setSpeed(ListBuddiesLayout.DEFAULT_SPEED)

                .setDividerHeight(mMarginDefault)

                .setGapColor(getResources().getColor(R.color.frame))

                .setAutoScrollFaster(mScrollConfig[ScrollConfigOptions.RIGHT.getConfigValue()])

                .setManualScrollFaster(mScrollConfig[ScrollConfigOptions.LEFT.getConfigValue()])

                .setDivider(getResources().getDrawable(R.drawable.divider));

    ((FrameLayout)findViewById(R.id.)).addView(listBuddies)

```



######Attributes



* `speed`: Sets the auto scroll speed (integer). 0 - no autoScroll

* `gap`: Space between the lists, the default gap is 3dp (@dimen/default_margin_between_lists).

* `gapColor`: Defines the color of the gap, if it is not set the gap is transparent

* `listDivider`: Defines the lists dividers.

* `listsDividerHeight`: Divider´s height.

* `autoScrollFaster`: Indicate the ListView that will be faster on the parrallax effect during autoScroll. right/left.

* `scrollFaster`: Indicate the ListView that will be faster on the parrallax effect during manual scroll. right/left.



This `LinearLayout` contains two ListViews. 

So we need to set the adapters of the ListViews calling `listBuddies.setAdapters(adapter1,adapter2)`. 

```java

    @Override

    public View onCreateView(LayoutInflater inflater, ViewGroup container,

                             Bundle savedInstanceState) {

        View rootView = inflater.inflate(R.layout.fragment_main, container, false);

        ListBuddiesLayout listBuddies = (ListBuddiesLayout) rootView.findViewById(R.id.listbuddies);

        CircularAdapter adapter = new CircularAdapter(getActivity(), getResources().getDimensionPixelSize(R.dimen.image_size1), ImagesUrls.imageUrls_left);

        CircularAdapter adapter2 = new CircularAdapter(getActivity(), getResources().getDimensionPixelSize(R.dimen.image_size2), ImagesUrls.imageUrls_right);

        listBuddies.setAdapters(adapter, adapter2);

        return rootView;

    }

```



Both adapters need to be extend from `CircularLoopAdapter`. With minimal differences from a BaseAdapter.



```java

    public class CircularAdapter extends CircularLoopAdapter

```

The first different is that the adapter needs to `@Override getCircularCount` instead of `getCount`.



```java

    @Override

    protected int getCircularCount() {

        return mItems.size();

    }

```



and instead of get the value of `position` to get the item from the list. We need to get the position calling `getCircularPosition(position)`, like this:



```java

    @Override

    public String getItem(int position) {

        return mItems.get(getCircularPosition(position));

    }

```



To receive the callback for the click on the items of the lists, Just call `setOnItemClickListener` on your `ListBuddiesLayout` view and pass and instance of `OnBuddyItemClickListener`.



```java

public class ListBuddiesFragment extends Fragment implements ListBuddiesLayout.OnBuddyItemClickListener

```

....



```java

listBuddies.setOnItemClickListener(this);

```

You will receive the OnItemClick callback in `onBuddyItemClicked` which is similar to `onItemClick` but indicate with the parameter `int buddy` in which of the lists the item clicked is contained.

if the value of `buddy` is 0 the item is on the first list (left) and if it is 1 is on the second list (right).



```java

@Override

    public void onBuddyItemClicked(AdapterView> parent, View view, int buddy, int position, long id) {

          //int buddy indicate the list where the item is contain.

          // 0 - left

          // 1 - right

    }

````



In order to receive touch feedback for the click of the list items, we need to have as a parent of our list item view one of the following layouts:



`com.jpardogo.listbuddies.lib.views.containers.FrameLayoutFeedback`

`com.jpardogo.listbuddies.lib.views.containers.RelativeLayoutFeedBack`

`com.jpardogo.listbuddies.lib.views.containers.LinearLayoutFeedBack`



This layouts have `selectorColor` property to define the color of the selector for the feedback. 



```xml



    

    .....

```



The color will need some transparency in order to act as the ListView selector:



```xml

#7733B5E5

````



Although it is just optional.



Including in your project

-------------------------



You can either add the library to your application as a library project or add the following dependency to your build.gradle:



![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.jpardogo.listbuddies/library/badge.svg)



```groovy

dependencies {

    compile 'com.jpardogo.listbuddies:library:(latest version)'

}

```



Developed By

--------------------



Javier Pardo de Santayana Gómez - 





  Follow me on Twitter





  Follow me on Google+





  Follow me on LinkedIn



License

-----------



    Copyright 2013 Javier Pardo de Santayana Gómez



    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.

    

[1]: https://www.youtube.com/watch?v=jgyMqlm_iDI

[2]: https://play.google.com/store/apps/details?id=com.jpardogo.android.listbuddies