【IOS开发基础系列】UICollectionView专题

1 定义

1.1 什么是UICollectionView

        UICollectionView是一种新的数据展示方式,简单来说可以把他理解成多列的UITableView(请一定注意这是UICollectionView的最最简单的形式)。

        最简单的UICollectionView就是一个GridView,可以以多列的方式将数据进行展示。标准的UICollectionView包含三个部分,它们都是UIView的子类:

    • Cells 用于展示内容的主体,对于不同的cell可以指定不同尺寸和不同的内容,这个稍后再说

    • Supplementary Views 追加视图 如果你对UITableView比较熟悉的话,可以理解为每个Section的Header或者Footer,用来标记每个section的view

    • Decoration Views 装饰视图 这是每个section的背景,比如iBooks中的书架就是这个

        不管一个UICollectionView的布局如何变化,这三个部件都是存在的。再次说明,复杂的UICollectionView绝不止上面的几幅图,关于较复杂的布局和相应的特性,我会在本文稍后和下一篇笔记中进行一些深入。


1.2 UICollectionViewDataSource

    • section的数量-numberOfSectionsInCollection:

    • 某个section里有多少个item-collectionView: numberOfItemsInSection:

    • 对于某个位置应该显示什么样的cell -collectionView: cellForItemAtIndexPath:

        实现以上三个委托方法,基本上就可以保证CollectionView工作正常了。当然,还有提供Supplementary View的方法。

    • collectionView: viewForSupplementaryElementOfKind: atIndexPath:

        对于Decoration Views,提供方法并不在UICollectionViewDataSource中,而是直接在UICollectionViewLayout类中的(因为它仅仅是视图相关,而与数据无关),放到稍后再说。


1.3 关于重用

        为了得到高效的View,对于cell的重用是必须的,避免了不断生成和销毁对象的操作,这与在UITableView中的情况是一致的。但值得注意的时,在UICollectionView中,不仅cell可以重用,Supplementary View和Decoration View也是可以并且应当被重用的。在iOS5中,Apple对UITableView的重用做了简化,以往要写类似这样的代码:

UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"MY_CELL_ID"];

//如果没有可重用的cell,那么生成一个 

if (!cell) {

    cell = [[UITableViewCell alloc] init];

}

//配置cell,blablabla

return cell;


        而如果我们在TableView向数据源请求数据之前使用-registerNib:forCellReuseIdentifier:方法为@“MY_CELL_ID”注册过nib的话,就可以省下每次判断并初始化cell的代码,要是在重用队列里没有可用的cell的话,runtime将自动帮我们生成并初始化一个可用的cell。

        这个特性很受欢迎,因此在UICollectionView中Apple继承使用了这个特性,并且把其进行了一些扩展。使用以下方法进行注册:

    • -registerClass: forCellWithReuseIdentifier:

    • -registerClass: forSupplementaryViewOfKind: withReuseIdentifier:

    • -registerNib: forCellWithReuseIdentifier:

    • -registerNib: forSupplementaryViewOfKind: withReuseIdentifier:

        相比UITableView有两个主要变化:一是加入了对某个Class的注册,这样即使不用提供nib而是用代码生成的view也可以被接受为cell了;二是不仅只是cell,Supplementary View也可以用注册的方法绑定初始化了。在对collection view的重用ID注册后,就可以像UITableView那样简单的写cell配置了:

    MyCell*cell=[cvdequeueReusableCellWithReuseIdentifier:@”MY_CELL_ID”];

    // Configure the cell's content

    cell.imageView.image=...

    return cell;

}

        需要吐槽的是,对collection view,取重用队列的方法的名字和UITableView里面不一样了,在Identifier前面多加了Reuse五个字母,语义上要比以前清晰,命名规则也比以前严谨了。


1.4 UICollectionViewDelegate

        数据无关的view的外形啊,用户交互啊什么的,由UICollectionViewDelegate来负责:

    • cell的高亮

    • cell的选中状态

    • 可以支持长按后的菜单

        关于用户交互,UICollectionView也做了改进。每个cell现在有独立的高亮事件和选中事件的delegate,用户点击cell的时候,现在会按照以下流程向delegate进行询问:

    • -collectionView: shouldHighlightItemAtIndexPath: 是否应该高亮?

    • -collectionView: didHighlightItemAtIndexPath: 如果1回答为是,那么高亮

    • -collectionView: shouldSelectItemAtIndexPath: 无论1结果如何,都询问是否可以被选中?

    • -collectionView: didUnhighlightItemAtIndexPath: 如果1回答为是,那么现在取消高亮

    • -collectionView: didSelectItemAtIndexPath: 如果3回答为是,那么选中cell

        状态控制要比以前灵活一些,对应的高亮和选中状态分别由highlighted和selected两个属性表示。


1.5 关于Cell

        相对于UITableViewCell来说,UICollectionViewCell没有这么多花头。首先UICollectionViewCell不存在各式各样的默认的style,这主要是由于展示对象的性质决定的,因为UICollectionView所用来展示的对象相比UITableView来说要来得灵活,大部分情况下更偏向于图像而非文字,因此需求将会千奇百怪。因此SDK提供给我们的默认的UICollectionViewCell结构上相对比较简单,由下至上:

    • 首先是cell本身作为容器view

    • 然后是一个大小自动适应整个cell的backgroundView,用作cell平时的背景

    • 再其上是selectedBackgroundView,是cell被选中时的背景

    • 最后是一个contentView,自定义内容应被加在这个view上

        这次Apple给我们带来的好康是被选中cell的自动变化,所有的cell中的子view,也包括contentView中的子view,在当cell被选中时,会自动去查找view是否有被选中状态下的改变。比如在contentView里加了一个normal和selected指定了不同图片的imageView,那么选中这个cell的同时这张图片也会从normal变成selected,而不需要额外的任何代码。


1.6 UICollectionViewLayout

        这是UICollectionView和UITableView最大的不同。UICollectionViewLayout可以说是UICollectionView的大脑和中枢,它负责了将各个cell、Supplementary View和Decoration Views进行组织,为它们设定各自的属性,包括但不限于:

    • 位置

    • 尺寸

    • 透明度

    • 层级关系

    • 形状

    • 等等等等…

        Layout决定了UICollectionView是如何显示在界面上的。在展示之前,一般需要生成合适的UICollectionViewLayout子类对象,并将其赋予CollectionView的collectionViewLayout属性。关于详细的自定义UICollectionViewLayout和一些细节,我将写在之后一篇笔记中。

        Apple为我们提供了一个最简单可能也是最常用的默认layout对象,UICollectionViewFlowLayout。Flow Layout简单说是一个直线对齐的layout,最常见的Grid View形式即为一种Flow Layout配置。上面的照片架界面就是一个典型的Flow Layout。

    • 首先一个重要的属性是itemSize,它定义了每一个item的大小。通过设定itemSize可以全局地改变所有cell的尺寸,如果想要对某个cell制定尺寸,可以使用-collectionView: layout: sizeForItemAtIndexPath:方法。

    • 间隔 可以指定item之间的间隔和每一行之间的间隔,和size类似,有全局属性,也可以对每一个item和每一个section做出设定:

@property (CGSize) minimumInteritemSpacing

@property (CGSize) minimumLineSpacing

-collectionView: layout: minimumInteritemSpacingForSectionAtIndex:

-collectionView: layout: minimumLineSpacingForSectionAtIndex:

    • 滚动方向 由属性scrollDirection确定scroll view的方向,将影响Flow Layout的基本方向和由header及footer确定的section之间的宽度

        UICollectionViewScrollDirectionVertical

        UICollectionViewScrollDirectionHorizontal

    • Header和Footer尺寸 同样地分为全局和部分。需要注意根据滚动方向不同,header和footer的高和宽中只有一个会起作用。垂直滚动时section间宽度为该尺寸的高,而水平滚动时为宽度起作用,如图。

    @property (CGSize) headerReferenceSize

    @property (CGSize) footerReferenceSize

    - collectionView: layout: referenceSizeForHeaderInSection:

    - collectionView: layout: referenceSizeForFooterInSection:

    • 缩进

    @property UIEdgeInsets sectionInset;

    - collectionView: layout: insetForSectionAtIndex:


1.7 总结

        一个UICollectionView的实现包括两个必要部分:UICollectionViewDataSource和UICollectionViewLayout,和一个交互部分:UICollectionViewDelegate。而Apple给出的UICollectionViewFlowLayout已经是一个很强力的layout方案了。


2 实现

2.1 UICollectionView实例的代码初始化化

    NSUInteger collectionViewHeight = (_myCellVMArray.count + 2)/3 * kMyInfoCollectionCellHeight + 10;

    //确定是水平滚动,还是垂直滚动

    UICollectionViewFlowLayout *flowLayout=[[UICollectionViewFlowLayout alloc] init];

    [flowLayout setScrollDirection: UICollectionViewScrollDirectionVertical];


    _myCollectionView = [[UICollectionView alloc] initWithFrame:CGRectMake(0, _myAccView.frame.origin.y + _myAccView.frame.size.height, self.view.frame.size.width, collectionViewHeight) collectionViewLayout: flowLayout];

    _myCollectionView.delegate = self;

    _myCollectionView.dataSource = self;

    [_myCollectionView registerClass: [HJMyInfoCollectionCell class] forCellWithReuseIdentifier: kMyCollectionCellIdentifier];

    [self.view addSubview: _myCollectionView];


2.2 UICollectionView加载过程

        总的加载过程是先加载UICollectionView的委托回调配置,再初始化UICollectionViewCell。

    1、设置numberOfSectionsInCollectionView;

- (NSInteger)numberOfSectionsInCollectionView:(UICollectionView*)collectionView

{

    return 1;

}


    2、设置numberOfItemsInSection;

- (NSInteger) collectionView: (UICollectionView *)collectionView numberOfItemsInSection:(NSInteger)section

{

    return [_myCellVMArray count];

}


    3、设置sizeForItemAtIndexPath;

//定义每个UICollectionViewCell 的大小

- (CGSize) collectionView: (UICollectionView *)collectionView layout: (UICollectionViewLayout*) collectionViewLayout sizeForItemAtIndexPath: (NSIndexPath*)indexPath

{

    NSInteger width = kCollectionViewCellWidth;

    return CGSizeMake(width , kInfoCollectionCellHeight);

}


    4、设置insetForSectionAtIndex;

//定义每个UICollectionViewCell 的margin

-(UIEdgeInsets) collectionView: (UICollectionView *)collectionView layout: (UICollectionViewLayout *)collectionViewLayout insetForSectionAtIndex: (NSInteger)section

{

    return UIEdgeInsetsMake(2, 2, 2, 2);

}


    5、配置cellForItemAtIndexPath

- (UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath*)indexPath

{

    HJInfoCollectionCell *cell= (HJInfoCollectionCell *)[_myInfoCollectionView dequeueReusableCellWithReuseIdentifier: kInfoCollectionCellIdentifier forIndexPath: indexPath];


    if(!cell) {

        cell = [[HJInfoCollectionCell alloc] initWithFrame:CGRectMake(0, 0, kInfoCollectionViewCellWidth, kInfoCollectionCellHeight)];

    }

    cell.infoVM = [_myAccCellVMArray objectAtIndex: indexPath.row];


    return cell;

}


2.3 UICollectionViewCell重用

        UICollectionViewCell其实只实例化了能应付一屏显示范围的对象实例,而在cellForItemAtIndexPath方法中重复更新此实例的业务数据来达到显示不同Cell的目的。

        UICollectionViewCell的实例化是通过dequeueReusableCellWithReuseIdentifier来实现,代码示例如下:

HJInfoCollectionCell *cell= (HJInfoCollectionCell *) [_myInfoCollectionView dequeueReusableCellWithReuseIdentifier: kInfoCollectionCellIdentifier forIndexPath: indexPath];


        在dequeueReusableCell方法中,程序会调用Cell的- (instancetype) initWithFrame:(CGRect)frame实现对象的实例化。因此自定义Cell的初始化方法实现- (instancetype)initWithFrame:(CGRect)frame就可以了,而不用像笔者一样去画蛇添足地实现一个-(instancetype) initWithFrame: (CGRect) frame WithVM:(HJInfoCellVM *) vm方法,后面这个方法永远也调用不到。

        而对于业务数据的绑定与页面控件更新逻辑,笔者建议在对应业务对象的Set方法中实现,例如上面的HJInfoCellVM业务对象,就在其Set方法中实现就可以了,示例如下:

- (void)setInfoVM: (HJInfoCellVM*)infoVM

{

    _infoVM= infoVM;

    [self reloadSubViews];

}


3 开发技巧

3.1 布局技巧

3.1.1 设置每一行显示cell个数

        需要用到UICollectionViewFlowLayout:

HJCollectionViewEqualWidthFlowLayout *flowLayout = [[HJCollectionViewEqualWidthFlowLayout alloc] initWithItemCountPerRow: kShareItemCountPerRow withItemSize: itemSize];

   flowLayout.maximumSpacing = 1;

   flowLayout.minimumLineSpacing = 1;

   flowLayout.minimumInteritemSpacing = 1;

    _collectionView.collectionViewLayout = flowLayout;


3.1.2 单元格等间距实现

    继承并自定义实现layoutAttributesForElementsInRect方法

@interface HJCollectionViewEqualWidthFlowLayout : UICollectionViewFlowLayout

@property (nonatomic) floatmaximumSpacing;


- (instancetype) initWithItemCountPerRow: (NSInteger) count WithItemSize: (CGSize) size;

-(void) setItemCountPerRow: (NSInteger) count;


@end


-(NSArray*) layoutAttributesForElementsInRect: (CGRect)rect

{

    NSMutableArray* attributes = [[super layoutAttributesForElementsInRect: rect] mutableCopy];


    for (UICollectionViewLayoutAttributes *attr in attributes) {

        NSLog(@"%@", NSStringFromCGRect([attr frame]));

    }


    int j = 0, k= 0;


    //我们想设置的最大间距,可根据需要改

    NSInteger maximumSpacing = _maximumSpacing;


    for(int i = 0; i < [attributes count]; ++i) {

        //当前attributes

        UICollectionViewLayoutAttributes *currentLayoutAttributes = attributes[i];


        k = i %_itemCountPerRow;

        j = i /_itemCountPerRow;

        CGRect frame = currentLayoutAttributes.frame;


        frame.origin.x = k * (self.itemSize.width+ maximumSpacing);

        frame.origin.y = j * (self.itemSize.height+ maximumSpacing);


        currentLayoutAttributes.frame= frame;

    }


    return attributes;

}


3.1.3 单元格间隔线

        自定义Cell,将ContentView的Frame设置稍小

- (void) initSubViews

{

    self.contentView.frame = CGRectMake(0, 0, self.frame.size.width - 1, self.frame.size.height - 1);

    self.backgroundColor = [UIColor colorWithRed: 224.0/255 green: 224.0/255 blue: 224.0/255 alpha:1.0];


    _infoImageView = [[UIImageView alloc] initWithFrame: CGRectMake(0, 0, self.contentView.frame.size.width, self.contentView.frame.size.height)];

    [self.contentView addSubview: _infoImageView];

}


3.1.4 ItemSize设置错误导致单元格加载不完全问题

CGSize itemSize = CGSizeMake([UIScreen mainScreen].bounds.size.width / 2.0-0.5, kProductListCellHeight - 1);

_flowLayout = [[HJCollectionViewEqualWidthFlowLayout alloc] initWithItemCountPerRow: kRow WithItemSize: itemSize];

_flowLayout.maximumSpacing = 1;

_flowLayout.minimumLineSpacing = 1;

_flowLayout.minimumInteritemSpacing = 1;

_collectionView = [[UICollectionView alloc] initWithFrame:CGRectZero collectionViewLayout: _flowLayout];


要点1:单元格尺寸计算时要来考虑间隔线宽度的影响;

要点2:minimumLineSpacing与minimumInteritemSpacing属性必须成对使用;


4 参考链接

UICollectionView详解

http://blog.csdn.net/majiakun1/article/details/17204693


UICollectionView的使用方法及demo

http://www.tuicool.com/articles/QJjeqy


iOS开发-UICollectionView详解+实例

http://www.cnblogs.com/ios8/p/iOS-UICollectionView.html


iOS开发 纯代码创建UICollectionView

http://jingyan.baidu.com/article/eb9f7b6d8a81a5869364e8a6.html


UICollectionView不同大小Cell等间距的实现

http://www.th7.cn/Program/IOS/201505/449935.shtml


UICollectionView cell横向间距如何调整(列距调整)  

http://www.cocoachina.com/bbs/read.php?tid-245356.html


ios开发——解决UICollectionView的cell间距与设置不符问题

http://www.bkjia.com/IOSjc/917782.html


UICollectionView使用小结

http://web.gxzj.com.cn/News.aspx?id=308277

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,015评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,262评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,727评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,986评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,363评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,610评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,871评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,582评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,297评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,551评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,053评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,385评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,035评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,079评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,841评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,648评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,550评论 2 270

推荐阅读更多精彩内容