LCBannerView

🔥 A very popular and highly customized banner view! Infinite loop!

In me the tiger sniffs the rose.

心有猛虎，细嗅蔷薇。

Welcome to my blog: http://LeoDev.me ✨

中文介绍

Introduction

This is a display of advertising or information.

You can using the images from Local or Internet.

And it won't affect other scrollViews' scrollsToTop properties.

If you feel good, please give me a star, thank you very much! ⭐️

Installation

CocoaPods

LCBannerView is available on CocoaPods. Just add the following to your project Podfile:

pod "LCBannerView"  # Podfile

Non-CocoaPods Installation

Just drag the LCBannerView folder into your project.

Usage

• Use by including the following import:

  #import "LCBannerView.h"

• Demo code:

  // 1. From internet
  [scrollView addSubview:({
  
      LCBannerView *bannerView = [LCBannerView bannerViewWithFrame:CGRectMake(0, 300.0f, [UIScreen mainScreen].bounds.size.width, 200.0f)
                                                          delegate:self
                                                         imageURLs:URLs
                                              placeholderImageName:nil
                                                      timeInterval:2.0f
                                     currentPageIndicatorTintColor:[UIColor redColor]
                                            pageIndicatorTintColor:[UIColor whiteColor]];
      bannerView.pageDistance = 20.0f;
      bannerView;
  })];
  
  // 2. From local
  // If you using images from local, you should let images named: `banner_01@2x.png`, `banner_02@2x.png`...
  // Than, you just give me a image named: `banner`. 😜
  [scrollView addSubview:({
  
      LCBannerView *bannerView = [[LCBannerView alloc] initWithFrame:CGRectMake(0, 20.0f, [UIScreen mainScreen].bounds.size.width, 200.0f)
                                                            delegate:self
                                                           imageName:@"banner"
                                                               count:3
                                                        timeInterval:3.0f
                                       currentPageIndicatorTintColor:[UIColor orangeColor]
                                              pageIndicatorTintColor:[UIColor whiteColor]];
      bannerView;
  })];

• Advise for run demo:

  You should comment out one of the Block code or Delegate code in demo code, it will help you read code more clearly.

  See below two points for more information.

• Block: (@optional)

  @property (nonatomic, copy) LCBannerViewDidClickedImageIndexBlock didClickedImageIndexBlock;
  
  @property (nonatomic, copy) LCBannerViewDidScrollToIndexBlock didScrollToIndexBlock;

  For example:

  bannerView.didClickedImageIndexBlock = ^(LCBannerView *bannerView, NSInteger index) {
      
      NSLog(@"Block: Clicked image in %p at index: %d", bannerView, (int)index);
  };
  
  bannerView.didScrollToIndexBlock = ^(LCBannerView *bannerView, NSInteger index) {
      
      NSLog(@"Block: Scrolled in %p to index: %d", bannerView, (int)index);
  };
  
  // Logs
  2016-07-29 15:41:00.344 LCBannerViewDemo[3251:295032] Block: Scrolled in 0x7ff473538ec0 to index: 1
  2016-07-29 15:41:03.343 LCBannerViewDemo[3251:295032] Block: Scrolled in 0x7ff473538ec0 to index: 2
  2016-07-29 15:41:05.132 LCBannerViewDemo[3251:295032] Block: Clicked image in 0x7ff473538ec0 at index: 2
  2016-07-29 15:41:06.344 LCBannerViewDemo[3251:295032] Block: Scrolled in 0x7ff473538ec0 to index: 0
  2016-07-29 15:41:09.344 LCBannerViewDemo[3251:295032] Block: Scrolled in 0x7ff473538ec0 to index: 1
  2016-07-29 15:41:12.342 LCBannerViewDemo[3251:295032] Block: Scrolled in 0x7ff473538ec0 to index: 2

• Delegate: (@optional)

  - (void)bannerView:(LCBannerView *)bannerView didClickedImageIndex:(NSInteger)index;
  
  - (void)bannerView:(LCBannerView *)bannerView didScrollToIndex:(NSInteger)index;

  For example:

  - (void)bannerView:(LCBannerView *)bannerView didClickedImageIndex:(NSInteger)index {
      
      NSLog(@"Delegate: Clicked image in %p at index: %d", bannerView, (int)index);
  }
  
  - (void)bannerView:(LCBannerView *)bannerView didScrollToIndex:(NSInteger)index {
      
      NSLog(@"Delegate: Scrolled in %p to index: %d", bannerView, (int)index);
  }
  
  // Logs
  2016-07-29 15:41:45.296 LCBannerViewDemo[3293:296197] Delegate: Scrolled in 0x7f915b7349b0 to index: 1
  2016-07-29 15:41:47.300 LCBannerViewDemo[3293:296197] Delegate: Scrolled in 0x7f915b7349b0 to index: 0
  2016-07-29 15:41:48.429 LCBannerViewDemo[3293:296197] Delegate: Clicked image in 0x7f915b7349b0 at index: 0
  2016-07-29 15:41:49.308 LCBannerViewDemo[3293:296197] Delegate: Scrolled in 0x7f915b7349b0 to index: 1
  2016-07-29 15:41:51.297 LCBannerViewDemo[3293:296197] Delegate: Scrolled in 0x7f915b7349b0 to index: 0

• Custom parameters:

  // Distance to bottom of pageControl. Default is `10.0f`.
  @property (nonatomic, assign) CGFloat   pageDistance;
  
  // Not allow scrolling. Default `No`, allow scrolling.
  @property (nonatomic, assign) BOOL      notScrolling;

ChangeLog

V 2.1.1

• Hide pageControl support:

  // Hide or show pageControl. Default is `NO`, show pageControl.
  @property (nonatomic, assign) BOOL hidePageControl;

V 2.1.0

• Implementation requirement: Issue 6 by skyboy1342.

  Now you could get the clicked image's index and the index scroll to, with Block or Delegate, see Usage.

• Calculation: didScrollToIndex method won't be called to index 0 when you add bannerView to superView, because it hadn't scroll at all, and in fact you know index is 0 now because you do this.

V 2.0.0 (⚠️ Important)

• Fix Issue 5, thx MVakas!

• Modify some of the properties' name and methods' name:

  // Properties' name.
  @property (nonatomic, assign) CGFloat timerInterval;
  ->
  @property (nonatomic, assign) CGFloat timeInterval;
  
  @property (nonatomic, copy  ) NSString  *placeholderImage;
  ->
  @property (nonatomic, copy  ) NSString  *placeholderImageName;
  
  // All methods' name.
  timerInterval -> timeInterval
  placeholderImage -> placeholderImageName

V 1.2.5

• Update README and some documents.

V 1.2.2

• Update CocoaPods source URL.

V 1.2.0

• You could custom the images should scrolling now, thx ac1dpax. For example:

  LCBannerView *bannerView = [[LCBannerView alloc] initWithFrame:CGRectMake(0, 20.0f, [UIScreen mainScreen].bounds.size.width, 200.0f)
                                                        delegate:self
                                                       imageName:@"banner"
                                                           count:3
                                                   timerInterval:3.0f
                                   currentPageIndicatorTintColor:[UIColor orangeColor]
                                          pageIndicatorTintColor:[UIColor whiteColor]];
  bannerView.pageDistance = 20.0f;
  bannerView.notScrolling = YES; // THIS LINE ⬅️
  bannerView;

V 1.1.0

• You could custom page control bottom distance now. For example:

  // ...
  bannerView.pageDistance = 20.0f;

V 1.0.0

• Initial commit.

Thanks

• SDWebImage

Support

• If you have any question, just commit a issue :)

• Mail: echo bGVvZGF4aWFAZ21haWwuY29tCg== | base64 -D or echo ZGV2dGlwQDE2My5jb20K | base64 -D

• Blog: https://LeoDev.me

• Donations:

  • PayPal:

    

  • Alipay or Wechat Pay:

    

  Please note: donation does not imply any type of service contract.

License

MIT License