Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/norsez/BDDynamicGridViewController

Data-aware view-controller that displays a UIView list in an automatically laid out grid
https://github.com/norsez/BDDynamicGridViewController

Last synced: 2 months ago
JSON representation

Data-aware view-controller that displays a UIView list in an automatically laid out grid

Host: GitHub
URL: https://github.com/norsez/BDDynamicGridViewController
Owner: norsez
License: bsd-3-clause
Created: 2012-06-22T04:00:50.000Z (over 12 years ago)
Default Branch: master
Last Pushed: 2016-02-11T08:08:11.000Z (almost 9 years ago)
Last Synced: 2024-04-26T13:20:35.479Z (9 months ago)
Language: Objective-C
Homepage: https://github.com/norsez/BDDynamicGridViewController
Size: 3.57 MB
Stars: 554
Watchers: 66
Forks: 117
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome - BDDynamicGridViewController - Data-aware view-controller that displays a UIView list in an automatically laid out grid (etc)

README

        #BDDynamicGridViewController - Data-aware view-controller that displays a UIView list in an automatically laid out grid.

Data-aware view controller that displays a UIView list (typically, UIImageView list) in a row-dominated grid layout. This class automatically lay out the UIViews with help from a delegate class (which is supplier by you.) The class is inspired by the beautiful [iCarousel](https://github.com/nicklockwood/iCarousel) class by [Nick Lockwood](https://github.com/nicklockwood)

##Sample Screenshot (better viewed in the iOS demo project.)

These are sample layout of the same UIView list automatically laid out by this class.

[![](https://github.com/norsez/BDDynamicGridViewController/raw/master/BDDynamicGridViewDemo/screencap1.png)](https://github.com/norsez/BDDynamicGridViewController/raw/master/BDDynamicGridViewDemo/screencap1.png) [![](https://github.com/norsez/BDDynamicGridViewController/raw/master/BDDynamicGridViewDemo/screencap2.png)](https://github.com/norsez/BDDynamicGridViewController/raw/master/BDDynamicGridViewDemo/screencap2.png) [![](https://github.com/norsez/BDDynamicGridViewController/raw/master/BDDynamicGridViewDemo/screencap3.png)](https://github.com/norsez/BDDynamicGridViewController/raw/master/BDDynamicGridViewDemo/screencap3.png)

##How to use

###Installation 

- Copy `.h/.m` files from the `Classes` folder into your code base

- Or you can use Cocoapods, add the following line into your Podfile

    dependency 'BDDynamicGridViewController'

###Implementation

####`BDDynamicGridViewController`

This is the main view controller initialized using `init`. Subclassing is recommended. Once initialized, set a delegate class to it. It receives delegate of type `BDDynamicGridViewDelegate`. See next. 

One you have your delegate set up. Call `reloadData` to see the layout. Each call to `reloadData` creates a new layout.

Once the view is loaded. User can tap on each view. There are two gestures supported, namely, long press and double tap. These are configurable using blocks through the following properties: `onLongPress` and `onDoubleTap`. Each block call is supplied with the gesture-recognized UIView and its index corresponding to the index in the `-viewAtIndex` method.

####`BDDynamicGridViewDelegate`

This is the delegate protocol needed by `BDDynamicGridViewController`. All methods are required to implement.

- `-numberOfViews` returns the total count of UIViews to display.

- `-viewAtIndex:` returns a UIView at an index specified.

- `-maximumViewsPerCell` returns the maximum number of UIViews per row. `BDDynamicGridViewController` uses this method to determine how many UIViews it can fill in each row at the most.

- `-rowHeightForRowInfo` `BDDynamicGridViewController` calls this method in order to set each row's height. The supplied `rowInfo` contains the information useful for the delegate to decide on the row height, such as, the number of UIViews contained in this row, etc.

That's it!

##Requirements

- Tested on simulator for iOS 5.1, 6.1 and 7.0

- Requires ARC

##How to use

- Be sure to checkout the latest __tag__, as opposed to the latest commit. Only tagged points are stable.

- Include h/.m files in Classes folder to your source code

- or use [Cocoapods](https://github.com/CocoaPods/CocoaPods/), add the following line into your Podfile

    dependency 'BDDynamicGridViewController'

    

- Check out the iPhone demo. Read the comments. Send me questions, if any.

##Apps using BDDynamicGridViewController

- [Photosophia iOS for Flickr Groups](http://www.google.com/url?sa=t&rct=j&q=photosophia%20app&source=web&cd=4&cad=rja&ved=0CDYQFjAD&url=http%3A%2F%2Fitunes.apple.com%2Fus%2Fapp%2Fphotosophia-for-flickr-groups%2Fid530161971%3Fmt%3D8&ei=2DA8UPDzEcLsrAed3YGwAQ&usg=AFQjCNEqFsfzipOIXDlFn1gzTmcioNsV2A&sig2=4J9p4wXIWYC-rGLzF5LXbg) (Shameless plug :)

- Please let me know of your apps so I can extend this list. Thanks!

##License

BDDynamicGridViewController is licensed under BSD. More info in LICENSE file.