CNGridView is a (wanna be) replacement for NSCollectionView. It has full delegate and dataSource support with method calls like known from NSTableView/UITableView.
Objective-C Other
Switch branches/tags
Latest commit 4a37e83 Apr 7, 2017
phranck Merge pull request #9 from keefo/master
optimize arrangeGridViewItemsAnimated: method

ReadMe.md

Flattr this git repo Travis Status

Overview

CNGridView is a (wanna be) replacement for NSCollectionView. It has full delegate and dataSource support with method calls just like known from NSTableView and UITableView.

The main inspiration to develop this control came fom @JustSid who wrote the JUCollectionView. But CNGridView was written from ground up, it uses ARC and has a bunch of properties to customize its layout and behavior. CNGridView was only testet on 10.7 Lion & 10.8 Mountain Lion.

Here is a shot of the included example application:

CNGridView Example Application

Usage

To use CNGridView the easy work is done in a few steps:

  • open InterfaceBuilder and select your NIB file that should contain the grid view
  • drag a NSScrollView to your target view, and set the class of NSScrollView's content view to CNGridView
  • connect the delegate & dataSource
  • implement all required delegate/dataSource methods and fill it with appropriate content.

Now you have a fully functionable grid view. Please take a look at the example.

Contribution

The code is provided as-is, and it is far off being complete or free of bugs. If you like this component feel free to support it. Make changes related to your needs, extend it or just use it in your own project. Pull-Requests and Feedbacks are very welcome. Just contact me at [phranck@cocoanaut.com](mailto:phranck@cocoanaut.com?Subject=[CNGridView] Your component on Github) or send me a ping on Twitter @TheCocoaNaut.

Documentation

The complete documentation you will find on CocoaDocs.

License

This software is published under the MIT License.

Software that uses CNGridView

If you like this component and if you're using it in your own software so please let me know. I'll give you a mention and set a link to your website (or the Mac App Store, if it exists).

CNGridView is used by this software:

  • Unbound - Unbound is a faster, simpler photo manager.
  • TunesBar+ - TunesBar+ simply sits in your menubar and tells you what track is currently playing in iTunes.