https://github.com/andyb129/zigzagrecyclerview
A library that gives you a slant on the traditional Grid Recycler View :recycle:
https://github.com/andyb129/zigzagrecyclerview
picasso recyclerview slant zigzag-recycler
Last synced: 2 months ago
JSON representation
A library that gives you a slant on the traditional Grid Recycler View :recycle:
- Host: GitHub
- URL: https://github.com/andyb129/zigzagrecyclerview
- Owner: andyb129
- Created: 2018-02-18T22:26:16.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-01-04T23:10:16.000Z (almost 6 years ago)
- Last Synced: 2025-04-14T22:09:04.163Z (6 months ago)
- Topics: picasso, recyclerview, slant, zigzag-recycler
- Language: Java
- Homepage:
- Size: 3.88 MB
- Stars: 27
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Zigzag Recycler View
[]( https://android-arsenal.com/details/1/6794 )
A library that gives you a slant on the traditional Grid Recycler View!
* Use a traditional RecyclerView (& just apply the ZigzagGridRecyclerViewAdapter)
* Load list of images from your own objects (implement ZigzagImage)
* Change the background colour of the dividers
### Setup
To use **Zigzag Recycler View** in your projects, simply add the library as a dependency to your build.
##### Gradle
```
dependencies {
implementation 'uk.co.barbuzz:zigzagrecyclerview:0.0.3'
}
```
##### Maven
```
uk.co.barbuzz.zigzagrecyclerviewadapter
zigzagrecyclerview
0.0.3
pom
```
Alternatively you can directly import the /library project into your Android Studio project and add it as a dependency in your build.gradle.
The library is currently configured to be built via Gradle only. It has the following dependencies:
* Support library - com.android.support:appcompat-v7:26.1.0
* Recyclerview-v7 - com.android.support:recyclerview-v7:26.1.0
* Picasso 2.3.2 - com.squareup.picasso:picasso:2.5.2
* Compiled SDK Version - Oreo-26
* Minimum SDK Version - >= Lollipop-21
### Usage
For more detailed code example to use the library, Please refer to the `/sample` app.
**ZigzagGridRecyclerViewAdapter** can be used with a standard RecyclerView. Declare the RecyclerView as normal in your layout XML.
```
```
Make sure your class in the list that your passing into the RecylerView implements the ZigzagImage interface
(either returning a value for **getZigzagImageResourceId()** or **getZigzagImageUrl()** depending on how you supply your image data).
**NOTE:** images are loaded by the Picasso library at the moment
```
public class SnowImage implements ZigzagImage {
private int snowImageResourceId;
public SnowImage(int snowImageResourceId) {
this.snowImageResourceId = snowImageResourceId;
}
@Override
public String getZigzagImageUrl() {
return null;
}
@Override
public int getZigzagImageResourceId() {
return snowImageResourceId;
}
}
```
Then initialise the **RecyclerView** & **ZigzagGridRecyclerViewAdapter** in your activity as below.
```
LinearLayoutManager linearLayoutManager = new LinearLayoutManager(this);
ZigzagGridRecyclerViewAdapter zigzagGridRecyclerViewAdapter = new ZigzagGridRecyclerViewAdapter(this, imageList, this);
zigzagGridRecyclerViewAdapter.setBackgroundColourResId(getResources().getColor(R.color.separator));
RecyclerView zigzagRecyclerView = findViewById(R.id.zigzag_recycler_view);
zigzagRecyclerView.setLayoutManager(linearLayoutManager);
zigzagRecyclerView.setAdapter(zigzagGridRecyclerViewAdapter);
```
You can also **optionally** change the separator colour (defaults to white) or add a placeholder drawable resource for image loading.
```
zigzagGridRecyclerViewAdapter.setBackgroundColourResId(getResources().getColor(R.color.separator));
zigzagGridRecyclerViewAdapter.setPlaceholderDrawableResId(R.drawable.placeholder_image);
```
There is also an ZigzagListOnClickListener that can be implemented to define the behaviour when an image is clicked. Either add it as part of
the Adapter constructor (see above) or declare separably as below.
```
zigzagGridRecyclerViewAdapter.setZigzagListOnClickListener(new ZigzagGridRecyclerViewAdapter.ZigzagListOnClickListener() {
@Override
public void onZigzagImageClicked(int position, ZigzagImage zigzagImage) {
//onClick behaviour here
}
});
```
### TODO
1. Add a optional label to bottom of image
2. Allow change of the separator width
### Thanks
This library has been made by using the amazing library 'Oblique' below. So huge thanks to the author which this is based on.
* Oblique by [akshay2211](https://github.com/akshay2211) - [https://github.com/akshay2211/Oblique](https://github.com/akshay2211/Oblique)
### Licence
```
Copyright (c) 2018 Andy Barber
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.
```