腾讯新闻、今日头条、QQ音乐、网易云音乐、京东、爱奇艺、腾讯视频、淘宝、天猫、简书、微博等全部主流APP分类切换滚动视图git
与其余的同类三方库对比的优势:github
下载源码,一睹为快!
JXSegmentedView编程
说明 | Gif | |
---|---|---|
Line固定宽度 | ||
![]() |
||
Line与cell等宽 | ||
![]() |
||
Line延长 | ||
![]() |
||
Line延长+偏移 | ||
![]() |
||
RainbowLine🌈彩虹 | ||
![]() |
||
DotLine点线 | ||
![]() |
||
DoubleLine双线 | ||
![]() |
||
Triangle三角形底部 | ||
![]() |
||
Triangle三角形顶部 | ||
![]() |
||
Background椭圆形 | ||
![]() |
||
Background椭圆形+阴影 | ||
![]() |
||
Background遮罩有背景 | ||
![]() |
||
Background遮罩无背景 | ||
![]() |
||
Background渐变色 (渐变是固定的) |
||
![]() |
||
Gradient渐变色 (渐变随着位置变更) |
||
![]() |
||
Image底部 | ||
![]() |
||
Image背景 | ||
![]() |
||
混合使用 | ||
![]() |
如下指示器支持上下位置切换:JXSegmentedIndicatorLineView
、JXSegmentedIndicatorRainbowLineView
、JXSegmentedIndicatorDotLineView
、JXSegmentedIndicatorDoubleLineView
、JXSegmentedIndicatorTriangleView
、JXSegmentedIndicatorImageView
swift
说明 | Gif | |
---|---|---|
颜色渐变 | ||
![]() |
||
文字渐变 | ||
![]() |
||
大小缩放 | ||
![]() |
||
大小缩放+字体粗细 | ||
![]() |
||
大小缩放+点击动画 | ||
![]() |
||
大小缩放+cell宽度缩放 | ||
![]() |
||
TitleImage_Top | ||
![]() |
||
TitleImage_Left | ||
![]() |
||
TitleImage_Bottom | ||
![]() |
||
TitleImage_Right | ||
![]() |
||
TitleImage_只有图片 | ||
![]() |
||
TitleOrImage(高仿腾讯视频) | ||
![]() |
||
数字 | ||
![]() |
||
红点 | ||
![]() |
||
多行富文本 | ||
![]() |
||
多种cell混用 | ||
![]() |
说明 | Gif | |
---|---|---|
数据源过少<br/> isItemSpacingAverageEnabled为true | ||
![]() |
||
数据源过少<br/> isItemSpacingAverageEnabled为false | ||
![]() |
||
SegmentedControl<br/>参考SegmentedControlViewController 类 |
||
![]() |
||
导航栏使用<br/>参考NaviSegmentedControlViewController 类 |
||
![]() |
||
嵌套使用<br/>参考NestViewController 类 |
||
![]() |
||
我的主页(上下左右滚动、header悬浮)<br/>参考PagingViewController 类<br/> 更多样式请点击查看JXPagingView库 |
||
![]() |
||
数据加载&刷新<br/>参考LoadDataViewController 类 |
||
![]() |
Clone代码,把Sources文件夹拖入项目,就可使用了;segmentfault
target '<Your Target Name>' do pod 'JXSegmentedView' end
先执行pod repo update
,再执行pod install
数组
JXSegmentedView
使用示例1.初始化JXSegmentedViewruby
self.segmentedView = JXSegmentedView() self.delegate = self self.view.addSubview(self.segmentedView)
2.初始化dataSourceapp
dataSouce
类型为JXSegmentedViewDataSource
协议。使用单独的类实现JXSegmentedViewDataSource
协议,实现代码隔离。选择不一样的类赋值给dataSource
,就能够控制JXSegmentedView
显示效果,实现插件化。好比选择JXSegmentedTitleImageDataSource
类做为dataSource
就选择了文字图片的显示效果;选择JXSegmentedNumberDataSource
类做为dataSource
就选择了文字加数字的显示效果;svg
//segmentedDataSource必定要经过属性强持有,否则会被释放掉 self.segmentedDataSource = JXSegmentedTitleDataSource() //配置数据源相关配置属性 self.segmentedDataSource.titles = ["猴哥", "青蛙王子", "旺财"] self.segmentedDataSource.isTitleColorGradientEnabled = true //reloadData(selectedIndex:)方法必定要调用,方法内部会刷新数据源数组 self.segmentedDataSource.reloadData(selectedIndex: 0) //关联dataSource self.segmentedView.dataSource = self.segmentedDataSource
3.初始化指示器indicator性能
let indicator = JXSegmentedIndicatorLineView() indicator.indicatorWidth = 20 self.segmentedView.indicators = [indicator]
4.实现JXSegmentedViewDelegate
代理
//点击选中或者滚动选中都会调用该方法。适用于只关心选中事件,而不关心具体是点击仍是滚动选中的状况。 func segmentedView(_ segmentedView: JXSegmentedView, didSelectedItemAt index: Int) {} // 点击选中的状况才会调用该方法 func segmentedView(_ segmentedView: JXSegmentedView, didClickSelectedItemAt index: Int) {} // 滚动选中的状况才会调用该方法 func segmentedView(_ segmentedView: JXSegmentedView, didScrollSelectedItemAt index: Int) {} // 正在滚动中的回调 func segmentedView(_ segmentedView: JXSegmentedView, scrollingFrom leftIndex: Int, to rightIndex: Int, percent: CGFloat) {}
contentScrollView
列表容器使用示例UIScrollView
自定义使用示例由于代码比较分散,并且代码量也比较多,全部不推荐使用该方法。要正确使用须要注意的地方比较多,尤为对于刚接触iOS的同窗来讲不太友好。
不直接贴代码了,具体点击LoadDataCustomViewController查看源代码了解。
做为替代,官方使用&强烈推荐使用下面这种方式👇👇👇。
JXSegmentedListContainerView
封装类使用示例JXSegmentedListContainerView
是对列表视图高度封装的类,具备如下优势:
UIScrollView
自定义,封装度高、代码集中、使用简单;1.初始化JXSegmentedListContainerView
self.listContainerView = JXSegmentedListContainerView(dataSource: self) self.view.addSubview(self.listContainerView) //关联cotentScrollView,关联以后才能够互相联动!!! self.segmentedView.contentScrollView = self.listContainerView.scrollView
2.实现JXSegmentedListContainerViewDataSource
代理方法
//返回列表的数量 func numberOfLists(in listContainerView: JXSegmentedListContainerView) -> Int { return self.segmentedDataSource.titles.count } //返回听从`JXSegmentedListContainerViewListDelegate`协议的实例 func listContainerView(_ listContainerView: JXSegmentedListContainerView, initListAt index: Int) -> JXSegmentedListContainerViewListDelegate { return ListBaseViewController() }
3.列表实现JXSegmentedListContainerViewListDelegate
代理方法
无论列表是UIView仍是UIViewController均可以,提升使用灵活性,更便于现有的业务接入。
/// 若是列表是VC,就返回VC.view /// 若是列表是View,就返回View本身 /// - Returns: 返回列表视图 func listView() -> UIView { return view } //可选使用,列表显示的时候调用 func listDidAppear() {} //可选使用,列表消失的时候调用 func listDidDisappear() {}
4.将关键事件告知JXSegmentedListContainerView
在下面两个JXSegmentedViewDelegate
代理方法里面调用对应的代码,必定不要忘记这一条❗️❗️❗️
func segmentedView(_ segmentedView: JXSegmentedView, didClickSelectedItemAt index: Int) { //传递didClickSelectedItemAt事件给listContainerView,必须调用!!! listContainerView.didClickSelectedItem(at: index) } func segmentedView(_ segmentedView: JXSegmentedView, scrollingFrom leftIndex: Int, to rightIndex: Int, percent: CGFloat) { //传递scrolling事件给listContainerView,必须调用!!! listContainerView.segmentedViewScrolling(from: leftIndex, to: rightIndex, percent: percent, selectedIndex: segmentedView.selectedIndex) }
具体点击LoadDataViewController查看源代码了解
由于JXSegmentedView
自己支持许多特性:指示器、cell样式、列表容器等,如何有序管理好代码成了一个难题。借助于协议、继承、封装类极大的简化了使用难度,并且提升了灵活性,扩展至关容易。
JXSegmentedView
JXSegmentedViewDataSource
协议的类JXSegmentedIndicatorProtocol
协议的UIView
类JXSegmentedListContainerView
类,特殊状况可使用UIScrollView
自定义JXSegmentedIndicatorProtocol
协议,点击参看JXSegmentedIndicatorProtocol JXSegmentedIndicatorProtocol
协议的基类JXSegmentedIndicatorBaseView
,里面提供了许多基础属性。点击参看JXSegmentedIndicatorBaseView JXSegmentedViewDataSource
协议,点击参看JXSegmentedViewDataSource JXSegmentedViewDataSource
协议的基类JXSegmentedBaseDataSource
,里面提供了许多基础属性。点击参看JXSegmentedBaseDataSource 该仓库保持及时更新,对于主流新的分类选择效果会第一时间支持。使用过程当中,有任何建议或问题,能够经过如下方式联系我:
邮箱:317437084@qq.com
QQ群: 112440276
下载源码,一睹为快!
JXSegmentedView