目錄[-]
iOS流布局UICollectionView系列一——初識(shí)與簡(jiǎn)單使用UICollectionView
一、簡(jiǎn)介
二、先來實(shí)現(xiàn)一個(gè)最簡(jiǎn)單的九宮格類布局
三、UICollectionView中的常用方法和屬性
iOS流布局UICollectionView系列一——初識(shí)與簡(jiǎn)單使用UICollectionView
一、簡(jiǎn)介
UICollectionView是iOS6之后引入的一個(gè)新的UI控件，它和UITableView有著諸多的相似之處，其中許多代理方法都十分類似。簡(jiǎn)單來說，UICollectionView是比UITbleView更加強(qiáng)大的一個(gè)UI控件，有如下幾個(gè)方面：
1、支持水平和垂直兩種方向的布局
2、通過layout配置方式進(jìn)行布局
3、類似于TableView中的cell特性外，CollectionView中的Item大小和位置可以自由定義
4、通過layout布局回調(diào)的代理方法，可以動(dòng)態(tài)的定制每個(gè)item的大小和collection的答題布局屬性
5、更加強(qiáng)大一點(diǎn)，完全自定義一套layout布局方案，可以實(shí)現(xiàn)意想不到的效果
這篇博客，我們主要討論CollectionView使用原生layout的方法和相關(guān)屬性，其他特點(diǎn)和更強(qiáng)的制定化，會(huì)在后面的博客中介紹
二、先來實(shí)現(xiàn)一個(gè)最簡(jiǎn)單的九宮格類布局
在了解UICollectionView的更多屬性前，我們先來使用其進(jìn)行一個(gè)最簡(jiǎn)單的流布局試試看，在controller的viewDidLoad中添加如下代碼：
//創(chuàng)建一個(gè)layout布局類
UICollectionViewFlowLayout * layout = [[UICollectionViewFlowLayout alloc]init];
//設(shè)置布局方向?yàn)榇怪绷鞑季?layout.scrollDirection = UICollectionViewScrollDirectionVertical;
//設(shè)置每個(gè)item的大小為100*100
layout.itemSize = CGSizeMake(100, 100);
//創(chuàng)建collectionView 通過一個(gè)布局策略layout來創(chuàng)建
UICollectionView * collect = [[UICollectionView alloc]initWithFrame:self.view.frame collectionViewLayout:layout];
//代理設(shè)置
collect.delegate=self;
collect.dataSource=self;
//注冊(cè)item類型 這里使用系統(tǒng)的類型
[collect registerClass:[UICollectionViewCell class] forCellWithReuseIdentifier:@"cellid"];
[self.view addSubview:collect];
這里有一點(diǎn)需要注意，collectionView在完成代理回調(diào)前，必須注冊(cè)一個(gè)cell，類似如下:
[collect registerClass:[UICollectionViewCell class] forCellWithReuseIdentifier:@"cellid"];
這和tableView有些類似，又有些不同，因?yàn)閠ableView除了注冊(cè)cell的方法外，還可以通過臨時(shí)創(chuàng)建來做：
//tableView在從復(fù)用池中取cell的時(shí)候，有如下兩種方法
//使用這種方式如果復(fù)用池中無，是可以返回nil的，我們?cè)谂R時(shí)創(chuàng)建即可
- (nullable __kindof UITableViewCell *)dequeueReusableCellWithIdentifier:(NSString *)identifier;
//6.0后使用如下的方法直接從注冊(cè)的cell類獲取創(chuàng)建，如果沒有注冊(cè) 會(huì)崩潰 - (__kindof UITableViewCell *)dequeueReusableCellWithIdentifier:(NSString *)identifier forIndexPath:(NSIndexPath *)indexPath NS_AVAILABLE_IOS(6_0);
我們可以分析：因?yàn)閁ICollectionView是iOS6.0之前的新類，因此這里統(tǒng)一了從復(fù)用池中獲取cell的方法，沒有再提供可以返回nil的方式，并且在UICollectionView的回調(diào)代理中，只能使用從復(fù)用池中獲取cell的方式進(jìn)行cell的返回，其他方式會(huì)崩潰，例如：
//這是正確的方法
-(UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath{
UICollectionViewCell * cell = [collectionView dequeueReusableCellWithReuseIdentifier:@"cellid" forIndexPath:indexPath];
cell.backgroundColor = [UIColor colorWithRed:arc4random()%255/255.0 green:arc4random()%255/255.0 blue:arc4random()%255/255.0 alpha:1];
return cell;
}
//這樣做會(huì)崩潰
-(UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath{
// UICollectionViewCell * cell = [collectionView dequeueReusableCellWithReuseIdentifier:@"cellid" forIndexPath:indexPath];
// cell.backgroundColor = [UIColor colorWithRed:arc4random()%255/255.0 green:arc4random()%255/255.0 blue:arc4random()%255/255.0 alpha:1];
UICollectionViewCell * cell = [[UICollectionViewCell alloc]init];
return cell;
}
上面錯(cuò)誤的方式會(huì)崩潰，信息如下，讓我們使用從復(fù)用池中取cell的方式：
上面的設(shè)置完成后，我們來實(shí)現(xiàn)如下幾個(gè)代理方法：
這里與TableView的回調(diào)方式十分類似
//返回分區(qū)個(gè)數(shù)
-(NSInteger)numberOfSectionsInCollectionView:(UICollectionView *)collectionView{
return 1;
}
//返回每個(gè)分區(qū)的item個(gè)數(shù)
-(NSInteger)collectionView:(UICollectionView *)collectionView numberOfItemsInSection:(NSInteger)section{
return 10;
}
//返回每個(gè)item
-(UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath{
UICollectionViewCell * cell = [collectionView dequeueReusableCellWithReuseIdentifier:@"cellid" forIndexPath:indexPath];
cell.backgroundColor = [UIColor colorWithRed:arc4random()%255/255.0 green:arc4random()%255/255.0 blue:arc4random()%255/255.0 alpha:1];
return cell;
}
效果如下：
同樣，如果內(nèi)容的大小超出一屏，和tableView類似是可以進(jìn)行視圖滑動(dòng)的。
還有一點(diǎn)細(xì)節(jié)，我們?cè)谏厦嬖O(shè)置布局方式的時(shí)候設(shè)置了垂直布局：
layout.scrollDirection = UICollectionViewScrollDirectionVertical;
//這個(gè)是水平布局
//layout.scrollDirection = UICollectionViewScrollDirectionHorizontal;
這樣系統(tǒng)會(huì)在一行充滿后進(jìn)行第二行的排列，如果設(shè)置為水平布局，則會(huì)在一列充滿后，進(jìn)行第二列的布局，這種方式也被稱為流式布局
三、UICollectionView中的常用方法和屬性
//通過一個(gè)布局策略初識(shí)化CollectionView
- (instancetype)initWithFrame:(CGRect)frame collectionViewLayout:(UICollectionViewLayout *)layout;
//獲取和設(shè)置collection的layout
@property (nonatomic, strong) UICollectionViewLayout *collectionViewLayout;
//數(shù)據(jù)源和代理
@property (nonatomic, weak, nullable) id <UICollectionViewDelegate> delegate;
@property (nonatomic, weak, nullable) id <UICollectionViewDataSource> dataSource;
//從一個(gè)class或者xib文件進(jìn)行cell(item)的注冊(cè)
- (void)registerClass:(nullable Class)cellClass forCellWithReuseIdentifier:(NSString *)identifier;
- (void)registerNib:(nullable UINib *)nib forCellWithReuseIdentifier:(NSString *)identifier;
//下面兩個(gè)方法與上面相似，這里注冊(cè)的是頭視圖或者尾視圖的類
//其中第二個(gè)參數(shù)是設(shè)置 頭視圖或者尾視圖 系統(tǒng)為我們定義好了這兩個(gè)字符串
//UIKIT_EXTERN NSString *const UICollectionElementKindSectionHeader NS_AVAILABLE_IOS(6_0);
//UIKIT_EXTERN NSString *const UICollectionElementKindSectionFooter NS_AVAILABLE_IOS(6_0);
- (void)registerClass:(nullable Class)viewClass forSupplementaryViewOfKind:(NSString *)elementKind withReuseIdentifier:(NSString *)identifier;
- (void)registerNib:(nullable UINib *)nib forSupplementaryViewOfKind:(NSString *)kind withReuseIdentifier:(NSString *)identifier;
//這兩個(gè)方法是從復(fù)用池中取出cell或者頭尾視圖
- (__kindof UICollectionViewCell *)dequeueReusableCellWithReuseIdentifier:(NSString *)identifier forIndexPath:(NSIndexPath *)indexPath;
- (__kindof UICollectionReusableView *)dequeueReusableSupplementaryViewOfKind:(NSString *)elementKind withReuseIdentifier:(NSString *)identifier forIndexPath:(NSIndexPath *)indexPath;
//設(shè)置是否允許選中 默認(rèn)yes
@property (nonatomic) BOOL allowsSelection;
//設(shè)置是否允許多選 默認(rèn)no
@property (nonatomic) BOOL allowsMultipleSelection;
//獲取所有選中的item的位置信息
- (nullable NSArray<NSIndexPath *> *)indexPathsForSelectedItems;
//設(shè)置選中某一item，并使視圖滑動(dòng)到相應(yīng)位置，scrollPosition是滑動(dòng)位置的相關(guān)參數(shù)，如下：
/*
typedef NS_OPTIONS(NSUInteger, UICollectionViewScrollPosition) {
//無
UICollectionViewScrollPositionNone = 0,
//垂直布局時(shí)使用的 對(duì)應(yīng)上中下
UICollectionViewScrollPositionTop = 1 << 0,
UICollectionViewScrollPositionCenteredVertically = 1 << 1,
UICollectionViewScrollPositionBottom = 1 << 2,
//水平布局時(shí)使用的 對(duì)應(yīng)左中右
UICollectionViewScrollPositionLeft = 1 << 3,
UICollectionViewScrollPositionCenteredHorizontally = 1 << 4,
UICollectionViewScrollPositionRight = 1 << 5
};
*/
- (void)selectItemAtIndexPath:(nullable NSIndexPath *)indexPath animated:(BOOL)animated scrollPosition:(UICollectionViewScrollPosition)scrollPosition;
//將某一item取消選中
- (void)deselectItemAtIndexPath:(NSIndexPath *)indexPath animated:(BOOL)animated;
//重新加載數(shù)據(jù)
- (void)reloadData;
//下面這兩個(gè)方法，可以重新設(shè)置collection的布局，后面的方法多了一個(gè)布局完成后的回調(diào)，iOS7后可以用
//使用這兩個(gè)方法可以產(chǎn)生非常炫酷的動(dòng)畫效果
- (void)setCollectionViewLayout:(UICollectionViewLayout *)layout animated:(BOOL)animated;
- (void)setCollectionViewLayout:(UICollectionViewLayout *)layout animated:(BOOL)animated completion:(void (^ __nullable)(BOOL finished))completion NS_AVAILABLE_IOS(7_0);
//下面這些方法更加強(qiáng)大，我們可以對(duì)布局更改后的動(dòng)畫進(jìn)行設(shè)置
//這個(gè)方法傳入一個(gè)布局策略layout，系統(tǒng)會(huì)開始進(jìn)行布局渲染，返回一個(gè)UICollectionViewTransitionLayout對(duì)象
//這個(gè)UICollectionViewTransitionLayout對(duì)象管理動(dòng)畫的相關(guān)屬性，我們可以進(jìn)行設(shè)置
- (UICollectionViewTransitionLayout *)startInteractiveTransitionToCollectionViewLayout:(UICollectionViewLayout *)layout completion:(nullable UICollectionViewLayoutInteractiveTransitionCompletion)completion NS_AVAILABLE_IOS(7_0);
//準(zhǔn)備好動(dòng)畫設(shè)置后，我們需要調(diào)用下面的方法進(jìn)行布局動(dòng)畫的展示，之后會(huì)調(diào)用上面方法的block回調(diào) - (void)finishInteractiveTransition NS_AVAILABLE_IOS(7_0);
//調(diào)用這個(gè)方法取消上面的布局動(dòng)畫設(shè)置，之后也會(huì)進(jìn)行上面方法的block回調(diào) - (void)cancelInteractiveTransition NS_AVAILABLE_IOS(7_0);
//獲取分區(qū)數(shù)
- (NSInteger)numberOfSections;
//獲取某一分區(qū)的item數(shù)
- (NSInteger)numberOfItemsInSection:(NSInteger)section;
//下面兩個(gè)方法獲取item或者頭尾視圖的layout屬性，這個(gè)UICollectionViewLayoutAttributes對(duì)象
//存放著布局的相關(guān)數(shù)據(jù)，可以用來做完全自定義布局，后面博客會(huì)介紹
- (nullable UICollectionViewLayoutAttributes *)layoutAttributesForItemAtIndexPath:(NSIndexPath *)indexPath;
- (nullable UICollectionViewLayoutAttributes *)layoutAttributesForSupplementaryElementOfKind:(NSString *)kind atIndexPath:(NSIndexPath *)indexPath;
//獲取某一點(diǎn)所在的indexpath位置
- (nullable NSIndexPath *)indexPathForItemAtPoint:(CGPoint)point;
//獲取某個(gè)cell所在的indexPath
- (nullable NSIndexPath *)indexPathForCell:(UICollectionViewCell *)cell;
//根據(jù)indexPath獲取cell
- (nullable UICollectionViewCell *)cellForItemAtIndexPath:(NSIndexPath *)indexPath;
//獲取所有可見cell的數(shù)組
- (NSArray<__kindof UICollectionViewCell *> *)visibleCells;
//獲取所有可見cell的位置數(shù)組
- (NSArray<NSIndexPath *> *)indexPathsForVisibleItems;
//下面三個(gè)方法是iOS9中新添加的方法，用于獲取頭尾視圖
- (UICollectionReusableView *)supplementaryViewForElementKind:(NSString *)elementKind atIndexPath:(NSIndexPath *)indexPath NS_AVAILABLE_IOS(9_0);
- (NSArray<UICollectionReusableView *> *)visibleSupplementaryViewsOfKind:(NSString *)elementKind NS_AVAILABLE_IOS(9_0);
- (NSArray<NSIndexPath *> *)indexPathsForVisibleSupplementaryElementsOfKind:(NSString *)elementKind NS_AVAILABLE_IOS(9_0);
//使視圖滑動(dòng)到某一位置，可以帶動(dòng)畫效果
- (void)scrollToItemAtIndexPath:(NSIndexPath *)indexPath atScrollPosition:(UICollectionViewScrollPosition)scrollPosition animated:(BOOL)animated;
//下面這些方法用于動(dòng)態(tài)添加，刪除，移動(dòng)某些分區(qū)獲取items
(void)insertSections:(NSIndexSet *)sections;
(void)deleteSections:(NSIndexSet *)sections;
(void)reloadSections:(NSIndexSet *)sections;
(void)moveSection:(NSInteger)section toSection:(NSInteger)newSection;
(void)insertItemsAtIndexPaths:(NSArray<NSIndexPath *> *)indexPaths;
(void)deleteItemsAtIndexPaths:(NSArray<NSIndexPath *> *)indexPaths;
(void)reloadItemsAtIndexPaths:(NSArray<NSIndexPath *> *)indexPaths;
(void)moveItemAtIndexPath:(NSIndexPath *)indexPath toIndexPath:(NSIndexPath *)newIndexPath;
