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 class by Nick Lockwood
Sample Screenshot (better viewed in the iOS demo project.)
These are sample layout of the same UIView list automatically laid out by this class.
How to use
.h/.mfiles from the
Classesfolder into your code base
Or you can use Cocoapods, add the following line into your Podfile
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:
onDoubleTap. Each block call is supplied with the gesture-recognized UIView and its index corresponding to the index in the
This is the delegate protocol needed by
BDDynamicGridViewController. All methods are required to implement.
-numberOfViewsreturns the total count of UIViews to display.
-viewAtIndex:returns a UIView at an index specified.
-maximumViewsPerCellreturns the maximum number of UIViews per row.
BDDynamicGridViewControlleruses this method to determine how many UIViews it can fill in each row at the most.
BDDynamicGridViewControllercalls this method in order to set each row's height. The supplied
rowInfocontains the information useful for the delegate to decide on the row height, such as, the number of UIViews contained in this row, etc.
- 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, add the following line into your Podfile
Check out the iPhone demo. Read the comments. Send me questions, if any.
Apps using BDDynamicGridViewController
- Photosophia iOS for Flickr Groups (Shameless plug :)
- Please let me know of your apps so I can extend this list. Thanks!
BDDynamicGridViewController is licensed under BSD. More info in LICENSE file.