jidibingren / easytableview Goto Github PK

EasyTableView 2.0 - January 7, 2016

IMPORTANT NOTE: The API for EasyTableView has changed of January 6, 2016. So if you have been a consumer of EasyTableView prior to this date, you may find that this update breaks your existing projects. 


SUMMARY
=======

This project demonstrates the use of the EasyTableView class. The demo is intended to be run on an iPad only, but there is no reason why EasyTableView could not be used on an iPhone.

To use EasyTableView in your own project, all you need to include are the following files:

EasyTableView.h
EasyTableView.m

This was written before UICollectionView became available, but developers may still prefer to use EasyTableView for it’s simplicity.
 

DESCRIPTION
===========

EasyTableView was created to address two concerns. The first is the ability to have a table view, horizontal or vertical, that only partially fills the screen. Normally one would use UITableViewController but as per Apple documentation, that requires table views that fill the whole screen. EasyTableView addresses this problem by acting as the controller for the embedded table view, and exposes a subset of table view functionality with it's own delegate methods.
 
The second concern addressed by EasyTableView is horizontal table views. Table views were initially designed to be vertical only. EasyTableView solves this problem by rotating the table view, and then reverse rotating table view cells. One could also provide horizontally scrolling table views by subclassing UIScrollView, but I wanted to create one simple, common interface for creating both vertical EasyTableViews and horizontal EasyTableViews.

So now you can create simple partial-screen table views, either vertically or horizontally, all with the same interface.


USAGE
=====

To understand how to use EasyTableView, study the code in EasyTableViewController.m. To create a new EasyTableView object, look at the methods -(void)setupHorizontalView and -(void)setupVerticalView. Create a vertical scrolling table view with:

- (id)initWithFrame:(CGRect)frame ofHeight:(CGFloat)cellHeight;

To create a new horizontal scrolling table view use:

- (id)initWithFrame:(CGRect)frame ofWidth:(CGFloat)cellWidth;

For even simpler setup, look to see how to use EasyTableView with a storyboard in FlipsideViewController.m.

There are only two delegate methods that must be implemented as part of the EasyTableViewDelegate protocol:

- (NSInteger)easyTableView:(EasyTableView *)easyTableView numberOfRowsInSection:(NSInteger)section
- (UITableViewCell *)easyTableView:(EasyTableView *)easyTableView cellForRowAtIndexPath:(NSIndexPath *)indexPath

If you plan to setup an EasyTableView with multiple sections, you must implement the following delegate method:

- (NSUInteger)numberOfSectionsInEasyTableView:(EasyTableView*)easyTableView;

That's all there is to it. It is very easy to use. And yes, that is a picture of my tent!


KNOWN LIMITATIONS
=================
 
1. A horizontal EasyTableView will correctly auto-resize it's overall length. However a horizontal EasyTableView will NOT necessarily correctly auto-resize it's height.

2. Loading the Flickr catalog will sometimes fail due to JSON parsing errors. 


LICENSE
=======
EasyTableView is released under the New BSD License.

Copyright (c) 2010-2016, Yodel Code LLC
All rights reserved.