137 lines
7.7 KiB
Objective-C
Executable File
137 lines
7.7 KiB
Objective-C
Executable File
//
|
||
// ZLCollectionViewBaseFlowLayout.h
|
||
// ZLCollectionView
|
||
//
|
||
// Created by zhaoliang chen on 2019/1/25.
|
||
// Copyright © 2019 zhaoliang chen. All rights reserved.
|
||
//
|
||
|
||
#import <UIKit/UIKit.h>
|
||
#import "ZLBaseEventModel.h"
|
||
|
||
/**
|
||
版本：1.4.9
|
||
*/
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
typedef enum {
|
||
LabelHorizontalLayout = 1, //标签横向
|
||
LabelVerticalLayout = 2, //标签纵向
|
||
LabelLayout = LabelHorizontalLayout, //标签页布局。 一堆label标签的集合
|
||
ClosedLayout = 3,
|
||
ColumnLayout = ClosedLayout, //列布局 指定列数，按列数来等分一整行，itemSize的width可以任意写，在布局中会自动帮你计算。可用于瀑布流，普通UITableViewCell
|
||
PercentLayout = 4, //百分比布局 需实现percentOfRow的代理，根据设定值来计算每个itemSize的宽度
|
||
FillLayout = 5, //填充式布局 将一堆大小不一的view见缝插针的填充到一个平面内，规则为先判断从左到右是否有间隙填充，再从上到下判断。
|
||
AbsoluteLayout = 6, //绝对定位布局 需实现rectOfItem的代理，指定每个item的frame
|
||
} ZLLayoutType;
|
||
|
||
typedef enum {
|
||
minHeight = 1, // 按最小高度
|
||
Sequence = 2, // 按顺序
|
||
} ZLColumnSortType;
|
||
|
||
@class ZLCollectionViewBaseFlowLayout;
|
||
@protocol ZLCollectionViewBaseFlowLayoutDelegate <NSObject, UICollectionViewDelegateFlowLayout>
|
||
@optional
|
||
//指定是什么布局，如没有指定则为FillLayout(填充式布局)
|
||
- (ZLLayoutType)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout *)collectionViewLayout typeOfLayout:(NSInteger)section;
|
||
|
||
/******** 设置每个section的背景色 ***********/
|
||
//设置每个section的背景色
|
||
- (UIColor*)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout *)collectionViewLayout backColorForSection:(NSInteger)section;
|
||
|
||
//设置每个section的背景图
|
||
- (UIImage*)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout *)collectionViewLayout backImageForSection:(NSInteger)section;
|
||
|
||
//自定义每个section的背景view，需要继承UICollectionReusableView(如要调用方法传递参数需要继承ZLCollectionBaseDecorationView)，返回类名
|
||
- (NSString*)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout *)collectionViewLayout registerBackView:(NSInteger)section;
|
||
|
||
//向每个section自定义背景view传递自定义方法 eventName:方法名（注意带参数的方法名必须末尾加:）,parameter:参数
|
||
- (ZLBaseEventModel*)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout *)collectionViewLayout backgroundViewMethodForSection:(NSInteger)section;
|
||
|
||
//背景是否延伸覆盖到headerView，默认为NO
|
||
- (BOOL)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout *)collectionViewLayout attachToTop:(NSInteger)section;
|
||
|
||
//背景是否延伸覆盖到footerView，默认为NO
|
||
- (BOOL)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout *)collectionViewLayout attachToBottom:(NSInteger)section;
|
||
|
||
/******** 提取出UICollectionViewLayoutAttributes的一些属性 ***********/
|
||
//设置每个item的zIndex，不指定默认为0
|
||
- (NSInteger)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout *)collectionViewLayout zIndexOfItem:(NSIndexPath*)indexPath;
|
||
//设置每个item的CATransform3D，不指定默认为CATransform3DIdentity
|
||
- (CATransform3D)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout *)collectionViewLayout transformOfItem:(NSIndexPath*)indexPath;
|
||
//设置每个item的alpha，不指定默认为1
|
||
- (CGFloat)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout *)collectionViewLayout alphaOfItem:(NSIndexPath*)indexPath;
|
||
|
||
/******** ClosedLayout列布局需要的代理 ***********/
|
||
//在ClosedLayout列布局中指定一行有几列，不指定默认为1列
|
||
- (NSInteger)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout*)collectionViewLayout columnCountOfSection:(NSInteger)section;
|
||
|
||
//在ClosedLayout列布局中指定哪列哪行可以是单行布局，不指定以上个方法为准
|
||
- (BOOL)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout*)collectionViewLayout singleColumnCountOfIndexPath:(NSIndexPath*)indexPath;
|
||
|
||
/******** PercentLayout百分比布局需要的代理 ***********/
|
||
//在PercentLayout百分比布局中指定每个item占该行的几分之几，如3.0/4，注意为大于0小于等于1的数字。不指定默认为1
|
||
- (CGFloat)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout*)collectionViewLayout percentOfRow:(NSIndexPath*)indexPath;
|
||
|
||
/******** AbsoluteLayout绝对定位布局需要的代理 ***********/
|
||
//在AbsoluteLayout绝对定位布局中指定每个item的frame，不指定默认为CGRectZero
|
||
- (CGRect)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout*)collectionViewLayout rectOfItem:(NSIndexPath*)indexPath;
|
||
|
||
/******** 拖动cell的相关代理 ***************************/
|
||
//- (BOOL)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout*)collectionViewLayout shouldMoveCell:(NSIndexPath*)indexPath;
|
||
|
||
- (void)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewFlowLayout*)collectionViewLayout didMoveCell:(NSIndexPath*)atIndexPath toIndexPath:(NSIndexPath*)toIndexPath;
|
||
|
||
@end
|
||
|
||
|
||
/***
|
||
此类是基类，不要调用。
|
||
|
||
纵向布局请调用 #import "ZLCollectionViewVerticalLayout.h"
|
||
横向布局请调用 #import "ZLCollectionViewHorzontalLayout.h"
|
||
***/
|
||
@interface ZLCollectionViewBaseFlowLayout : UICollectionViewFlowLayout
|
||
|
||
@property (nonatomic,weak) id<ZLCollectionViewBaseFlowLayoutDelegate> delegate;
|
||
|
||
@property (nonatomic,assign) BOOL isFloor; // 宽度是否向下取整，默认YES，用于填充布局，未来加入百分比布局
|
||
|
||
@property (nonatomic,assign) BOOL canDrag; //是否允许拖动cell，默认是NO
|
||
|
||
@property (nonatomic,assign) BOOL header_suspension; //头部是否悬浮，默认是NO
|
||
|
||
@property (nonatomic,assign) ZLLayoutType layoutType; //指定layout的类型，也可以在代理里设置
|
||
|
||
@property (nonatomic,assign) NSInteger columnCount; //指定列数
|
||
|
||
@property (nonatomic,assign) ZLColumnSortType columnSortType; // 瀑布流列排序的方式
|
||
|
||
@property (nonatomic,assign) CGFloat fixTop; //header偏移量
|
||
|
||
@property (nonatomic,assign) CGFloat xBeyond; //x轴允许超出的偏移量（仅填充布局，默认3px）
|
||
|
||
//每个section的每一列的高度
|
||
@property (nonatomic, strong) NSMutableArray *collectionHeightsArray;
|
||
//存放每一个cell的属性
|
||
@property (nonatomic, strong) NSMutableArray *attributesArray;
|
||
//存放header属性, 外部不要干预
|
||
@property (nonatomic, strong, readonly) NSMutableArray *headerAttributesArray;
|
||
|
||
//是否需要重新计算所有布局
|
||
//内部控制，一般情况外部无需干预(内部会在外部调用reloadData,insertSections,insertItems,deleteItems...等方法调用时将此属性自动置为YES)
|
||
@property (nonatomic, assign, readonly) BOOL isNeedReCalculateAllLayout;
|
||
|
||
//提供一个方法来设置isNeedReCalculateAllLayout (之所以提供是因为特殊情况下外部可能需要强制重新计算布局)
|
||
//比如需要强制刷新布局时，可以先调用此函数设置为YES, 一般情况外部无需干预
|
||
- (void)forceSetIsNeedReCalculateAllLayout:(BOOL)isNeedReCalculateAllLayout;
|
||
|
||
// 注册所有的背景view(传入类名)
|
||
- (void)registerDecorationView:(NSArray<NSString*>*)classNames;
|
||
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|