文档

轮播组件

更新时间:

AUBannerView 为图片轮播组件。

效果图

接口说明

typedef NS_ENUM(NSUInteger, AUBannerStyle) {
    AUBannerStyleDeepColor, // 深色样式
    AUBannerStyleLightColor // 浅色样式
};

@interface AUBannerViewConfig : NSObject

@property (nonatomic, assign) AUBannerStyle                  style;                       // 默认的样式
@property (nonatomic, strong) UIColor                       *pageControlNormalColor;      // 默认色
@property (nonatomic, strong) UIColor                       *pageControlSelectedColor;    // 选中色
@property (nonatomic, assign) CGFloat                        pageControlMarginBottom;     // 分页标识距离底部的margin
@property (nonatomic, assign) BOOL                           pageControlDotTapEnabled;    // 分页标识圆点是否支持点击(默认为NO)
@property (nonatomic, assign) UIEdgeInsets                   contentViewMargin;           // 内容区边距
@property (nonatomic, assign) UIEdgeInsets                   contentViewPadding;          // 内容空白区,滚动时会经过该区域
@property (nonatomic, assign) BOOL                           autoTurn;                    // 自动轮播(默认为 YES)
@property (nonatomic, assign) BOOL                           autoStartTurn;               // 自动开始轮播
@property (nonatomic, assign) CGFloat                        duration;                    // 自动轮播间隔

@end


@class AUBannerView;
@protocol AUBannerViewDelegate <NSObject>

@required
- (NSInteger)numberOfItemsInBannerView:(AUBannerView *)bannerView;
- (UIView *)bannerView:(AUBannerView *)bannerView itemViewAtPos:(NSInteger)pos;

@optional
- (void)bannerView:(AUBannerView *)bannerView didTapedItemAtPos:(NSInteger)pos;
- (CGFloat)bannerView:(AUBannerView *)bannerView durationOfItemAtPos:(NSInteger)pos;

@end



@interface AUBannerView : UIView

AU_UNAVAILABLE_INIT

@property (nonatomic, readonly) UIView                  *contentView;   // 内容区视图
@property (nonatomic, readonly) AUPageControl           *pageControl;   // 分页标识视图

@property (nonatomic, copy)     NSString                *bizType;       // 业务标识
@property (nonatomic, assign)   NSInteger                currentPage;   // 当前页码(从 0 开始)
@property (nonatomic, weak)     id<AUBannerViewDelegate> delegate;      // 数据源和事件代理


/**
 创建banner视图

 @param frame frame
 @param bizType 业务标识(不能为空)
 @param configOperation 配置 block
 @return banner 视图
 */
- (instancetype)initWithFrame:(CGRect)frame
                      bizType:(NSString *)bizType
                   makeConfig:(void(^)(AUBannerViewConfig *config))configOperation;


/**
 开始自动轮播(如果 autoStartTurn 设置为 NO,才需要调用这个方法)
 */
- (void)startTurning;


/**
 重新加载 banner(数据源变更,需调用此方法重新加载数据)
 */
- (void)reloadData;

@end





//################################
//####### UIImage ################
//################################

@interface AUBannerView (Image)

/**
 创建图片的banner视图
 注意:需要保持 imageURLs 和 actionURLs 相等,否则创建失败

 @param frame frame
 @param bizType 业务标识(不能为空)
 @param images 图片集合(可为图片链接字符串,或者 image 对象)
 @param placeholder 图片占位图(UIImage 对象)
 @param actionURLs 图片点击后的跳转链接(字符串,如果某张图不支持跳转,请设置 [NSNull null])
 @param configOperation banner 视图的配置参数
 @return 轮播图片的 banner 视图
 */
+ (instancetype)bannerViewWithFrame:(CGRect)frame
                            bizType:(NSString *)bizType
                             images:(NSArray *)images
                        placeholder:(UIImage *)placeholder
                         actionURLs:(NSArray *)actionURLs
                         makeConfig:(void(^)(AUBannerViewConfig *config))configOperation;

@end




//################################
//####### Extension ##############
//################################


@interface AUBannerView (Extension)

/**
 更新 bannerview 配置
 会自动触发 reload 事件

 @param update update 的 block
 */
- (void)updateConfigOperation:(void(^)(AUBannerViewConfig *config))update;

@end

代码示例

// 普通 banner(深色)
    for (NSInteger i = 0; i < 1; i ++) {
        CGRect rect = CGRectMake(10, 10 + (height + spaceY) * i, self.view.width - 20, height);
        AUBannerView *bannerView = [[AUBannerView alloc] initWithFrame:rect
                                                               bizType:@"demo"
                                                            makeConfig:^(AUBannerViewConfig *config)
                                    {
                                        config.duration = 1.5;
//                                        config.contentViewMargin = UIEdgeInsetsMake(5, 5, 10, 5);
//                                        config.contentViewPadding = UIEdgeInsetsMake(0, 50, 0, 50);
                                        config.style = AUBannerStyleDeepColor;
                                        config.autoTurn = YES;
                                        config.autoStartTurn = YES;
                                    }];

        bannerView.delegate = self;
        bannerView.tag = 1;
        bannerView.backgroundColor = [UIColor colorWithWhite:0 alpha:0.1];
        [self.view addSubview:bannerView];
    }

    // 普通 banner(浅色)
    for (NSInteger i = 1; i < 2; i ++) {
        CGRect rect = CGRectMake(10, 10 + (height + spaceY) * i, self.view.width - 20, height);
        AUBannerView *bannerView = [[AUBannerView alloc] initWithFrame:rect
                                                               bizType:@"demo"
                                                            makeConfig:^(AUBannerViewConfig *config)
                                    {
                                        config.duration = 1.5;
                                        config.style = AUBannerStyleLightColor;
                                        config.autoTurn = NO;
                                        config.pageControlDotTapEnabled = YES;
                                    }];

        bannerView.delegate = self;
        bannerView.tag = 2;
        bannerView.backgroundColor = [UIColor colorWithWhite:0 alpha:0.1];
        [self.view addSubview:bannerView];
    }

    // 纯图片banner
    for (NSInteger i = 2; i < 3; i ++) {
        CGRect rect = CGRectMake(10, 10 + (height + spaceY) * i, self.view.width - 20, height);
        NSMutableArray *images = [NSMutableArray array];
        for (NSInteger j = 0; j < 5; j ++) {
            UIImage *image = [UIImage imageNamed:[NSString stringWithFormat:@"%@.jpg", @(j + 1)]];
            [images addObject:image];
        }
        AUBannerView *bannerView = [AUBannerView bannerViewWithFrame:rect
                                                             bizType:@"demo"
                                                              images:images
                                                         placeholder:nil
                                                          actionURLs:nil
                                                          makeConfig:NULL];
        bannerView.backgroundColor = [UIColor colorWithWhite:0 alpha:0.1];
        [self.view addSubview:bannerView];
    }
#pragma mark - AUBannerViewDelegate

- (NSInteger)numberOfItemsInBannerView:(AUBannerView *)bannerView
{
    return bannerView.tag == 1 ? 2 : 4;
}

- (UIView *)bannerView:(AUBannerView *)bannerView itemViewAtPos:(NSInteger)pos
{
    NSArray *array = nil;
    // 深色
    if (bannerView.tag == 1) {
        array = @[RGB(0x108EE9), RGB_A(0x108EE9, 0.5), [UIColor blueColor], [UIColor yellowColor]];
    }
    // 浅色
    else {
        array = @[RGB(0xfFFFFF),RGB_A(0xeFFFFF, 0.7),RGB(0xcFFFFF),RGB_A(0xeFFFFF, 0.5),RGB_A(0xeFFFFF, 0.9)];
    }

    UIView *view = [[UIView alloc] init];
    view.backgroundColor = array[pos];
    return view;
}


- (void)bannerView:(AUBannerView *)bannerView didTapedItemAtPos:(NSInteger)pos
{
    NSLog(@"didTapedItemAtPos %@", @(pos));
}

//- (CGFloat)bannerView:(AUBannerView *)bannerView durationOfItemAtPos:(NSInteger)pos
//{
//    return 1;
//}
  • 本页导读 (0)
文档反馈