144 lines
4.4 KiB
Objective-C
144 lines
4.4 KiB
Objective-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
|