ICycleView
ICycleView是一個基于UICollectionView實現(xiàn)的輕量級無限輪播圖
效果圖
Content
Features
- 支持單張圖片
- 支持滾動圖片寬度設(shè)置
- 支持本地圖片顯示己单，網(wǎng)路圖顯示，本地圖片和網(wǎng)路圖混合顯示
- 支持自定義圖片展示Cell（純代碼和Xib創(chuàng)建都支持）
- 支持UIPageControl具體位置設(shè)置
- 支持UIPageControl顯示顏色設(shè)置
- 支持圖片點(diǎn)擊回調(diào)
- 支持圖片滾動回調(diào)
Requirements
- iOS 8.0+
- Swift 4.0+
CocoaPods
pod 'ICycleView', '~> 1.0.0'
在終端 pod search 'ICycleView' 時若出現(xiàn) Unable to find a pod with name, author, summary, or description matching 'ICycleView' 錯誤
請在終端運(yùn)行
1：pod setup
2：$rm ~/Library/Caches/CocoaPods/search_index.json
Usage
默認(rèn)滾動視圖
效果圖
// 惰性初始化滾動視圖
lazy var defaultCycleView: ICycleView = {
let cycleView = ICycleView(frame: CGRect(x: 0, y: 50, width: UIScreen.main.bounds.width, height: 130*scaleForPlus))
view.addSubview(cycleView)
return cycleView
}()
// 圖片賦值
defaultCycleView.pictures = pictures
自定義圖片寬度和指示器的位置和顏色
效果圖
// 惰性初始化滾動視圖
lazy var customPagetrolPositionnCycleView: ICycleView = {
let cycleView = ICycleView(frame: CGRect(x: 0, y: 190, width: UIScreen.main.bounds.width, height: 130*scaleForPlus))
cycleView.imgViewWidth = 374*scaleForPlus
cycleView.pageIndicatorTintColor = .green
view.addSubview(cycleView)
return cycleView
}()
// 圖片賦值
customPagetrolPositionnCycleView.pictures = pictures
// pageControlStyle屬性必須在設(shè)置 pictures 后賦值臼隔，因為指示器是根據(jù) numberOfPages 計算Size的
customPagetrolPositionnCycleView.pageControlStyle = .bottom(bottom: -20)
customPagetrolPositionnCycleView.pageControlStyle = .right(trailing: 30*scaleForPlus)
自定義Cell-純代碼和Xib創(chuàng)建都支持
效果圖
// 惰性初始化滾動視圖
lazy var customPictureCellCycleView: ICycleView = {
let cycleView = ICycleView(frame: CGRect(x: 0, y: 345, width: UIScreen.main.bounds.width, height: 130*scaleForPlus))
cycleView.register([UINib.init(nibName: "CustomCycleViewCell", bundle: nil)], identifiers: ["CustomCell"])
cycleView.delegate = self
view.addSubview(cycleView)
return cycleView
}()
// 圖片賦值
customPictureCellCycleView.pictures = pictures
// 代理方法
/**
- 協(xié)議方法都是可選方法，根據(jù)需要實現(xiàn)即可
*/
// MARK: ICycleViewDelegate
extension ViewController: ICycleViewDelegate {
// 圖片點(diǎn)擊
func iCycleView(cycleView: ICycleView, didSelectItemAt index: Int) {
print("你點(diǎn)擊了第 \(index) 張圖片")
}
// 圖片自動滾動
func iCycleView(cycleView: ICycleView, autoScrollingItemAt index: Int) {
print("當(dāng)前滾動的圖片是第 \(index) 張")
}
// 自定義Cell
func iCycleView(cycleView: ICycleView, collectionView: UICollectionView, cellForItemAt indexPath: IndexPath, picture: String) -> UICollectionViewCell {
let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "CustomCell", for: indexPath) as! CustomCycleViewCell
cell.imgView.kf.setImage(with: URL(string: picture))
cell.titleLab.text = "自定義Cell\n第 \(indexPath.item) 張圖片"
return cell
}
}
Implementation
實現(xiàn)原理
- collectionView的cell顯示兩倍數(shù)量的圖片，展示圖片分為兩組杜窄，默認(rèn)顯示第二組的第一張
- 左滑collectionView到第二組最后一張侄旬，即最后一個cell時，設(shè)置scrollView的contentOffset顯示第一組的最后一張加矛，繼續(xù)左滑履婉，實現(xiàn)了無限左滑
- 右滑collectionView到第一組第一張，即第一cell時斟览，設(shè)置scrollView的contentOffset顯示第二組的第一張毁腿，繼續(xù)右滑，實現(xiàn)了無限右滑
- 由2苛茂，3實現(xiàn)無限循環(huán)
主要代碼
UICollectionView代理方法
// MARK: - UICollectionViewDataSource, UICollectionViewDelegate
extension ICycleView: UICollectionViewDataSource, UICollectionViewDelegate {
public func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
return pictures.count * 2
}
public func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
if isCustomCell {
// 自定義Cell
return delegate?.iCycleView?(cycleView: self, collectionView: collectionView, cellForItemAt: IndexPath(item: indexPath.item % pictures.count, section: 0), picture: pictures[indexPath.item % pictures.count]) ?? UICollectionViewCell()
} else {
// 默認(rèn)Cell
let cell = collectionView.dequeueReusableCell(withReuseIdentifier: ICycleViewConst.cellIdentifier, for: indexPath) as! ICycleViewCell
cell.configureCell(picture: pictures[indexPath.item % pictures.count], placeholderImage: placeholderImage, imgViewWidth: imgViewWidth)
return cell
}
}
public func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
delegate?.iCycleView?(cycleView: self, didSelectItemAt: indexPath.item % pictures.count)
}
}
循環(huán)輪播實現(xiàn)
// MARK: - 循環(huán)輪播實現(xiàn)
extension ICycleView {
// 定時器方法已烤，更新Cell位置
@objc private func updateCollectionViewAutoScrolling() {
if let indexPath = collectionView.indexPathsForVisibleItems.last {
let nextPath = IndexPath(item: indexPath.item + 1, section: indexPath.section)
collectionView.scrollToItem(at: nextPath, at: .centeredHorizontally, animated: true)
}
}
// 開始拖拽時,停止定時器
public func scrollViewWillBeginDragging(_ scrollView: UIScrollView) {
timer.fireDate = Date.distantFuture
}
// 結(jié)束拖拽時,恢復(fù)定時器
public func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool) {
timer.fireDate = Date(timeIntervalSinceNow: autoScrollDelay)
}
/**
- 監(jiān)聽手動減速完成(停止?jié)L動)
- 1.collectionView的cell顯示兩倍數(shù)量的圖片，展示圖片分為兩組味悄，默認(rèn)顯示第二組的第一張
- 2.左滑collectionView到第二組最后一張草戈，即最后一個cell時，設(shè)置scrollView的contentOffset顯示第一組的最后一張侍瑟，繼續(xù)左滑唐片，實現(xiàn)了無限左滑
- 3.右滑collectionView到第一組第一張，即第一cell時涨颜，設(shè)置scrollView的contentOffset顯示第二組的第一張费韭，繼續(xù)右滑，實現(xiàn)了無限右滑
- 4.由2庭瑰，3實現(xiàn)無限循環(huán)
*/
public func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) {
let offsetX = scrollView.contentOffset.x
let page = Int(offsetX / bounds.size.width)
let itemsCount = collectionView.numberOfItems(inSection: 0)
if page == 0 {
// 第一頁
collectionView.contentOffset = CGPoint(x: offsetX + CGFloat(pictures.count) * bounds.size.width, y: 0)
} else if page == itemsCount - 1 {
// 最后一頁
collectionView.contentOffset = CGPoint(x: offsetX - CGFloat(pictures.count) * bounds.size.width, y: 0)
}
}
// - 滾動動畫結(jié)束的時候調(diào)用
public func scrollViewDidEndScrollingAnimation(_ scrollView: UIScrollView) {
scrollViewDidEndDecelerating(collectionView)
}
/**
- 正在滾動
- 設(shè)置分頁星持，算出滾動位置,更新指示器
*/
public func scrollViewDidScroll(_ scrollView: UIScrollView) {
let offsetX = scrollView.contentOffset.x
var page = Int(offsetX / bounds.size.width+0.5)
page = page % pictures.count
if pageControl.currentPage != page {
pageControl.currentPage = page
delegate?.iCycleView?(cycleView: self, autoScrollingItemAt: page)
}
}
}
Contact
QQ: 2256472253
Email: ixialuo@126.com
