/WMZBanner

最好用的轻量级轮播图+卡片样式+自定义样式,链式编程语法(可实现各种样式的轮播图,大多需要的功能都有)(The best lightweight carousel + card style + custom style, chain programming syntax)

Primary LanguageObjective-CMIT LicenseMIT

WMZBanner - 最好用的轻量级轮播图+卡片样式+自定义样式

演示

banner.gif

特性

  • 链式语法 结构优雅
  • 支持常规轮播图样式
  • 支持卡片式样式
  • 支持跑马灯
  • 支持卡片叠加模式
  • 支持自定义轮播图cell
  • 支持自定义图片的偏移距离
  • 支持自定义pagecontrol
  • 支持循环滚动,支持自动滚动
  • 样式均可自定义
  • 支持网络图片和本地图片混合使用

用法

默认模式

banner1.gif

主要适用于普通样式的情况下使用

直观 清晰, 编码时可随初始化控件编写完成, 不影响编码思路.

WMZBannerParam *param =  BannerParam()
.wFrameSet(CGRectMake(0, BannerHeight/4*3+10, BannerWitdh, BannerHeight/5))
//传入数据
.wDataSet([self getData])
//开启循环滚动
.wRepeatSet(YES)
//开启自动滚动
.wAutoScrollSet(YES)
//自动滚动时间
.wAutoScrollSecondSet(3)
;
self.viewTwo = [[WMZBannerView alloc]initConfigureWithModel:param withView:self.view];

卡片模式

banner4.gif

BannerParam()
.wFrameSet(CGRectMake(0, BannerHeight/4*3+10, BannerWitdh, BannerHeight/5))
//item之间的间距
.wLineSpacingSet(15)
//开启缩放效果 
.wScaleSet(YES)
//缩放垂直系数
.wActiveDistanceSet(400)
//缩放系数
.wScaleFactorSet(0.5)
//item的size
.wItemSizeSet(CGSizeMake(BannerWitdh*0.8, BannerHeight/5))
//固定移动的距离 size*倍数
.wContentOffsetXSet(0.5)
//默认选中
.wSelectIndexSet(2)
.wRepeatSet(YES)
.wAutoScrollSecondSet(3)
.wAutoScrollSet(NO)
//item中心位置
.wPositionSet(BannerCellPositionCenter)
//整体左右偏移 item.width的一半 让第一个和最后一个可以居中
.wSectionInsetSet(UIEdgeInsetsMake(0,BannerWitdh*0.4, 0, BannerWitdh*0.4))
.wDataSet([self getData]);
跑马灯

banner6.gif

 WMZBannerParam *param =  BannerParam()
.wFrameSet(CGRectMake(10, BannerHeight/2-20, BannerWitdh-20, 30))
.wDataSet(@[@"热门商品",@"Hot",@"热点资讯",@"其他热门"])
//跑马灯
.wMarqueeSet(YES)
天猫精灵样式

banner3.gif

 BannerParam()
.wFrameSet(CGRectMake(0, BannerHeight/4*3+10, BannerWitdh, BannerHeight/5))
.wDataSet([self getData])
//关闭pageControl
.wHideBannerControlSet(YES)
//开启缩放
.wScaleSet(YES)
//垂直缩放参数
.wActiveDistanceSet(400)
//缩放系数
.wScaleFactorSet(0.5)
//自定义item的大小
.wItemSizeSet(CGSizeMake(BannerWitdh*0.7, BannerHeight/5))
//固定移动的距离
.wContentOffsetXSet(0.4)
//循环
.wRepeatSet(YES)
//item的间距
.wLineSpacingSet(10)
 //整体左右间距 右边偏移item.width的一半 让最后一个可以居中
.wSectionInsetSet(UIEdgeInsetsMake(0,10, 0, 10+BannerWitdh*0.35))
卡片叠加样式

banner5.gif

 WMZBannerParam *param =  BannerParam()
.wFrameSet(CGRectMake(10,100, BannerWitdh-20, BannerHeight*0.35))
.wItemSizeSet(CGSizeMake(BannerWitdh-60, BannerHeight*0.25))
.wDataSet([self getData])
//设置item的间距
.wLineSpacingSet(15)
//开启卡片叠加模式
.wCardOverLapSet(YES)
//毛玻璃背景
.wEffectSet(YES)
//开启自动滚动
.wAutoScrollSet(YES);
自定义pageControl

banner2.gif

   WMZBannerParam *param =  BannerParam()
  .wFrameSet(CGRectMake(10, BannerHeight*0.7+20, BannerWitdh-20, BannerHeight/6))
  .wBannerControlImageSet(@"bannerP3")
  .wBannerControlSelectImageSet(@"bannerP2")
  .wBannerControlImageSizeSet(CGSizeMake(10, 10))
  .wBannerControlSelectImageSizeSet(CGSizeMake(30, 30))
  //自定义pageControl的位置
  .wCustomControlSet(^(UIPageControl *pageControl) {
      //随意改变xy值
      CGRect rect = pageControl.frame;
      rect.origin.y =  10;
      pageControl.frame = rect;
  })
  .wDataSet([self getData]);
自定义cell
传入一个继承UICollectionViewCell的类
 BannerParam()
//自定义视图必传
.wMyCellClassNameSet(@"MyCell")
.wMyCellSet(^UICollectionViewCell *(NSIndexPath *indexPath, UICollectionView *collectionView, id model, UIImageView *bgImageView,NSArray*dataArr) {
    //自定义视图
    MyCell *cell = (MyCell *)[collectionView dequeueReusableCellWithReuseIdentifier:NSStringFromClass([MyCell class]) forIndexPath:indexPath];
    [cell.icon sd_setImageWithURL:[NSURL URLWithString:model[@"icon"]] placeholderImage:nil];
    cell.leftText.text = model[@"name"];
    //毛玻璃效果必须实现 看实际情况 取最后一个还是中间那个
    [bgImageView sd_setImageWithURL:[NSURL URLWithString:model[@"icon"]] placeholderImage:nil];
    [bgImageView sd_setImageWithURL:[NSURL URLWithString:dataArr[(indexPath.row == 0?:(indexPath.row-1))][@"icon"]] placeholderImage:nil];

    return cell;
})
.wEventClickSet(^(id anyID, NSIndexPath *path) {
    NSLog(@"点击 %@ %@",anyID,path);
})
.wFrameSet(CGRectMake(0, BannerHeight/4*3+10, BannerWitdh, BannerHeight/5))
淡入淡出

fade.gif

更新UI

-(void)updateUI; 改变.wDataSet(@[]),然后调用updateUI()实例方法即可

其他可配置的全部参数说明
布局方式 frame  必传 
wFrame
数据源 必传
wData
开启缩放 default NO
wScale
背景毛玻璃效果 default NO
wEffect
纵向(cell全屏的时候有效)  default NO
wVertical
跑马灯(文字效果) default NO
wMarquee
缩放系数 数值越大缩放越大 default 0.5
wScaleFactor
垂直缩放 数值越大缩放越小 default 400
wActiveDistance
item的size default 视图的宽高 item的width最小为父视图的一半 (为了保证同屏最多显示3个 减少不必要的bug)
wItemSize
item的之间的间距 default 0
wLineSpacing
滑动的时候偏移的距离 以倍数计算 default 0.5 正中间
wContentOffsetX
左右相邻item的中心点 default BannerCellPositionCenter
wPosition
图片不变形铺满 默认 YES
wImageFill
占位图片 默认 -
wPlaceholderImage
开启无线滚动 default NO
wRepeat
整体间距 default UIEdgeInsetsMake(0,0, 0, 0) 如果是一屏幕有2 3个的 要让第一个和最后一个居中最好设置偏移量
wSectionInset
开启自动滚动 default NO
wAutoScroll
自动滚动间隔时间 default 3.0f
wAutoScrollSecond
默认移动到第几个 default 0
wSelectIndex
自定义cell内容 default @“Collectioncell"
wMyCell
自定义cell的类名 自定义视图必传 不然会crash
wMyCellClassName
点击方法
wEventClick
隐藏pageControl default NO
wHideBannerControl
是否允许手势滑动 default YES
wCanFingerSliding
系统的圆点颜色  default  ffffff
wBannerControlColor
系统的圆点选中颜色  default  orange
wBannerControlSelectColor
自定义安全的圆点图标  default -
wBannerControlImage
自定义安全的选中圆点图标  default -
wBannerControlSelectImage
自定义安全的圆点图片圆角 default ImageSize/2
wBannerControlImageRadius
自定义安全的圆点图标的size  default (5,5)
wBannerControlImageSize
自定义安全的选中圆点图标的size default (10,5)
wBannerControlSelectImageSize
滚动减速时间 default UIScrollViewDecelerationRateFast
wDecelerationRate

依赖

SDWebImage

安装

CocoaPods

  1. 将 cocoapods 更新至最新版本. 2.pod 'WMZBanner', '~> 1.2.0'
  2. 导入 #import "WMZBannerView.h"。

手动安装

  1. 下载 WMZBanner 文件夹内的所有内容。
  2. 将 WMZBanner 内的源文件添加(拖放)到你的工程。
  3. 导入 #import "WMZBannerView.h"

系统要求

该库最低支持 iOS 9.0Xcode 9.0

许可证

使用 MIT 许可证,详情见 LICENSE 文件。

个人主页

使用过程中如果有什么bug欢迎给我提issue 我看到就会解决 我的简书

更新记录

  • 20191025 增加wAlpha属性 左右视图的透明度 default 1 范围0~1之间
  • 20191104 增加wScreenScale属性 全局缩放 default 1 范围0~1之间
  • 20191105 增加wVertical属性 开启纵向滚动(全屏有效) default NO
  • 20191105 增加wMarquee属性 开启跑马灯效果(全屏有效) default NO
  • 20191106 解除itemsize最低为视图一半的限制 可支持小图
  • 20191120 新增wEventCenterClick(可判断当前点击cell是否是中间那个)
  • 20191120 新增wEventScrollEnd滚动结束事件(每次滚动结束都会调用 最好是关闭自动滚动的场景使用)
  • 20191204 适配ipad pod 更新到1.0.4
  • 20191219 新增卡片叠加样式 优化定时器
  • 20200117 新年更新至1.1.0 修复bug
  • 20200117 更新至1.1.2 修复bug
  • 20200618 更新至1.1.3 修复bug 新增特殊样式 下划线/淡入淡出
  • 20200625 更新至1.1.4 修复bug
  • 20200920 更新至1.1.5 适配ios14
  • 20201207 更新至1.1.6 修复叠加bug
  • 20201213 更新至1.1.9 优化跑马灯 自定义cell支持xib
  • 20210422 更新至1.2.0 消除警告