Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 5 days ago
JSON representation
Android ListView that mimics a GridView with asymmetric items. Supports items with row span and column span
- Host: GitHub
- URL: https://github.com/felipecsl/asymmetricgridview
- Owner: felipecsl
- License: mit
- Created: 2014-04-08T19:25:37.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2018-10-13T16:11:11.000Z (almost 6 years ago)
- Last Synced: 2024-09-30T17:41:23.820Z (5 days ago)
- Language: Java
- Homepage: http://felipecsl.com/AsymmetricGridView
- Size: 4.65 MB
- Stars: 1,840
- Watchers: 85
- Forks: 431
- Open Issues: 35
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# AsymmetricGridView
[](https://android-arsenal.com/details/1/1186)
[](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)
[](https://play.google.com/store/apps/details?id=com.felipecsl.asymmetricgridview.app)
### Screenshots:
### 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).