Skip to content

Latest commit

 

History

History
64 lines (61 loc) · 2.98 KB

README.md

File metadata and controls

64 lines (61 loc) · 2.98 KB

YPBanner

Just a few lines of code, you can easily add banner to your app.

image image

Dependency

SDWebImage

How to install?

    //support pod install,just do:
    pod 'YPBanner' 
    //if the repo is not updated,please try:
    pod "YPBanner", :git =>"https://github.com/penoty/YPBanner"

How to use?(need import "YPBannerView.h")

Banner Item Init

    YPBannerItem *item_01 = [[YPBannerItem alloc] initWithImage:[UIImage imageNamed:@"placehold.png"] data:nil];
    YPBannerItem *item_02 = [[YPBannerItem alloc] initWithUrl:@"web_url" 
                                                         data:nil 
                                               andPlaceholder:[UIImage imageNamed:@"placehold.png"]];
    ......

Default Animation

    _bannerView = [[YPBannerView alloc] initWithYPBannerItems:@[item_01,item_02...]];

Set animation type and duration

    _bannerView= [[YPBannerView alloc] initWithYPBannerItems:@[item_01,item_02...] 
                                               animationType:YPBannerAnimationTypeCube 
                                        andAnimationDuration:1.5f];

Setup Frame

    //you can setup frame any where you want by using setFrame or masonry
    //use setFrame:
    [_bannerView setFrame:...];
    //use Masonry
    [_bannerView mas_makeConstraints:^(MASConstraintMaker *make) {
            make...
     }];

Setup frame when init

    - (instancetype)initWithFrame:(CGRect)frame
                 andYPBannerItems:(NSArray<YPBannerItem *> *)itemArray;
    - (instancetype)initWithFrame:(CGRect)frame
                    YPBannerItems:(NSArray<YPBannerItem *> *)itemArray      
                    animationType:(YPBannerAnimationType)type
             andAnimationDuration:(NSTimeInterval)duration;

YPBannerViewDelegate

    //If you want to have tap callback,just implement the YPBannerViewDelegate method:
    - (void)didTapOnBannerItem:(YPBannerItem *)item;

Public Properties

scrollTimeInterval
    (type:CGFloat)time interval that banner automatically scroll
placeholderImg
    (type:UIImage *)the banner placeholder image
pageIndicatorTintColor
    (type:UIColor)pagecontrol's indicator color
currentPageIndicatorColor
    (type:UIColor)pagecontrol's current indicator color
using the method to setup the pagecontrol
    - (void)setPageIndicatorColor:(UIColor *)indicatorColor 
     andCurrentPageIndicatorColor:(UIColor *)currentIndicatorColor;
using the method to setup animation type and duration
    - (void)setAnimationType:(YPBannerAnimationType)animationType
     andAnimationDuration:(NSTimeInterval)animationDuration;

Author

penoty, penoty@163.com

License

YPBanner is available under the MIT license. See the LICENSE file for more info.