Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Kilograpp/UITableView-Cache
UITableView cell cache that cures scroll-lags on cell instantiating
https://github.com/Kilograpp/UITableView-Cache
Last synced: 9 days ago
JSON representation
UITableView cell cache that cures scroll-lags on cell instantiating
- Host: GitHub
- URL: https://github.com/Kilograpp/UITableView-Cache
- Owner: Kilograpp
- License: mit
- Created: 2016-06-19T08:44:05.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-02-13T12:28:19.000Z (almost 8 years ago)
- Last Synced: 2024-10-02T09:05:26.670Z (2 months ago)
- Language: Objective-C
- Homepage:
- Size: 28.3 KB
- Stars: 72
- Watchers: 3
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - UITableView Cache - UITableView cell cache that cures scroll-lags on a cell instantiating. (Cache)
- awesome-ios-star - UITableView Cache - UITableView cell cache that cures scroll-lags on a cell instantiating. (Cache)
- fucking-awesome-ios - UITableView Cache - UITableView cell cache that cures scroll-lags on a cell instantiating. (Cache)
- fucking-awesome-ios - UITableView Cache - UITableView cell cache that cures scroll-lags on a cell instantiating. (Cache)
README
[](https://travis-ci.org/Kilograpp/UITableView-Cache)
[](http://cocoadocs.org/docsets/UITableView+Cache/)
[](https://codebeat.co/projects/github-com-kilograpp-uitableview-cache)
[](https://github.com/Kilograpp/UITableView-Cache)
# UITableView + Cache
[https://github.com/Kilograpp/UITableView-Cache](https://github.com/Kilograpp/UITableView-Cache)
UITableView cell cache that cures scroll-lags on a cell instantiating.
## Introduction
`UITableView+Cache` is a light `UITableView` category that purges scroll-lag that occurs on a new cell instantiation during scroll.
It makes UITableView instantiate and cache cells before cellForRow:atIndexPath: call. It also provides simple interface very similar to existing registerClass/registerNib one.
## Installation
### CocoaPods
``` batch
pod 'UITableView+Cache'
```
### Carthage
``` batch
github "Kilograpp/UITableView-Cache" "master"
```
### Manual importing
Just add all files from src directory to your project.
## Usage
When registering custom cells, call overriden registerClass/registerNib method instead of a default. `UITableView+Cache` swizzles dequeueReusableCellWithIdentifier methods with a private one that uses its own cache and implements registerClass/registerNib mechanism on itself.
When dequeueReusableCellWithIdentifier is called and returns nil - the cache is asked for a cell. If cache is empty then cell is created using registered class or nib.
#### Swift 3
``` swift
import UITableView_Cache
...
override func viewDidLoad() {
super.viewDidLoad()
self.tableView.registerClass(TableViewCodeCell.self, forCellReuseIdentifier: "MyReuseIdentifier", cacheSize: 10)
self.tableView.registerNib(TableViewCodeCell.nib, forCellReuseIdentifier: "MyReuseIdentifier", cacheSize: 10)
}
...
override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
let cell = self.tableView.dequeueReusableCellWithIdentifier("MyReuseIdentifier") as! TableViewCodeCell
return cell
}
```
#### Objective-C
``` objective-c
- (void)viewDidLoad {
[super viewDidLoad];
[self.tableView registerClass:[TableViewCodeCell class] forCellReuseIdentifier:@"MyReuseIdentifier" cacheSize:10];
[self.tableView registerNib:[TableViewNibCell nib] forCellReuseIdentifier:@"MyNibReuseIdentifier" cacheSize:10];
}
...
- (MyCell*)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
MyCell* cell = [tableView dequeueReusableCellWithIdentifier:@"MyReuseIdentifier"];
return cell;
}
```
Make sure to call dequeueReusableCellWithIdentifier:reuseIdentifier method and **NOT** dequeueReusableCellWithIdentifier:reuseIdentifier:**forIndexPath:** one. They perform different logic and a crash will occure on wrong method use.
#### Storyboards
Storyboards are not supported, cached cells should be registered from code.
Nevertheless, if you strongly require storyboard usage then you could swizzle basic UITableView's registerNib/registerClass methods for your own and call. But I won't recommend this solution for it tampers UITableView mechanism.
## Best Practises
As you know any cache consumes some memory. Best advice I could give is to keep track of your tableViews and free them as soon as possible. Having too many tableViews may cause memory pressure on your app.
## License
UITableView+Cache is available under the MIT license. See the LICENSE file for more info.
## Author
[Mehdzor](https://github.com/mehdzor)