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

https://github.com/codecademy/cclistview

CCListView is a highly customizable sequential view container.
https://github.com/codecademy/cclistview

Last synced: 8 months ago
JSON representation

CCListView is a highly customizable sequential view container.

Awesome Lists containing this project

README

          

CCListView
===

[![Pod Version](http://img.shields.io/cocoapods/v/CCListView.svg?style=flat)](http://cocoadocs.org/docsets/CCListView/)
[![Pod Platform](http://img.shields.io/cocoapods/p/CCListView.svg?style=flat)](http://cocoadocs.org/docsets/CCListView/)
[![Pod License](http://img.shields.io/cocoapods/l/CCListView.svg?style=flat)](http://cocoadocs.org/docsets/CCListView/)
[![Travis Build Status](http://img.shields.io/travis/Codecademy/CCListView.svg?style=flat)](https://travis-ci.org/Codecademy/CCListView)

**CCListView** is a highly customizable sequential view container. It can be configured to:

* optionally scroll contained content
* arrange content horizontally or vertically

You can build **CCListViews** that contain **CCListViews** (that contain **CCListViews**...) and they even support scrolling views within scrolling views.

![screenshot1](https://github.com/Codecademy/CCListView/blob/master/Screenshots/screenshot1.png?raw=true)

Installation
---
**CCListView** is available through **[cocoapods](http://cocoapods.org)**, to install simple add the following line to your `PodFile`:

``` ruby
pod "CCListView"
```

Alternatively you can clone the **[github repo](https://github.com/Codecademy/CCListView)**.

Setup
---
Once you've installed the class:

* Include the CCListView header

``` objective-c
#import
```

* From there you can either create your CCListView instance in Interface Builder (for now will default to vertical content and scrolling enabled) or in code by using:

``` objective-c
CCListView *listView = [ [CCListView alloc] initWithFrame:(CGRect)frame horizontal:(BOOL)horizontal scrolling:(BOOL)scrolling];
```

Passing `YES` into `horizontal` will result in content being arranged horizontally left to right, passing `NO` will result in content being arranged vertically from top to bottom.

Passing `YES` into `scrolling` will enable scrolling within your list view, passing `NO` will disable scrolling.

* From here you can add, insert, and remove content views as well as customize further behaviors of the list view. For now please check out the class interface declared in `CCListView.h` to learn what's available!

Contributing
---
**CCListView** is a simple utility class, as such the class interface has largely been built out of need. If you have any ideas, suggestions or bugs to report please [create an issue](https://github.com/Codecademy/CCListView/issues/new) labeled *feature* or *bug* (check to see if the issue exists first please!). Or suggest a pull request!