UICollectionView簡(jiǎn)介
關(guān)于UICollectionView
萧吠,蘋果是這樣解釋的:管理數(shù)據(jù)項(xiàng)的有序集合陆淀,并使用可定制的布局呈現(xiàn)它們岸梨。在iOS中最簡(jiǎn)單的UICollectionView就是GirdView(網(wǎng)格視圖),可以以多列的方式將數(shù)據(jù)進(jìn)行展示冒晰。標(biāo)準(zhǔn)的UICollectionView包含以下3個(gè)部分泌豆,他們都是UIView的子類:
- Cell:用于展示內(nèi)容的主體插佛,可以定制其尺寸和內(nèi)容辟癌。
- Supplementary view :用于追加視圖背苦,和UITableView里面的Header和Footer的作用類似。
-
Decoration View : 用于裝飾視圖献宫,是每個(gè)section的背景.
UICollectionView和UITableView對(duì)比
- 相同點(diǎn):
- 都是繼承自UIScrollView钥平,支持滾動(dòng)。
- 都支持?jǐn)?shù)據(jù)單元格的重用機(jī)制姊途。
- 都是通過代理方法和數(shù)據(jù)源方法來實(shí)現(xiàn)控制和顯示涉瘾。
- 不同點(diǎn):
- UICollectionView的section里面的數(shù)據(jù)單元叫做item,UITableView的叫做cell
- UICollectionView的布局使用
UICollectionViewLayou
或者其子類UICollectionViewFlowLayout
和容易實(shí)現(xiàn)自定義布局捷兰。
實(shí)現(xiàn)一個(gè)簡(jiǎn)單的UICollectionView的步驟:
由于UICollectionView和UITableView類似立叛,所以實(shí)現(xiàn)一個(gè)UICollectionView的步驟也和UITableView相同,最大的區(qū)別在與UICollectionView的布局贡茅。
- 創(chuàng)建布局
- 使用UICollectionViewFlowLayout或者UICollectionViewLayou實(shí)現(xiàn)布局
- 布局里面實(shí)現(xiàn)每個(gè)通過itemSize屬性設(shè)置item的的尺寸秘蛇。
- 用scrollDirection屬性設(shè)置item的滾動(dòng)方向其做,垂直或者橫向。
typedef NS_ENUM(NSInteger, UICollectionViewScrollDirection) {
UICollectionViewScrollDirectionVertical,
UICollectionViewScrollDirectionHorizontal
};
- 其他自定義布局
- 創(chuàng)建UICollectionView
- 用
- (instancetype)initWithFrame:(CGRect)frame collectionViewLayout:(UICollectionViewLayout *)layout
方法進(jìn)行初始化
UICollectionView * collectionView = [[UICollectionView alloc]initWithFrame:CGRectMake(0, 100, collectionViewW, collectionViewH) collectionViewLayout:layout];
- 設(shè)置UICollectionView的代理為控制器
- 實(shí)現(xiàn)代理協(xié)議
@protocol UICollectionViewDataSource <NSObject>
@required
/**
* 返回每個(gè)section里面的item的數(shù)量
*/
- (NSInteger)collectionView:(UICollectionView *)collectionView numberOfItemsInSection:(NSInteger)section;
/**
* 返回每個(gè)item的具體樣式
*/
- ( UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath;
@optional
/**
* 返回有多少個(gè)section
*/
- (NSInteger)numberOfSectionsInCollectionView:(UICollectionView *)collectionView;
/**
* 返回UICollectionReusableView
*/
- (UICollectionReusableView *)collectionView:(UICollectionView *)collectionView viewForSupplementaryElementOfKind:(NSString *)kind atIndexPath:(NSIndexPath *)indexPath;
/**
* 設(shè)置某個(gè)Item是否可以移動(dòng)
*/
- (BOOL)collectionView:(UICollectionView *)collectionView canMoveItemAtIndexPath:(NSIndexPath *)indexPath ;
/**
*移動(dòng)item的使用調(diào)用的方法
*/
- (void)collectionView:(UICollectionView *)collectionView moveItemAtIndexPath:(NSIndexPath *)sourceIndexPath toIndexPath:(NSIndexPath*)destinationIndexPath ;
- (nullable NSArray<NSString *> *)indexTitlesForCollectionView:(UICollectionView *)collectionView ;
- (NSIndexPath *)collectionView:(UICollectionView *)collectionView indexPathForIndexTitle:(NSString *)title atIndex:(NSInteger)index ;
@end
示例代碼
#import "ViewController.h"
static NSString * const cellID = @"cellID";
@interface ViewController ()<UICollectionViewDataSource>
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
// 創(chuàng)建布局
UICollectionViewFlowLayout * layout = [[UICollectionViewFlowLayout alloc]init];
layout.itemSize = CGSizeMake(50, 50);
layout.scrollDirection = UICollectionViewScrollDirectionHorizontal;
// 創(chuàng)建collectionView
CGFloat collectionViewW = self.view.frame.size.width;
CGFloat collectionViewH = 200;
UICollectionView * collectionView = [[UICollectionView alloc]initWithFrame:CGRectMake(0, 100, collectionViewW, collectionViewH) collectionViewLayout:layout];
collectionView.backgroundColor = [UIColor blackColor];
collectionView.dataSource = self;
[self.view addSubview:collectionView];
// 注冊(cè)
[collectionView registerClass:[UICollectionViewCell class] forCellWithReuseIdentifier:cellID];
}
#pragma mark - <UICollectionViewDataSource>
- (NSInteger)collectionView:(UICollectionView *)collectionView numberOfItemsInSection:(NSInteger)section{
return 50;
}
- (UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath{
UICollectionViewCell * cell = [collectionView dequeueReusableCellWithReuseIdentifier:cellID forIndexPath:indexPath];
// 設(shè)置圓角
cell.layer.cornerRadius = 5.0;
cell.layer.masksToBounds = YES;
cell.backgroundColor = [UIColor redColor];
return cell;
}
@end
實(shí)現(xiàn)效果
如果將layout.scrollDirection = UICollectionViewScrollDirectionHorizontal;
改為layout.scrollDirection = UICollectionViewScrollDirectionVertical;
就能實(shí)現(xiàn)垂直滾動(dòng)
![可以垂直滾動(dòng)的uicollectionView]](http://upload-images.jianshu.io/upload_images/3738156-bfa3fa47379abcba.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
UICollectionViewDelegate
同樣的UICollectionView也有代理方法赁还,在實(shí)現(xiàn)代理協(xié)議之后通過代理方法來實(shí)現(xiàn)和用戶的交互操作妖泄。具體來說主要負(fù)責(zé)一以下三分工作:
- cell的高亮效果顯示
- (BOOL)collectionView:(UICollectionView *)collectionView shouldHighlightItemAtIndexPath:(NSIndexPath *)indexPath;
- (void)collectionView:(UICollectionView *)collectionView didHighlightItemAtIndexPath:(NSIndexPath *)indexPath;
- (void)collectionView:(UICollectionView *)collectionView didUnhighlightItemAtIndexPath:(NSIndexPath *)indexPath;
- cell的選中狀態(tài)
- (BOOL)collectionView:(UICollectionView *)collectionView shouldDeselectItemAtIndexPath:(NSIndexPath *)indexPath; // called when the user taps on an already-selected item in multi-select mode
- (void)collectionView:(UICollectionView *)collectionView didSelectItemAtIndexPath:(NSIndexPath *)indexPath;
- (void)collectionView:(UICollectionView *)collectionView didDeselectItemAtIndexPath:(NSIndexPath *)indexPath;
- 支持長(zhǎng)按后的菜單
- (BOOL)collectionView:(UICollectionView *)collectionView shouldShowMenuForItemAtIndexPath:(NSIndexPath *)indexPath;
- (BOOL)collectionView:(UICollectionView *)collectionView canPerformAction:(SEL)action forItemAtIndexPath:(NSIndexPath *)indexPath withSender:(nullable id)sender;
- (void)collectionView:(UICollectionView *)collectionView performAction:(SEL)action forItemAtIndexPath:(NSIndexPath *)indexPath withSender:(nullable id)sender;
UICollectionViewLayout和UICollectionViewFlowLayout
UICollectionView的精髓就是UICollectionViewLayout,這也是UICollectionView和UITableView最大的不同艘策。UICollectionViewLayout決定了UICollectionView是如何顯示在界面上的蹈胡。在展示之間,一般需要生成合適的UICollectionViewLayout的子類對(duì)象朋蔫,并將其賦值到UICollectionView的布局屬性上罚渐。
UICollectionViewFlowLayout是UICollectionViewLayout的子類。這個(gè)布局是最簡(jiǎn)單最常用的驯妄。它實(shí)現(xiàn)了直線對(duì)其的布局排布方式荷并,Gird View就是用UICollectionViewFlowLayout布局方式。
UICollectionViewLayout布局的具體思路:
- 設(shè)置
itemSzie
屬性青扔,它定義了每一個(gè)item的大小源织。在一個(gè)示例中通過設(shè)置layout的itemSize屬性全局的設(shè)置了cell的尺寸。如果想要對(duì)某個(gè)cell定制尺寸微猖,可以使用- (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout sizeForItemAtIndexPath:(NSIndexPath *)indexPath
方法實(shí)現(xiàn) - 設(shè)置間隔
間隔可以指定item之間的間隔和每一行之間的間隔雀鹃。間隔和itemSzie
一樣,既有全局屬性励两,也可以對(duì)每一個(gè)item設(shè)定:
@property (nonatomic) CGFloat minimumLineSpacing;
@property (nonatomic) CGFloat minimumInteritemSpacing;
- (CGFloat)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout minimumLineSpacingForSectionAtIndex:(NSInteger)section;
- (CGFloat)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout minimumInteritemSpacingForSectionAtIndex:(NSInteger)section;
- 設(shè)定滾動(dòng)方向
typedef NS_ENUM(NSInteger, UICollectionViewScrollDirection) {
UICollectionViewScrollDirectionVertical,
UICollectionViewScrollDirectionHorizontal
};
- 設(shè)置Header和Footer的尺寸
設(shè)置Header和Footer的尺寸也分為全局和局部。在這里需要注意滾動(dòng)的方向囊颅,滾動(dòng)方向不同当悔,header和footer的寬度和高度只有一個(gè)會(huì)起作用。垂直滾動(dòng)時(shí)section間寬度為尺寸的高踢代。
@property (nonatomic) CGSize headerReferenceSize;
@property (nonatomic) CGSize footerReferenceSize;
- (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout referenceSizeForHeaderInSection:(NSInteger)section;
- (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout referenceSizeForFooterInSection:(NSInteger)section;
- 設(shè)置內(nèi)邊距
@property (nonatomic) UIEdgeInsets sectionInset;
- (UIEdgeInsets)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout insetForSectionAtIndex:(NSInteger)section;
用UICollectionView實(shí)現(xiàn)瀑布流
瀑布流很常用盲憎,尤其是在電商類app中用于展示商品信息,比如某寶:
實(shí)現(xiàn)瀑布流的方式有幾種胳挎,但是比較簡(jiǎn)單的是通過UICollectionView饼疙,因?yàn)閏ollectionView自己會(huì)實(shí)現(xiàn)cell的循環(huán)利用,所以自己不用實(shí)現(xiàn)循環(huán)利用的機(jī)制慕爬。瀑布就最重要的就是布局窑眯,要選取最短的那一列來排布,保證每一列之間的間距不會(huì)太大医窿。
實(shí)現(xiàn)步驟
- 自定義繼承自UICollectionViewLayout的子類來進(jìn)行實(shí)現(xiàn)布局
- 調(diào)用
- (void)prepareLayout
進(jìn)行初始化 - 重載
- (CGSize)collectionViewContentSize
返回內(nèi)容的大小 - 重載
- (NSArray<UICollectionViewLayoutAttributes *> *)layoutAttributesForElementsInRect:(CGRect)rect
方法返回rect中所有元素的布局屬性磅甩,返回的是一個(gè)數(shù)組 - 重載
- (UICollectionViewLayoutAttributes *)layoutAttributesForItemAtIndexPath:(NSIndexPath *)indexPath
方法返回對(duì)應(yīng)的indexPath的位置的cell的布局屬性。 - 重載
- (nullable UICollectionViewLayoutAttributes *)layoutAttributesForSupplementaryViewOfKind:(NSString *)elementKind atIndexPath:(NSIndexPath *)indexPath;
方法返回對(duì)應(yīng)indexPath的位置的追加視圖的布局屬性姥卢,如果沒有就不用重載 - 重載
- (nullable UICollectionViewLayoutAttributes *)layoutAttributesForDecorationViewOfKind:(NSString*)elementKind atIndexPath:(NSIndexPath *)indexPath;
方法返回對(duì)應(yīng)indexPath的位置的裝飾視圖的布局屬性卷要,如果沒有也不需要重載 - 重載
- (BOOL)shouldInvalidateLayoutForBoundsChange:(CGRect)newBounds;
當(dāng)邊界發(fā)生改變時(shí)渣聚,是否應(yīng)該刷新。
- 調(diào)用
自定義UICollectionViewLayout布局的示例代碼
用代理來實(shí)現(xiàn)對(duì)item的布局屬性的控制
.h文件
#import <UIKit/UIKit.h>
@class LMHWaterFallLayout;
@protocol LMHWaterFallLayoutDeleaget<NSObject>
@required
/**
* 每個(gè)item的高度
*/
- (CGFloat)waterFallLayout:(LMHWaterFallLayout *)waterFallLayout heightForItemAtIndexPath:(NSUInteger)indexPath itemWidth:(CGFloat)itemWidth;
@optional
/**
* 有多少列
*/
- (NSUInteger)columnCountInWaterFallLayout:(LMHWaterFallLayout *)waterFallLayout;
/**
* 每列之間的間距
*/
- (CGFloat)columnMarginInWaterFallLayout:(LMHWaterFallLayout *)waterFallLayout;
/**
* 每行之間的間距
*/
- (CGFloat)rowMarginInWaterFallLayout:(LMHWaterFallLayout *)waterFallLayout;
/**
* 每個(gè)item的內(nèi)邊距
*/
- (UIEdgeInsets)edgeInsetdInWaterFallLayout:(LMHWaterFallLayout *)waterFallLayout;
@end
@interface LMHWaterFallLayout : UICollectionViewLayout
/** 代理 */
@property (nonatomic, weak) id<LMHWaterFallLayoutDeleaget> delegate;
@end
.m文件
#import "LMHWaterFallLayout.h"
/** 默認(rèn)的列數(shù) */
static const CGFloat LMHDefaultColunmCount = 3;
/** 每一列之間的間距 */
static const CGFloat LMHDefaultColunmMargin = 10;
/** 每一行之間的間距 */
static const CGFloat LMHDefaultRowMargin = 10;
/** 內(nèi)邊距 */
static const UIEdgeInsets LMHDefaultEdgeInsets = {10,10,10,10};
@interface LMHWaterFallLayout()
/** 存放所有的布局屬性 */
@property (nonatomic, strong) NSMutableArray * attrsArr;
/** 存放所有列的當(dāng)前高度 */
@property (nonatomic, strong) NSMutableArray *columnHeights;
/** 內(nèi)容的高度 */
@property (nonatomic, assign) CGFloat contentHeight;
- (NSUInteger)colunmCount;
- (CGFloat)columnMargin;
- (CGFloat)rowMargin;
- (UIEdgeInsets)edgeInsets;
@end
@implementation LMHWaterFallLayout
#pragma mark 懶加載
- (NSMutableArray *)attrsArr{
if (!_attrsArr) {
_attrsArr = [NSMutableArray array];
}
return _attrsArr;
}
- (NSMutableArray *)columnHeights{
if (!_columnHeights) {
_columnHeights = [NSMutableArray array];
}
return _columnHeights;
}
#pragma mark - 數(shù)據(jù)處理
/**
* 列數(shù)
*/
- (NSUInteger)colunmCount{
if ([self.delegate respondsToSelector:@selector(columnCountInWaterFallLayout:)]) {
return [self.delegate columnCountInWaterFallLayout:self];
}else{
return LMHDefaultColunmCount;
}
}
/**
* 列間距
*/
- (CGFloat)columnMargin{
if ([self.delegate respondsToSelector:@selector(columnMarginInWaterFallLayout:)]) {
return [self.delegate columnMarginInWaterFallLayout:self];
}else{
return LMHDefaultColunmMargin;
}
}
/**
* 行間距
*/
- (CGFloat)rowMargin{
if ([self.delegate respondsToSelector:@selector(rowMarginInWaterFallLayout:)]) {
return [self.delegate rowMarginInWaterFallLayout:self];
}else{
return LMHDefaultRowMargin;
}
}
/**
* item的內(nèi)邊距
*/
- (UIEdgeInsets)edgeInsets{
if ([self.delegate respondsToSelector:@selector(edgeInsetdInWaterFallLayout:)]) {
return [self.delegate edgeInsetdInWaterFallLayout:self];
}else{
return LMHDefaultEdgeInsets;
}
}
/**
* 初始化
*/
- (void)prepareLayout{
[super prepareLayout];
self.contentHeight = 0;
// 清除之前計(jì)算的所有高度
[self.columnHeights removeAllObjects];
// 設(shè)置每一列默認(rèn)的高度
for (NSInteger i = 0; i < LMHDefaultColunmCount ; i ++) {
[self.columnHeights addObject:@(LMHDefaultEdgeInsets.top)];
}
// 清楚之前所有的布局屬性
[self.attrsArr removeAllObjects];
// 開始創(chuàng)建每一個(gè)cell對(duì)應(yīng)的布局屬性
NSInteger count = [self.collectionView numberOfItemsInSection:0];
for (int i = 0; i < count; i++) {
// 創(chuàng)建位置
NSIndexPath * indexPath = [NSIndexPath indexPathForItem:i inSection:0];
// 獲取indexPath位置上cell對(duì)應(yīng)的布局屬性
UICollectionViewLayoutAttributes * attrs = [self layoutAttributesForItemAtIndexPath:indexPath];
[self.attrsArr addObject:attrs];
}
}
/**
* 返回indexPath位置cell對(duì)應(yīng)的布局屬性
*/
- (UICollectionViewLayoutAttributes *)layoutAttributesForItemAtIndexPath:(NSIndexPath *)indexPath{
// 創(chuàng)建布局屬性
UICollectionViewLayoutAttributes * attrs = [UICollectionViewLayoutAttributes layoutAttributesForCellWithIndexPath:indexPath];
//collectionView的寬度
CGFloat collectionViewW = self.collectionView.frame.size.width;
// 設(shè)置布局屬性的frame
CGFloat cellW = (collectionViewW - self.edgeInsets.left - self.edgeInsets.right - (self.colunmCount - 1) * self.columnMargin) / self.colunmCount;
CGFloat cellH = [self.delegate waterFallLayout:self heightForItemAtIndexPath:indexPath.item itemWidth:cellW];
// 找出最短的那一列
NSInteger destColumn = 0;
CGFloat minColumnHeight = [self.columnHeights[0] doubleValue];
for (int i = 1; i < LMHDefaultColunmCount; i++) {
// 取得第i列的高度
CGFloat columnHeight = [self.columnHeights[i] doubleValue];
if (minColumnHeight > columnHeight) {
minColumnHeight = columnHeight;
destColumn = i;
}
}
CGFloat cellX = self.edgeInsets.left + destColumn * (cellW + self.columnMargin);
CGFloat cellY = minColumnHeight;
if (cellY != self.edgeInsets.top) {
cellY += self.rowMargin;
}
attrs.frame = CGRectMake(cellX, cellY, cellW, cellH);
// 更新最短那一列的高度
self.columnHeights[destColumn] = @(CGRectGetMaxY(attrs.frame));
// 記錄內(nèi)容的高度 - 即最長(zhǎng)那一列的高度
CGFloat maxColumnHeight = [self.columnHeights[destColumn] doubleValue];
if (self.contentHeight < maxColumnHeight) {
self.contentHeight = maxColumnHeight;
}
return attrs;
}
/**
* 決定cell的布局屬性
*/
- (NSArray<UICollectionViewLayoutAttributes *> *)layoutAttributesForElementsInRect:(CGRect)rect{
return self.attrsArr;
}
/**
* 內(nèi)容的高度
*/
- (CGSize)collectionViewContentSize{
// CGFloat maxColumnHeight = [self.columnHeights[0] doubleValue];
// for (int i = 0; i < LMHDefaultColunmCount; i++) {
//
// // 取得第i列的高度
// CGFloat columnHeight = [self.columnHeights[i] doubleValue];
//
// if (maxColumnHeight < columnHeight) {
// maxColumnHeight = columnHeight;
// }
//
// }
return CGSizeMake(0, self.contentHeight + self.edgeInsets.bottom);
}
@end
示例demo
接下來在控制器里面就只需要按照第一個(gè)示例的步驟僧叉,創(chuàng)建布局奕枝,創(chuàng)建collectionView。在這里瓶堕,瀑布流中每個(gè)cell的圖片和尺寸是后臺(tái)傳過來的隘道,所以只需在布局的代理方法里面將這些數(shù)據(jù)傳入,就可以實(shí)現(xiàn)一個(gè)簡(jiǎn)單的瀑布流了捞烟。
實(shí)現(xiàn)效果
附上代碼下載鏈接:用UICollectionView實(shí)現(xiàn)瀑布