Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ca-archived/ambtableviewcontroller
Storyboard and Prototype Cells-centric block-based UITableView controller to manage complex layouts.
https://github.com/ca-archived/ambtableviewcontroller
dynamic-cells ios prototype-cell storyboard uitableviewcontroller
Last synced: 5 days ago
JSON representation
Storyboard and Prototype Cells-centric block-based UITableView controller to manage complex layouts.
- Host: GitHub
- URL: https://github.com/ca-archived/ambtableviewcontroller
- Owner: ca-archived
- License: apache-2.0
- Created: 2014-07-15T03:00:51.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2023-06-26T22:32:16.000Z (over 1 year ago)
- Last Synced: 2024-10-29T07:19:28.445Z (18 days ago)
- Topics: dynamic-cells, ios, prototype-cell, storyboard, uitableviewcontroller
- Language: Objective-C
- Homepage: http://cyberagent.github.io/AMBTableViewController
- Size: 8.32 MB
- Stars: 365
- Watchers: 33
- Forks: 26
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
AMBTableViewController
======================
Storyboard and Prototype Cells-centric block-based UITableView controller to manage complex layouts.
[](http://cocoadocs.org/docsets/AMBTableViewController/)
[](http://cocoadocs.org/docsets/AMBTableViewController/)
[](http://cocoadocs.org/docsets/AMBTableViewController/)
[](https://www.versioneye.com/objective-c/AMBTableViewController)
[](https://travis-ci.org/CyberAgent/AMBTableViewController)
_Developed as part of [Pecolly iOS](https://itunes.apple.com/us/app/pecolly-cooking-community/id544605228?mt=8)._
## Demo
A demo project is [included](Demo) in the repository.
## Features
- Use Storyboards' Prototype Cells to design your cells.
- Separate table code with [`AMBTableViewSection`](Source/AMBTableViewController.h#L149)'s.
- Use blocks instead of delegate calls and avoid having section code separated through multiple methods.
- Individual hide/shown, add/remove sections and rows.
- Support for dynamic height cells.
- Support for special "No Content Cell"'s for empty sections.
 
## Installation
Add the following to your [CocoaPods](http://cocoapods.org)' [Podfile](http://guides.cocoapods.org/syntax/podfile.html):
```ruby
platform :ios, '8.0'
use_frameworks!
pod 'AMBTableViewController'
```
## Documentation
http://cocoadocs.org/docsets/AMBTableViewController/
## Sample Code
Part of the included [demo project](Demo/TableDemo/PEPhotosDetailViewController.m#L24).
### Creating and configuring sections
A section with a single "static" cell of custom height:
```obj-c
footerSection = [AMBTableViewSection
sectionWithObjects:@[[AMBCellIdentifier identifierFromString:@"footer"]]
sectionUpdateBlock:NULL
cellHeightBlock:^CGFloat(id object, NSIndexPath * indexPath) { return 120.0; }
cellIdentifierBlock:NULL
cellConfigurationBlock:NULL];
```
A section with a single "static" cell hidden when post is `nil`:
```obj-c
writeSection = [AMBTableViewSection
sectionWithObjects:@[[AMBCellIdentifier identifierFromString:@"write_comment"]]
sectionUpdateBlock:^(AMBTableViewSection * section)
{
section.hidden = (weakSelf.post == nil);
}
cellHeightBlock:NULL
cellIdentifierBlock:NULL
cellConfigurationBlock:NULL];
```
A section with a single row of one of two kinds:
```obj-c
authorSection = [AMBTableViewSection
sectionWithObjects:@[@"author_cell"]
sectionUpdateBlock:^(AMBTableViewSection * section)
{
[section reloadObjectAtIndex:0];
}
cellHeightBlock:NULL
cellIdentifierBlock:^NSString *(id object, NSIndexPath *indexPath)
{
BOOL ownPost = [weakSelf.post.authorName isEqualToString:@"Me"];
return ownPost ? @"author_self" : @"author_other";
}
cellConfigurationBlock:^(id object,
UITableViewCell * cell,
NSIndexPath * indexPath)
{
PEPhotosDetailAuthorCell * authorCell = (PEPhotosDetailAuthorCell *)cell;
authorCell.authorLabel.text = weakSelf.post.authorName;
}],
```
A section with hideable cells:
```obj-c
NSArray * sectionObjects = @[[AMBCellIdentifier identifierFromString:@"title"], // 0
[AMBCellIdentifier identifierFromString:@"image"], // 1
[AMBCellIdentifier identifierFromString:@"tags"], // 2
[AMBCellIdentifier identifierFromString:@"recipe"]]; // 3
topSection = [AMBTableViewSection
sectionWithObjects:sectionObjects
sectionUpdateBlock:^(AMBTableViewSection *section)
{
[section reloadObjectAtIndex:0];
}
cellHeightBlock:^CGFloat(id object,
NSIndexPath * indexPath)
{
switch ([sectionObjects indexOfObject:object]) // Shouldn't use indexPath.row because we hide/show rows
{
case 0:
return 40.0;
case 1:
return 160.0;
case 3:
return 170.0;
default:
return -1.0; // Table view's default height
}
}
cellIdentifierBlock:NULL
cellConfigurationBlock:^(id object,
UITableViewCell * cell,
NSIndexPath * indexPath)
{
switch ([sectionObjects indexOfObject:object]) // Shouldn't use indexPath.row because we hide/show rows
{
case 0:
{
PEPhotosDetailTitleCell * titleCell = (PEPhotosDetailTitleCell *)cell;
titleCell.titleLabel.text = weakSelf.post.title;
break;
}
case 1:
{
//PEPhotosDetailImageCell * imageCell = (PEPhotosDetailImageCell *)cell;
break;
}
}
}];
// Initial state
[topSection setObjectsAtIndexes:[NSIndexSet indexSetWithIndexesInRange:NSMakeRange(2, 2)]
hidden:YES];
```
A section with a dynamic number of cells of dynamic height and a special "no content cell":
```obj-c
commentsSection = [AMBTableViewSection
sectionWithObjects:@[[AMBCellIdentifier identifierFromString:@"loading_comments"]]
sectionUpdateBlock:NULL
cellHeightBlock:^CGFloat(id object,
NSIndexPath * indexPath)
{
if ([object isKindOfClass:[AMBCellIdentifier class]])
{
return -1.0; // Loading comments (default height)
}
if (!object)
{
return 88.0; // No content cell
}
// Dynamic height comments
return [weakSelf heightForResizableCellWithIdentifier:@"comment"
text:object
limitedToNumberOfLines:0];
}
cellIdentifierBlock:^NSString *(id object,
NSIndexPath * indexPath)
{
return (object ? @"comment" : // A comment
@"no_comments"); // No content cell
}
cellConfigurationBlock:^(id object,
UITableViewCell * cell,
NSIndexPath * indexPath)
{
if ([cell isKindOfClass:[PEPhotosDetailCommentCell class]] &&
[object isKindOfClass:[NSString class]])
{
((PEPhotosDetailCommentCell *)cell).bodyLabel.text = (NSString *)object;
}
}];
// Enable "no content cell"
commentsSection.presentsNoContentCell = YES;
```
### Configuring the initial table configuration
```obj-c
tableViewController.sections = @[topSection,
authorSection,
writeSection,
commentsSection,
footerSection];
```
### Updating the table
Updating all sections:
```obj-c
- (void)setPost:(PEPost *)post
{
_post = post;
[self updateAllSections];
}
```
Toggling rows:
```obj-c
- (IBAction)toggleDetails:(id)sender
{
// Hide if all hiddeable rows are hidden, show all otherwise
[topSection setObjectsAtIndexes:[NSIndexSet indexSetWithIndexesInRange:NSMakeRange(1, 3)]
hidden:(![topSection isObjectAtIndexHidden:1] &&
![topSection isObjectAtIndexHidden:2] &&
![topSection isObjectAtIndexHidden:3])];
}
```
## License
Copyright (c) 2014-2017 CyberAgent Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.