123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131 |
- //
- // JXPagerView.h
- // JXPagerView
- //
- // Created by jiaxin on 2018/8/27.
- // Copyright © 2018年 jiaxin. All rights reserved.
- //
- #import <UIKit/UIKit.h>
- #import "JXPagerMainTableView.h"
- #import "JXPagerListContainerView.h"
- @class JXPagerView;
- @protocol JXPagerViewDelegate <NSObject>
- /**
- 返回tableHeaderView的高度,因为内部需要比对判断,只能是整型数
- */
- - (NSUInteger)tableHeaderViewHeightInPagerView:(JXPagerView *)pagerView;
- /**
- 返回tableHeaderView
- */
- - (UIView *)tableHeaderViewInPagerView:(JXPagerView *)pagerView;
- /**
- 返回悬浮HeaderView的高度,因为内部需要比对判断,只能是整型数
- */
- - (NSUInteger)heightForPinSectionHeaderInPagerView:(JXPagerView *)pagerView;
- /**
- 返回悬浮HeaderView。我用的是自己封装的JXCategoryView(Github:https://github.com/pujiaxin33/JXCategoryView),你也可以选择其他的三方库或者自己写
- */
- - (UIView *)viewForPinSectionHeaderInPagerView:(JXPagerView *)pagerView;
- /**
- 返回列表的数量
- */
- - (NSInteger)numberOfListsInPagerView:(JXPagerView *)pagerView;
- /**
- 根据index初始化一个对应列表实例,需要是遵从`JXPagerViewListViewDelegate`协议的对象。
- 如果列表是用自定义UIView封装的,就让自定义UIView遵从`JXPagerViewListViewDelegate`协议,该方法返回自定义UIView即可。
- 如果列表是用自定义UIViewController封装的,就让自定义UIViewController遵从`JXPagerViewListViewDelegate`协议,该方法返回自定义UIViewController即可。
- 注意:一定要是新生成的实例!!!
- @param pagerView pagerView description
- @param index index description
- @return 新生成的列表实例
- */
- - (id<JXPagerViewListViewDelegate>)pagerView:(JXPagerView *)pagerView initListAtIndex:(NSInteger)index;
- @optional
- /// 返回对应index的列表唯一标识
- /// @param pagerView pagerView description
- /// @param index index description
- - (NSString *)pagerView:(JXPagerView *)pagerView listIdentifierAtIndex:(NSInteger)index;
- - (void)mainTableViewDidScroll:(UIScrollView *)scrollView __attribute__ ((deprecated));
- - (void)pagerView:(JXPagerView *)pagerView mainTableViewDidScroll:(UIScrollView *)scrollView;
- - (void)pagerView:(JXPagerView *)pagerView mainTableViewWillBeginDragging:(UIScrollView *)scrollView;
- - (void)pagerView:(JXPagerView *)pagerView mainTableViewDidEndDragging:(UIScrollView *)scrollView willDecelerate:(BOOL)decelerate;
- - (void)pagerView:(JXPagerView *)pagerView mainTableViewDidEndDecelerating:(UIScrollView *)scrollView;
- - (void)pagerView:(JXPagerView *)pagerView mainTableViewDidEndScrollingAnimation:(UIScrollView *)scrollView;
- /**
- 返回自定义UIScrollView或UICollectionView的Class
- 某些特殊情况需要自己处理列表容器内UIScrollView内部逻辑。比如项目用了FDFullscreenPopGesture,需要处理手势相关代理。
- @param pagerView JXPagerView
- @return 自定义UIScrollView实例
- */
- - (Class)scrollViewClassInlistContainerViewInPagerView:(JXPagerView *)pagerView;
- @end
- @interface JXPagerView : UIView
- /**
- 需要和self.categoryView.defaultSelectedIndex保持一致
- */
- @property (nonatomic, assign) NSInteger defaultSelectedIndex;
- @property (nonatomic, strong, readonly) JXPagerMainTableView *mainTableView;
- @property (nonatomic, strong, readonly) JXPagerListContainerView *listContainerView;
- /**
- 当前已经加载过可用的列表字典,key就是index值,value是对应的列表。
- */
- @property (nonatomic, strong, readonly) NSDictionary <NSNumber *, id<JXPagerViewListViewDelegate>> *validListDict;
- /**
- 顶部固定sectionHeader的垂直偏移量。数值越大越往下沉。
- */
- @property (nonatomic, assign) NSInteger pinSectionHeaderVerticalOffset;
- /**
- 是否允许列表左右滑动。默认:YES
- */
- @property (nonatomic, assign) BOOL isListHorizontalScrollEnabled;
- /**
- 是否允许当前列表自动显示或隐藏列表是垂直滚动指示器。YES:悬浮的headerView滚动到顶部开始滚动列表时,就会显示,反之隐藏。NO:内部不会处理列表的垂直滚动指示器。默认为:YES。
- */
- @property (nonatomic, assign) BOOL automaticallyDisplayListVerticalScrollIndicator;
- /**
- 当allowsCacheList为true时,请务必实现代理方法`- (NSString *)pagerView:(JXPagerView *)pagerView listIdentifierAtIndex:(NSInteger)index`
- */
- @property (nonatomic, assign) BOOL allowsCacheList;
- - (instancetype)initWithDelegate:(id<JXPagerViewDelegate>)delegate;
- - (instancetype)initWithDelegate:(id<JXPagerViewDelegate>)delegate listContainerType:(JXPagerListContainerType)type NS_DESIGNATED_INITIALIZER;
- - (instancetype)init NS_UNAVAILABLE;
- - (instancetype)initWithFrame:(CGRect)frame NS_UNAVAILABLE;
- - (instancetype)initWithCoder:(NSCoder *)aDecoder NS_UNAVAILABLE;
- - (void)reloadData;
- - (void)resizeTableHeaderViewHeightWithAnimatable:(BOOL)animatable duration:(NSTimeInterval)duration curve:(UIViewAnimationCurve)curve;
- @end
- /**
- 暴露给子类使用,请勿直接使用相关属性和方法!
- */
- @interface JXPagerView (UISubclassingGet)
- @property (nonatomic, strong, readonly) UIScrollView *currentScrollingListView;
- @property (nonatomic, strong, readonly) id<JXPagerViewListViewDelegate> currentList;
- @property (nonatomic, assign, readonly) CGFloat mainTableViewMaxContentOffsetY;
- @end
- @interface JXPagerView (UISubclassingHooks)
- - (void)preferredProcessListViewDidScroll:(UIScrollView *)scrollView;
- - (void)preferredProcessMainTableViewDidScroll:(UIScrollView *)scrollView;
- - (void)setMainTableViewToMaxContentOffsetY;
- - (void)setListScrollViewToMinContentOffsetY:(UIScrollView *)scrollView;
- - (CGFloat)minContentOffsetYInListScrollView:(UIScrollView *)scrollView;
- @end
|