//
//  CGXVerticalMenuListContainerView.h
//  CGXVerticalMenuView-OC
//
//  Created by CGX on 2018/05/01.
//  Copyright © 2019 CGX. All rights reserved.
//

#import <UIKit/UIKit.h>
#import "CGXVerticalMenuListContainerViewDelegate.h"

@class CGXVerticalMenuListContainerView;

/**
 列表容器视图的类型
 - CollectionView: 使用UICollectionView。
 优势：因为列表被添加到cell上，视图的内存占用更少。
 劣势：因为cell重用机制的问题，导致列表下拉刷新视图，会因为被removeFromSuperview而被隐藏。需要参考做特殊处理。
 */

@protocol CGXVerticalMenuListContainerViewDataSource <NSObject>
/**
 返回list的数量

 @param listContainerView 列表的容器视图
 @return list的数量
 */
- (NSInteger)numberOfListsInlistContainerView:(CGXVerticalMenuListContainerView *)listContainerView;

/**
 根据index返回一个对应列表实例，需要是遵从`CGXVerticalMenuListContainerViewDelegate`协议的对象。
 你可以代理方法调用的时候初始化对应列表，达到懒加载的效果。这也是默认推荐的初始化列表方法。你也可以提前创建好列表，等该代理方法回调的时候再返回也可以，达到预加载的效果。
 如果列表是用自定义UIView封装的，就让自定义UIView遵从`CGXVerticalMenuListContainerViewDelegate`协议，该方法返回自定义UIView即可。
 如果列表是用自定义UIViewController封装的，就让自定义UIViewController遵从`CGXVerticalMenuListContainerViewDelegate`协议，该方法返回自定义UIViewController即可。

 @param listContainerView 列表的容器视图
 @param index 目标下标
 @return 遵从CGXVerticalMenuListContainerViewDelegate协议的list实例
 */
- (id<CGXVerticalMenuListContainerViewDelegate>)listContainerView:(CGXVerticalMenuListContainerView *)listContainerView initListForIndex:(NSInteger)index;

@optional
/**
 返回自定义UIScrollView或UICollectionView的Class
 某些特殊情况需要自己处理UIScrollView内部逻辑。比如项目用了FDFullscreenPopGesture，需要处理手势相关代理。

 @param listContainerView CGXVerticalMenuListContainerView
 @return 自定义UIScrollView实例
 */
- (Class)scrollViewClassInlistContainerView:(CGXVerticalMenuListContainerView *)listContainerView;

/**
 控制能否初始化对应index的列表。有些业务需求，需要在某些情况才允许初始化某些列表，通过通过该代理实现控制。
 */
- (BOOL)listContainerView:(CGXVerticalMenuListContainerView *)listContainerView canInitListAtIndex:(NSInteger)index;

- (void)listContainerViewDidScroll:(UIScrollView *)scrollView;

@end


@interface CGXVerticalMenuListContainerView : UIView

@property (nonatomic, strong, readonly) UICollectionView *collectionView;
@property (nonatomic, strong, readonly) NSDictionary <NSNumber *, id<CGXVerticalMenuListContainerViewDelegate>> *validListDict;   //已经加载过的列表字典。key是index，value是对应的列表
/**
 滚动切换的时候，滚动距离超过一页的多少百分比，就触发列表的初始化。默认0.01（即列表显示了一点就触发加载）。范围0~1，开区间不包括0和1
 */
@property (nonatomic, assign) CGFloat initListPercent;
@property (nonatomic, assign) BOOL bounces; //默认NO
@property (nonatomic, assign,readonly) NSInteger currentIndex;
@property (nonatomic, assign) BOOL isHorizontal; //默认NO

- (instancetype)init NS_UNAVAILABLE;
- (instancetype)initWithFrame:(CGRect)frame NS_UNAVAILABLE;
- (instancetype)initWithCoder:(NSCoder *)aDecoder NS_UNAVAILABLE;
- (instancetype)initWithDelegate:(id<CGXVerticalMenuListContainerViewDataSource>)delegate NS_DESIGNATED_INITIALIZER;
- (void)didClickSelectedItemAtIndex:(NSInteger)index;
- (void)scrollSelectedItemAtIndex:(NSInteger)index;
- (void)reloadData;

@end