A powerful and easy to use category view (segmentedcontrol, segmentview, pagingview, pagerview, pagecontrol) (腾讯新闻、今日头条、QQ音乐、网易云音乐、京东、爱奇艺、腾讯视频、淘宝、天猫、简书、微博等所有主流APP分类切换滚动视图)
与其他的同类三方库对比的优点:
- 使用协议封装指示器逻辑,可以为所欲为的自定义指示器效果;
- 提供更加全面丰富、高度自定义的效果;
- 使用子类化管理cell样式,逻辑更清晰,扩展更简单;
- 高度封装列表容器,使用便捷,完美支持列表的生命周期调用;
Swift版本
如果你在找Swift版本,请点击查看JXSegmentedView
效果预览
指示器效果预览
以下均支持上下位置切换: JXCategoryIndicatorLineView、JXCategoryIndicatorImageView、JXCategoryIndicatorBallView、JXCategoryIndicatorTriangleView
Cell样式效果预览
说明 | Gif |
---|---|
颜色渐变 | |
大小缩放 | |
大小缩放+底部锚点 | |
大小缩放+顶部锚点 | |
大小缩放+字体粗细 | |
大小缩放+点击动画 | |
大小缩放+cell宽度缩放 | |
TitleImage_Top | |
TitleImage_Left | |
TitleImage_Bottom | |
TitleImage_Right | |
cell图文混用 | |
Image | |
数字 | |
红点 | |
多行文本 | |
多行富文本 | |
Cell背景色渐变 | |
分割线 |
特殊效果预览
说明 | Gif |
---|---|
数据源过少 averageCellSpacingEnabled默认为YES |
|
数据源过少 averageCellSpacingEnabled为NO |
|
SegmentedControl 参考 SegmentedControlViewController 类 |
|
导航栏使用 参考 NaviSegmentedControlViewController 类 |
|
嵌套使用 参考 NestViewController 类 |
|
个人主页(上下左右滚动、header悬浮) 参考 PagingViewController 类更多样式请点击查看JXPagingView库 |
|
垂直列表滚动 参考 VerticalListViewController 类高仿腾讯视频 支持UITableView,参考 VerticalListTableViewController (背景色异常是录屏软件bug) |
|
垂直缩放(仿网易圈圈、脉脉首页) 参考 ScrollZoomViewController 类 |
|
数据源刷新&列表数据加载 参考 LoadDataListContainerViewController 类 |
自定义效果预览
收录来自其他使用者的自定义示例,这些自定义类只在Demo项目里面,Pod库并没有这些文件。所以,如果你需要使用这些自定义效果,请通过文件导入的方式。
目的:
- 参考学习如何自定义
- 直接修改自定义示例类以快速实现自己的需求
欢迎提PullRequest进行收录你的自定义效果。
说明 | Gif |
---|---|
Spring动画指示器 | |
富文本数量cell | |
左右对齐指示器 | |
秒杀时间线cell | |
京东商品排序cell | |
title背景块cell |
要求
- iOS 8.0+
- Xcode 9+
- Objective-C
安装
手动
Clone代码,把Sources文件夹拖入项目,#import "JXCategoryView.h",就可以使用了;
CocoaPods
target '<Your Target Name>' do
pod 'JXCategoryView'
end
先执行pod repo update
,再执行pod install
结构图
使用
JXCategoryTitleView使用示例
1.初始化JXCategoryTitleView
self.categoryView = [[JXCategoryTitleView alloc] initWithFrame:CGRectMake(0, 0, WindowsSize.width, 50)];
self.categoryView.delegate = self;
[self.view addSubview:self.categoryView];
2.配置JXCategoryTitleView的属性
self.categoryView.titles = @[@"螃蟹", @"麻辣小龙虾", @"苹果"...]
self.categoryView.titleColorGradientEnabled = YES;
3.添加指示器
JXCategoryIndicatorLineView *lineView = [[JXCategoryIndicatorLineView alloc] init];
lineView.indicatorColor = [UIColor redColor];
lineView.indicatorWidth = JXCategoryViewAutomaticDimension;
self.categoryView.indicators = @[lineView];
4.可选实现JXCategoryViewDelegate
代理
//点击选中或者滚动选中都会调用该方法。适用于只关心选中事件,不关心具体是点击还是滚动选中的。
- (void)categoryView:(JXCategoryBaseView *)categoryView didSelectedItemAtIndex:(NSInteger)index;
//点击选中的情况才会调用该方法
- (void)categoryView:(JXCategoryBaseView *)categoryView didClickSelectedItemAtIndex:(NSInteger)index;
//滚动选中的情况才会调用该方法
- (void)categoryView:(JXCategoryBaseView *)categoryView didScrollSelectedItemAtIndex:(NSInteger)index;
//正在滚动中的回调
- (void)categoryView:(JXCategoryBaseView *)categoryView scrollingFromLeftIndex:(NSInteger)leftIndex toRightIndex:(NSInteger)rightIndex ratio:(CGFloat)ratio;
列表容器使用示例
JXCategoryListContainerView
封装类使用示例
JXCategoryListContainerView
是对列表视图高度封装的类,具有以下优点:
- 相对于直接使用
UIScrollView
自定义,封装度高、代码集中、使用简单; - 列表懒加载:当显示某个列表的时候,才进行列表初始化。而不是一次性加载全部列表,性能更优;
- 支持列表的willAppear、didAppear、willDisappear、didDisappear生命周期方法调用;
1.初始化JXCategoryListContainerView
并关联到categoryView
self.listContainerView = [[JXCategoryListContainerView alloc] initWithType:JXCategoryListContainerType_ScrollView delegate:self];
[self.view addSubview:self.listContainerView];
//关联到categoryView
self.categoryView.listContainer = self.listContainerView;
2.实现JXCategoryListContainerViewDelegate
代理方法
//返回列表的数量
- (NSInteger)numberOfListsInlistContainerView:(JXCategoryListContainerView *)listContainerView {
return self.titles.count;
}
//根据下标index返回对应遵从`JXCategoryListContentViewDelegate`协议的列表实例
- (id<JXCategoryListContentViewDelegate>)listContainerView:(JXCategoryListContainerView *)listContainerView initListForIndex:(NSInteger)index {
return [[ListViewController alloc] init];
}
3.列表实现JXCategoryListContentViewDelegate
代理方法
不管列表是UIView还是UIViewController都可以,提高使用灵活性,更便于现有的业务接入。
// 返回列表视图
// 如果列表是VC,就返回VC.view
// 如果列表是View,就返回View自己
- (UIView *)listView {
return self.view;
}
具体点击LoadDataListContainerViewController查看源代码了解
直接使用UIScrollView自定义
因为代码量较多且分散,所有不推荐使用该方法。要正确使用需要注意的地方比较多,尤其对于刚接触iOS的同学来说不太友好。
不直接贴代码了,具体点击LoadDataListCustomViewController查看源代码了解。
常见问题和答案
- 个人主页效果更丰富的示例:JXPagingView
- 侧滑手势处理
- 列表的生命周期方法处理
JXCategoryListContainerType
的scrollView
和collectionView
对比- cell左滑删除
FDFullscreenPopGesture
等全屏手势处理- JXCategoryView数据源刷新
reloadDataWithoutListContainer
方法使用说明- listContainer或contentScrollView关联说明
- 点击切换列表的动画控制
- 列表cell点击跳转示例
- 列表调用
presentViewController
方法 - 代码选中指定index
- JXCategoryView.collectionView高度取整说明
- 对父VC的automaticallyAdjustsScrollViewInsets属性设置为NO
JXCategoryListContainerView
内部使用UIViewController
当做列表容器使用说明- 使用多行文本
- 列表容器禁止左右滑动
- 单个cell刷新
- 点击item时指示器和列表滚动时效果一致
- 自定义建议
指示器样式自定义
- 需要继承
JXCategoryIndicatorProtocol
协议,点击参看JXCategoryIndicatorProtocol - 提供了继承
JXCategoryIndicatorProtocol
协议的基类JXCategoryIndicatorComponentView
,里面提供了许多基础属性。点击参看JXCategoryIndicatorComponentView - 自定义指示器,请参考已实现的指示器视图,多尝试、多思考,再有问题请提Issue或加入反馈QQ群
Cell自定义
- 任何子类化需求,view、cell、cellModel三个都要子类化,即使某个子类cell什么事情都不做。用于维护继承链,以免以后子类化都不知道要继承谁了;
- 如果你想完全自定义cell里面的内容,那就继承
JXCategoryIndicatorView、JXCategoryIndicatorCell、JXCategoryIndicatorCellModel
,就像JXCategoryTitleView、JXCategoryTitleCell、JXCategoryTitleCellModel
那样去做; - 如果你只是在父类进行一些微调,那就继承目标view、cell、cellModel,对cell原有控件微调、或者加入新的控件皆可。就像
JXCategoryTitleImageView系列、JXCategoryTitleAttributeView系列
那样去做; - Cell自定义,请参考已实现的cell样式,多尝试、多思考,再有问题请提Issue或加入反馈QQ群
常用属性说明
更新记录
- 2018.8.21 发布1.0.0版本,更新内容:使用POP(面向协议编程)重构指示器视图;迁移指南
- 2018.8.22 发布1.0.1版本,更新内容:删除zoomEnabled,新增titleLabelZoomEnabled、imageZoomEnabled;
- 2018.8.23 发布1.0.2版本,更新内容:添加cellWidthZoomEnabled实现腾讯视频效果;
- 2018.8.24 发布1.0.3版本,更新内容:添加垂直列表滚动效果、指示器添加verticalMargin属性、JXCategoryViewDelegate代理方法优化;
- 2018.9.4 发布1.0.4版本,更新内容:修复bug、添加cell图文混用示例;
- 2018.12.19 发布1.1.7版本,更新内容:添加
JXCategoryListContainerView
,高度封装列表逻辑,支持懒加载列表,提升初始化性能; - 2019.1.24 发布1.2.2版本,更新内容:非兼容更新接口
- (BOOL)selectCellAtIndex:(NSInteger)index selectedType:(JXCategoryCellSelectedType)selectedType
,自定义有用到该接口的请及时更新。 - 2019.6.21 发布1.3.13版本,更新内容:将
JXCategoryListCollectionContainerView.dataSource
移动到m实现文件,添加- (instancetype)initWithDataSource:(id<JXCategoryListCollectionContainerViewDataSource>)dataSource
初始化方法。 - 2019.7.20 发布1.3.16版本,删除代理方法
- (void)categoryView:(JXCategoryBaseView *)categoryView didClickedItemContentScrollViewTransitionToIndex:(NSInteger)index;
,请使用contentScrollViewClickTransitionAnimationEnabled
属性。JXCategoryTitleVerticalZoomView
进行了重构,内容左边距只需要使用contentEdgeLeft
属性即可。 - 2019.9.11 发布1.4.0版本,删除一波被标记为弃用的属性和方法;完善列表的生命周期方法的调用;
JXCategoryListCollectionContainerView
类新增和必须要调用- (void)scrollingFromLeftIndex:(NSInteger)leftIndex toRightIndex:(NSInteger)rightIndex ratio:(CGFloat)ratio selectedIndex:(NSInteger)selectedIndex
和- (void)didClickSelectedItemAtIndex:(NSInteger)index
两个方法。 - 2019.9.19 发布1.5.0版本,重构列表容器,具体修改请参考1.5.0版本迁移指南
补充
如果刚开始使用JXCategoryView
,当开发过程中需要支持某种特性时,请务必先搜索使用文档或者源代码。确认是否已经实现支持了想要的特性。请别不要文档和源代码都没有看,就直接提问,这对于大家都是一种时间浪费。如果没有支持想要的特性,欢迎提Issue讨论,或者自己实现提一个PullRequest。
该仓库保持随时更新,对于主流新的分类选择效果会第一时间支持。使用过程中,有任何建议或问题,可以通过以下方式联系我:
邮箱:317437084@qq.com
QQ群: 112440473
喜欢就star
License
JXCategoryView is released under the MIT license.