144 lines
4.4 KiB
C
144 lines
4.4 KiB
C
|
//
|
|||
|
|
// GKCycleScrollView.h
|
|||
|
|
// GKCycleScrollViewDemo
|
|||
|
|
//
|
|||
|
|
// Created by QuintGao on 2019/9/15.
|
|||
|
|
// Copyright © 2019 QuintGao. All rights reserved.
|
|||
|
|
//
|
|||
|
|
|
|||
|
|
#import <UIKit/UIKit.h>
|
|||
|
|
#import "GKCycleScrollViewCell.h"
|
|||
|
|
|
|||
|
|
// 滚动方向
|
|||
|
|
typedef NS_ENUM(NSUInteger, GKCycleScrollViewScrollDirection) {
|
|||
|
|
GKCycleScrollViewScrollDirectionHorizontal = 0, // 横向
|
|||
|
|
GKCycleScrollViewScrollDirectionVertical = 1 // 纵向
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
@class GKCycleScrollView;
|
|||
|
|
|
|||
|
|
/// 数据源代理
|
|||
|
|
@protocol GKCycleScrollViewDataSource <NSObject>
|
|||
|
|
|
|||
|
|
/// 返回cell个数
|
|||
|
|
/// @param cycleScrollView cycleScrollView description
|
|||
|
|
- (NSInteger)numberOfCellsInCycleScrollView:(GKCycleScrollView *)cycleScrollView;
|
|||
|
|
|
|||
|
|
/// 返回继承自GKCycleScrollViewCell的类
|
|||
|
|
/// @param cycleScrollView cycleScrollView description
|
|||
|
|
/// @param index 索引
|
|||
|
|
- (__kindof GKCycleScrollViewCell *)cycleScrollView:(GKCycleScrollView *)cycleScrollView cellForViewAtIndex:(NSInteger)index;
|
|||
|
|
|
|||
|
|
@end
|
|||
|
|
|
|||
|
|
@protocol GKCycleScrollViewDelegate <NSObject>
|
|||
|
|
|
|||
|
|
@optional
|
|||
|
|
/// 返回自定义cell尺寸
|
|||
|
|
/// @param cycleScrollView cycleScrollView description
|
|||
|
|
- (CGSize)sizeForCellInCycleScrollView:(GKCycleScrollView *)cycleScrollView;
|
|||
|
|
|
|||
|
|
// cell滑动时调用
|
|||
|
|
- (void)cycleScrollView:(GKCycleScrollView *)cycleScrollView didScrollCellToIndex:(NSInteger)index;
|
|||
|
|
|
|||
|
|
// cell点击时调用
|
|||
|
|
- (void)cycleScrollView:(GKCycleScrollView *)cycleScrollView didSelectCellAtIndex:(NSInteger)index;
|
|||
|
|
|
|||
|
|
/// scrollView滚动中的回调
|
|||
|
|
/// @param cycleScrollView cycleScrollView对象
|
|||
|
|
/// @param fromIndex 正在滚动中，相对位置处于左边或上边的index，根据direction区分
|
|||
|
|
/// @param toIndex 正在滚动中，相对位置处于右边或下边的index，根据direction区分
|
|||
|
|
/// @param ratio 从左到右或从上到下计算的百分比，根据direction区分
|
|||
|
|
- (void)cycleScrollView:(GKCycleScrollView *)cycleScrollView scrollingFromIndex:(NSInteger)fromIndex toIndex:(NSInteger)toIndex ratio:(CGFloat)ratio;
|
|||
|
|
#pragma mark - UIScrollViewDelegate 相关
|
|||
|
|
- (void)cycleScrollView:(GKCycleScrollView *)cycleScrollView willBeginDragging:(UIScrollView *)scrollView;
|
|||
|
|
- (void)cycleScrollView:(GKCycleScrollView *)cycleScrollView didScroll:(UIScrollView *)scrollView;
|
|||
|
|
- (void)cycleScrollView:(GKCycleScrollView *)cycleScrollView didEndDragging:(UIScrollView *)scrollView willDecelerate:(BOOL)decelerate;
|
|||
|
|
- (void)cycleScrollView:(GKCycleScrollView *)cycleScrollView didEndDecelerating:(UIScrollView *)scrollView;
|
|||
|
|
- (void)cycleScrollView:(GKCycleScrollView *)cycleScrollView didEndScrollingAnimation:(UIScrollView *)scrollView;
|
|||
|
|
|
|||
|
|
@end
|
|||
|
|
|
|||
|
|
@interface GKCycleScrollView : UIView
|
|||
|
|
|
|||
|
|
// 数据源
|
|||
|
|
@property (nonatomic, weak) id<GKCycleScrollViewDataSource> dataSource;
|
|||
|
|
// 代理
|
|||
|
|
@property (nonatomic, weak) id<GKCycleScrollViewDelegate> delegate;
|
|||
|
|
|
|||
|
|
// 滚动方向，默认为横向
|
|||
|
|
@property (nonatomic, assign) GKCycleScrollViewScrollDirection direction;
|
|||
|
|
|
|||
|
|
// 滚动视图
|
|||
|
|
@property (nonatomic, strong, readonly) UIScrollView *scrollView;
|
|||
|
|
|
|||
|
|
// 默认为nil，需外部创建并传入
|
|||
|
|
@property (nonatomic, weak) UIPageControl *pageControl;
|
|||
|
|
|
|||
|
|
// 当前展示的cell
|
|||
|
|
@property (nonatomic, strong, readonly) GKCycleScrollViewCell *currentCell;
|
|||
|
|
|
|||
|
|
// 当前显示的页码
|
|||
|
|
@property (nonatomic, assign, readonly) NSInteger currentSelectIndex;
|
|||
|
|
|
|||
|
|
// 默认选中的页码（默认：0）
|
|||
|
|
@property (nonatomic, assign) NSInteger defaultSelectIndex;
|
|||
|
|
|
|||
|
|
// 是否自动滚动，默认YES
|
|||
|
|
@property (nonatomic, assign) BOOL isAutoScroll;
|
|||
|
|
|
|||
|
|
// 是否无限循环，默认YES
|
|||
|
|
@property (nonatomic, assign) BOOL isInfiniteLoop;
|
|||
|
|
|
|||
|
|
// 是否改变透明度，默认YES
|
|||
|
|
@property (nonatomic, assign) BOOL isChangeAlpha;
|
|||
|
|
|
|||
|
|
// 非当前页cell的最小透明度，默认1.0f
|
|||
|
|
@property (nonatomic, assign) CGFloat minimumCellAlpha;
|
|||
|
|
|
|||
|
|
// 左右间距，默认0
|
|||
|
|
@property (nonatomic, assign) CGFloat leftRightMargin;
|
|||
|
|
|
|||
|
|
// 上下间距，默认0
|
|||
|
|
@property (nonatomic, assign) CGFloat topBottomMargin;
|
|||
|
|
|
|||
|
|
// 自动滚动时间间隔，默认3s
|
|||
|
|
@property (nonatomic, assign) CGFloat autoScrollTime;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
刷新数据，必须调用此方法
|
|||
|
|
*/
|
|||
|
|
- (void)reloadData;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
获取可重复使用的cell
|
|||
|
|
|
|||
|
|
@return cell
|
|||
|
|
*/
|
|||
|
|
- (GKCycleScrollViewCell *)dequeueReusableCell;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
滑动到指定cell
|
|||
|
|
|
|||
|
|
@param index 指定cell的索引
|
|||
|
|
@param animated 是否动画
|
|||
|
|
*/
|
|||
|
|
- (void)scrollToCellAtIndex:(NSInteger)index animated:(BOOL)animated;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
调整当前显示的cell的位置，防止出现滚动时卡住一半
|
|||
|
|
*/
|
|||
|
|
- (void)adjustCurrentCell;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
开启定时器
|
|||
|
|
*/
|
|||
|
|
- (void)startTimer;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
关闭定时器
|
|||
|
|
*/
|
|||
|
|
- (void)stopTimer;
|
|||
|
|
|
|||
|
|
@end
|