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

2023-10-16 11:41:10 浏览数 (1)

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

0 人点赞