)
Automates preheating (prefetching) of content in UITableView and UICollectionView.
Deprecated on iOS 10. This library is similar to
UITableViewDataSourcePrefetchingandUICollectionViewDataSourcePrefetchingadded in iOS 10 which I would recommend to use instead.
One way to use Preheat is to improve user experience in applications that display collections of images. Preheat allows you to detect which cells are soon going to appear on the display, and prefetch images for those cells. You can use Preheat with any image loading library, including Nuke which it was designed for.
The idea of automating preheating was inspired by Apple’s Photos framework example app.
Getting Started
- See Image Preheating Guide
- Check out example project for Nuke
Usage
Here is an example of how you might implement preheating in your application using Preheat and Nuke:
import Preheat
import Nuke
class PreheatDemoViewController: UICollectionViewController {
let preheater = Nuke.Preheater()
var controller: Preheat.Controller<UICollectionView>?
override func viewDidLoad() {
super.viewDidLoad()
controller = Preheat.Controller(view: collectionView!)
controller?.handler = { [weak self] addedIndexPaths, removedIndexPaths in
self?.preheat(added: addedIndexPaths, removed: removedIndexPaths)
}
}
func preheat(added: [IndexPath], removed: [IndexPath]) {
func requests(for indexPaths: [IndexPath]) -> [Request] {
return indexPaths.map {
var request = Request(url: photos[$0.row])
request.priority = .low
return request
}
}
preheater.startPreheating(with: requests(for: added))
preheater.stopPreheating(with: requests(for: removed))
}
override func viewDidAppear(animated: Bool) {
super.viewDidAppear(animated)
controller?.enabled = true
}
override func viewDidDisappear(animated: Bool) {
super.viewDidDisappear(animated)
// When you disable preheat controller it removes all preheating
// index paths and calls its handler
controller?.enabled = false
}
}
Requirements
- iOS 8.0 / tvOS 9.0
- Xcode 9
- Swift 4
Installation
CocoaPods
To install Preheat add a dependency to your Podfile:
# source 'https://github.com/CocoaPods/Specs.git'
# use_frameworks!
# platform :ios, "8.0"
pod "Preheat"
Carthage
To install Preheat add a dependency to your Cartfile:
github "kean/Preheat"
Import
Import installed modules in your source files
import Preheat
License
Preheat is available under the MIT license. See the LICENSE file for more info.
708 Nov 17, 2022
90 Jun 9, 2022
1.2k Jan 5, 2023
132 Sep 8, 2021
0 Jan 10, 2022
278 Apr 14, 2022
12.5k Jan 1, 2023
172 Dec 26, 2022
308 Jan 6, 2023
325 Oct 11, 2022
4.3k Dec 27, 2022
157 Nov 25, 2022
0 Jan 11, 2022
7 Nov 24, 2022
109 Dec 27, 2022
88 Jun 30, 2022
96 Dec 26, 2022