JXSegmentedView 1.4.1

JXSegmentedView 1.4.1

×

由 pujiaxin 维护。

JXSegmentedView 1.4.1

  • 作者
  • pujiaxin33

platform languages cocoapods carthage support

这里有一份英文文档，点击查看

一款强大且易于使用的分段视图（segmentedcontrol、pagingview、pagerview、pagecontrol、categoryview）（腾讯新闻、今日头条、QQ音乐、网易云音乐、京东、爱奇艺、腾讯视频、淘宝、天猫、简书、微博等所有主流APP分类切换滚动视图）

与同类其他第三方库相比的优点：

  • 指示器逻辑面向协议编程（Protocol Oriented Programming），可以随意扩展指示器效果；
  • 提供更加全面丰富的效果，几乎支持所有主流APP效果；
  • 使用子类化管理 cell 样式，逻辑更清晰，扩展更简单；
  • 列表支持整个生命周期方法；

Objective-C 版本

如果你正在寻找 Objective-C 版本，请点击查看 JXCategoryView

效果预览

指示器效果预览

说明 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

Cell样式效果预览

说明 Gif
颜色渐变
文字渐变
大小缩放
大小缩放+字体粗细
大小缩放+点击动画
大小缩放+cell宽度缩放
TitleImage_Top
TitleImage_Left
TitleImage_Bottom
TitleImage_Right
TitleImage_只有图片
TitleOrImage(高仿腾讯视频)
数字
红点
多行富文本
多种cell混用

特殊效果预览

说明 Gif
数据源过少
isItemSpacingAverageEnabled为true
数据源过少
isItemSpacingAverageEnabled为false
SegmentedControl
参考SegmentedControlViewController类
导航栏使用
参考NaviSegmentedControlViewController类
嵌套使用
参考NestViewController类
个人主页(上下左右滚动、header悬浮)
参考PagingViewController类
更多样式请点击查看JXPagingView库
数据加载与刷新
参考LoadDataViewController类

要求

  • iOS 9.0+
  • Xcode 9+
  • Swift 5.0

安装

手动

Clone代码，将Sources文件夹拖拽到项目中，即可使用；

CocoaPods

target '<Your Target Name>' do
    pod 'JXSegmentedView'
end

先执行pod repo update，再执行pod install

Carthage

在 cartfile 文件中添加：

github "pujiaxin33/JXSegmentedView"

然后执行 carthage update --platform iOS 即可

Swift Package Manager

1.在 Package.swift 文件添加如下代码

dependencies: [
  .package(url: "https://github.com/pujiaxin33/JXSegmentedView.git", from: "1.2.1")
]

2.使用命令行构建

$ swift build

使用

JXSegmentedView 使用示例

1.初始化 JXSegmentedView

segmentedView = JXSegmentedView()
segmentedView.delegate = self
view.addSubview(self.segmentedView)

2.初始化 dataSource

dataSouce 类型为 JXSegmentedViewDataSource 协议。使用单独的类实现 JXSegmentedViewDataSource 协议，实现代码隔离。选择不同的类赋值给 dataSource，就可以控制 JXSegmentedView 显示效果，实现插件化。比如选择 JXSegmentedTitleImageDataSource 类作为 dataSource 就选择了文字图片的显示效果；选择 JXSegmentedNumberDataSource 类作为 dataSource 就选择了文字加数字的显示效果；

//segmentedDataSource一定要通过属性强持有，不然会被释放掉
segmentedDataSource = JXSegmentedTitleDataSource()
//配置数据源相关配置属性
segmentedDataSource.titles = ["猴哥", "青蛙王子", "旺财"]
segmentedDataSource.isTitleColorGradientEnabled = true
//关联dataSource
segmentedView.dataSource = self.segmentedDataSource

3.初始化指示器 indicator

let indicator = JXSegmentedIndicatorLineView()
indicator.indicatorWidth = 20
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自定义，封装度高、代码集中、使用简单；
  • 列表懒加载：当显示某个列表时，才进行列表初始化。而不是一次性加载全部列表，性能更优；
  • 可以选用CollectionView作为列表容器，内存管理更加优秀；
  • 支持调用列表的整个生命周期方法；

1. 初始化JXSegmentedListContainerView

listContainerView = JXSegmentedListContainerView(dataSource: self)
view.addSubview(self.listContainerView)
//关联listContainer
segmentedView.listContainer = listContainerView

2. 实现代理方法JXSegmentedListContainerViewDataSource

//返回列表的数量
func numberOfLists(in listContainerView: JXSegmentedListContainerView) -> Int {
    return 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 listWillAppear() {}
func listDidAppear() {}
func listDidDisappear() {}
func listDidDisappear() {}

具体可点击LoadDataViewController查看源代码。

使用总结

由于JXSegmentedView本身支持许多特性：指示器、cell样式、列表容器等，如何有序管理代码成为一个难题。借助协议、继承和封装类，可以极大简化使用难度，提高灵活性，扩展也相当容易。

  • 核心主要类：JXSegmentedView
  • 数据源及cell样式定制类：遵循JXSegmentedViewDataSource协议的类
  • 指示器类：遵循JXSegmentedIndicatorProtocol协议的UIView类
  • 列表容器：官方推荐使用JXSegmentedListContainerView类，特殊情况可使用UIScrollView自定义

指示器样式自定义

  • 需要继承JXSegmentedIndicatorProtocol协议，点击参看JXSegmentedIndicatorProtocol
  • 提供了继承JXSegmentedIndicatorProtocol协议的基类JXSegmentedIndicatorBaseView，其中包含许多基础属性。点击参看JXSegmentedIndicatorBaseView
  • 自定义指示器，请参考已实现的指示器视图，多尝试、多思考，再有问题请提交Issue或加入反馈QQ群

dataSource和Cell自定义

  • 需要继承JXSegmentedViewDataSource协议，点击参看JXSegmentedViewDataSource
  • 提供了继承JXSegmentedViewDataSource协议的基类JXSegmentedBaseDataSource，其中包含许多基础属性。点击参看JXSegmentedBaseDataSource
  • 任何自定义需求，都需要对dataSource、cell和itemModel三个进行子类化。即使某个子类cell不做任何事情。这是为了维护继承链，以免将来子类化时不知道该继承哪个类。
  • dataSource和Cell的自定义，请参考已实现的dataSource，多尝试，多思考。如果还有问题，请提交Issue或加入反馈QQ群。

常用属性说明

常用属性说明文档地址

其他使用注意事项

其他使用注意事项文档总地址

重要版本更新记录

补充

如果刚开始使用JXSegmentedView，在开发过程中需要支持某种特性时，请务必先检查使用文档或源代码。确认是否已经实现了所需的特性。请不要仅仅因为缺乏文档或源代码就提出问题，这对大家都是时间的浪费。如果所需的特性尚未实现，欢迎提交Issue进行讨论，或者自己实现并提交PullRequest。

该仓库保持及时更新，会对主流新的分类选择效果提供第一时间的支持。在使用过程中，有任何建议或问题，可以通过以下方式联系我：
邮箱：[email protected]
QQ群： 112440276

喜欢就star❤️的吧

许可协议

JXSegmentedView是在MIT许可证下发布的。