Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/felipecsl/AsymmetricGridView

Android ListView that mimics a GridView with asymmetric items. Supports items with row span and column span
https://github.com/felipecsl/AsymmetricGridView

Last synced: about 2 months ago
JSON representation

Android ListView that mimics a GridView with asymmetric items. Supports items with row span and column span

Awesome Lists containing this project

README 

        
# AsymmetricGridView



[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-AsymmetricGridView-brightgreen.svg?style=flat)](https://android-arsenal.com/details/1/1186)

[![Build Status](https://travis-ci.org/felipecsl/AsymmetricGridView.svg?branch=master)](https://travis-ci.org/felipecsl/AsymmetricGridView)



An Android custom ListView that implements multiple columns and variable sized elements.



Please note that this is currently in a preview state.

This basically means that the API is not fixed and you should expect changes between releases.



## Sample application:



Try out the sample application on [Google Play](https://play.google.com/store/apps/details?id=com.felipecsl.asymmetricgridview.app)



[![Gplay](https://developer.android.com/images/brand/en_generic_rgb_wo_60.png)](https://play.google.com/store/apps/details?id=com.felipecsl.asymmetricgridview.app)



### Screenshots:



![screenshot 1](https://raw.githubusercontent.com/felipecsl/AsymmetricGridView/master/screenshots/ss_2_cols.png)

![screenshot 2](https://raw.githubusercontent.com/felipecsl/AsymmetricGridView/master/screenshots/ss_3_cols.png)

![screenshot 3](https://raw.githubusercontent.com/felipecsl/AsymmetricGridView/master/screenshots/ss_4_cols.png)

![screenshot 4](https://raw.githubusercontent.com/felipecsl/AsymmetricGridView/master/screenshots/ss_5_cols.png)



### Usage



Version 2.0.0 includes a major breaking change to the AsymmetricGridViewAdapter. You now provide

your own adapter to the AsymmetricGridViewAdapter constructor instead of extending it.



In your ``build.gradle`` file:



```groovy

dependencies {

    implementation 'com.felipecsl.asymmetricgridview:library:2.0.1'

}

```



In your layout xml:



```xml



```



In your activity class:



```java

@Override

protected void onCreate(Bundle savedInstanceState) {

    super.onCreate(savedInstanceState);

    setContentView(R.layout.activity_main);

    listView = (AsymmetricGridView) findViewById(R.id.listView);



    // Choose your own preferred column width

    listView.setRequestedColumnWidth(Utils.dpToPx(this, 120));

    final List items = new ArrayList<>();



    // initialize your items array

    adapter = new ListAdapter(this, listView, items);

    AsymmetricGridViewAdapter asymmetricAdapter =

        new AsymmetricGridViewAdapter<>(this, listView, adapter);

    listView.setAdapter(asymmetricAdapter);

}

```



Whenever your adapter changes (add or remove items), the grid will automatically reflect those

changes by subscribing to your adapter changes.



Toggle to enable/disable reordering of elements to better fill the grid



```java

// Setting to true will move items up and down to better use the space

// Defaults to false.

listView.setAllowReordering(true);



listView.isAllowReordering(); // true

```



Snapshots of the development version are available in [Sonatype's `snapshots` repository](https://oss.sonatype.org/content/repositories/snapshots/).



Works with Android 2.3.x and above.



### Caveats



* Currently only has good support for items with rowSpan = 2 and columnSpan = 2.

In the near future it will support different layout configurations.



* It will work best if you don't have too many items with different sizes. Ideally less

than 20% of your items are of special sizes, otherwise the library may not find the best

way to accommodate all the items without leaving a lot of empty space behind.



* Row layout is too complex, with many nested LinearLayouts. Move to a more flat layout

with a custom ViewGroup possibly.



### Contributing



* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet

* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it

* Fork the project

* Start a feature/bugfix branch

* Commit and push until you are happy with your contribution

* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.



### Copyright and license



Code and documentation copyright 2011-2015 Felipe Lima.

Code released under the [MIT license](https://github.com/felipecsl/AsymmetricGridview/blob/master/LICENSE.txt).