UICollectionViewFlowLayout API详解

#import <UIKit/UICollectionViewLayout.h>
#import <UIKit/UICollectionView.h>
#import <UIKit/UIKitDefines.h>
#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN
//判断是否是头或者尾
UIKIT_EXTERN NSString *const UICollectionElementKindSectionHeader NS_AVAILABLE_IOS(6_0);
UIKIT_EXTERN NSString *const UICollectionElementKindSectionFooter NS_AVAILABLE_IOS(6_0);
UIKIT_EXTERN const CGSize UICollectionViewFlowLayoutAutomaticSize  NS_AVAILABLE_IOS(10_0);

//支持的滑动情况
typedef NS_ENUM(NSInteger, UICollectionViewScrollDirection) {
    UICollectionViewScrollDirectionVertical,
    UICollectionViewScrollDirectionHorizontal
};

NS_CLASS_AVAILABLE_IOS(7_0) @interface UICollectionViewFlowLayoutInvalidationContext : UICollectionViewLayoutInvalidationContext

//此属性的默认值为NO。如果由于更改了任何项目的大小而使布局无效，请将此属性设置为YES。
@property (nonatomic) BOOL invalidateFlowLayoutDelegateMetrics; 

//此属性的默认值为NO。如果屏幕上项目的位置有变化，请将此属性设置为YES。例如，当集合视图的边界以影响列或行中的项目数量的方式更改时，流布局对象将此属性设置为YES。
//当此属性设置为YES时，流布局对象将重新计算其项目和视图的布局属性。如果无效的流程布局委托度量属性设置为否，则重新计算此信息，而不要求新的大小信息。
@property (nonatomic) BOOL invalidateFlowLayoutAttributes; 

@end

@protocol UICollectionViewDelegateFlowLayout <UICollectionViewDelegate>
@optional

//返回每个item的size
- (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout sizeForItemAtIndexPath:(NSIndexPath *)indexPath;

//返回上左下右四边的距离
- (UIEdgeInsets)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout insetForSectionAtIndex:(NSInteger)section;

//返回cell之间的最小行间距
- (CGFloat)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout minimumLineSpacingForSectionAtIndex:(NSInteger)section;

//cell之间的最小列间距
- (CGFloat)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout minimumInteritemSpacingForSectionAtIndex:(NSInteger)section;

//设置头的size
- (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout referenceSizeForHeaderInSection:(NSInteger)section;

//设置脚的size
- (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout referenceSizeForFooterInSection:(NSInteger)section;

@end

NS_CLASS_AVAILABLE_IOS(6_0) @interface UICollectionViewFlowLayout : UICollectionViewLayout

//cell之间的最小行间距
@property (nonatomic) CGFloat minimumLineSpacing;

//cell之间的最小列间距
@property (nonatomic) CGFloat minimumInteritemSpacing;

//cell的尺寸，如果每个cell的size都不同则不用这个方法
@property (nonatomic) CGSize itemSize;

//cell的预估尺寸
//默认为CGSizeZero - 设置非零大小启用通过-preferredLayoutAttributesFittingAttributes自定义的单元格：
@property (nonatomic) CGSize estimatedItemSize NS_AVAILABLE_IOS(8_0); // 

//UICollectionView的滚动方向,默认是垂直滚动
@property (nonatomic) UICollectionViewScrollDirection scrollDirection;

//HeaderView的尺寸
@property (nonatomic) CGSize headerReferenceSize;

//FooterView的尺寸
@property (nonatomic) CGSize footerReferenceSize;

//分区的四边距
@property (nonatomic) UIEdgeInsets sectionInset;

//设置是否当元素超出屏幕之后固定页眉视图位置，默认NO
@property (nonatomic) BOOL sectionHeadersPinToVisibleBounds NS_AVAILABLE_IOS(9_0);

//设置是否当元素超出屏幕之后固定页脚视图位置，默认NO
@property (nonatomic) BOOL sectionFootersPinToVisibleBounds NS_AVAILABLE_IOS(9_0);

@end

NS_ASSUME_NONNULL_END