【干货】每个APP都用得上的SegmentView

腾讯新闻今日头条、QQ音乐、网易云音乐、京东、爱奇艺、淘宝、天猫、简书、微博等所有主流APP分类切换滚动视图

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

• 使用POP(Protocol Oriented Programming面对协议编程)封装指示器逻辑，可以为所欲为的自定义指示器效果；
• 提供更加全面丰富的效果，交互更加顺畅；
• 使用子类化管理cell样式，逻辑更清晰，扩展更简单；

Github地址

下载源码，一睹为快！JXCategoryView

效果预览

指示器效果预览

Cell样式效果预览

特殊效果预览

要求

• iOS 8.0+
• Xcode 9+
• Objective-C

安装

手动

Clone代码，把Sources文件夹拖入项目，#import "JXCategoryView.h"，就可以使用了；

CocoaPods

target '<Your Target Name>' do
    pod 'JXCategoryView'
end
复制代码

结构图

• 指示器样式自定义：使用POP(Protocol Oriented Programming面对协议编程)封装指示器逻辑，只要遵从JXCategoryIndicatorProtocol协议，就可以实现你的指示器效果。参考：JXCategoryIndicatorLineView；
• Cell样式自定义：使用子类化，基类搭建基础，子类实现特殊效果。便于代码管理，功能扩展；参考：JXCategoryNumberView；

特殊说明

• 自定义：即使提供了灵活扩展，我的源码也不可能满足所有情况，建议大家可以通过fork仓库，维护自己的一套效果。也可以直接拖入源文件进行修改。
• 个人主页效果：上下左右滚动且HeaderView悬浮的实现，用的是我写的这个库JXPagingView。
• 垂直列表滚动：参考demo工程的VerticalListViewController，未做功能封装，参考里面的代码做，多注意注释，就可以实现了。

POP说明

通过将指示器的行为抽象出来，再通过JXCategoryIndicatorProtocol协议进行约束。这样指示器效果就可以无限扩展，为所欲为的添加指示器了，不再受上一个版本继承的束缚了。更多POP内容，推荐喵神的文章面向协议编程与 Cocoa 的邂逅

常用属性说明

JXCategoryView常用属性说明

Cell样式常用属性说明

指示器常用属性说明

可以多个IndicatorView搭配使用，但是效果需要自己把控，效果不是越多越好。参考混合使用；

使用

//1、初始化JXCategoryTitleView
self.categoryView = [[JXCategoryTitleView alloc] initWithFrame:CGRectMake(0, 0, WindowsSize.width, categoryViewHeight)];
self.categoryView.delegate = self;
 
//2、添加并配置指示器
//lineView
JXCategoryIndicatorLineView *lineView = [[JXCategoryIndicatorLineView alloc] init];
lineView.indicatorLineViewColor = [UIColor redColor];
lineView.indicatorLineWidth = JXCategoryViewAutomaticDimension;
//backgroundView
JXCategoryIndicatorBackgroundView *backgroundView = [[JXCategoryIndicatorBackgroundView alloc] init];
backgroundView.backgroundViewColor = [UIColor redColor];
backgroundView.backgroundViewWidth = JXCategoryViewAutomaticDimension;
titleCategoryView.indicators = @[lineView, backgroundView];
 
//3、绑定contentScrollView。self.scrollView的初始化细节参考源码。
self.categoryView.contentScrollView = self.scrollView;
[self.view addSubview:self.categoryView];
复制代码

• 单个cell刷新：比如红点示例里面，调用- (void)reloadCell:(NSUInteger)index
• 所有状态重置：数据源、属性配置有变动时（比如从服务器拉取回来数据），需要调用reloadData方法刷新状态。

指示器样式自定义

仓库自带：JXCategoryIndicatorLineView、JXCategoryIndicatorTriangleView、JXCategoryIndicatorImageView、JXCategoryIndicatorBackgroundView、JXCategoryIndicatorBallView

主要实现的方法：

• 继承JXCategoryIndicatorComponentView，内部遵从了JXCategoryIndicatorProtocol协议；
• 实现协议方法，自定义效果：
  • - (void)jx_refreshState:(CGRect)selectedCellFrame初始化或reloadData，重置状态；
  • - (void)jx_contentScrollViewDidScrollWithLeftCellFrame:(CGRect)leftCellFrame rightCellFrame:(CGRect)rightCellFrame selectedPosition:(JXCategoryCellClickedPosition)selectedPosition percent:(CGFloat)percent contentScrollView在进行手势滑动时，处理指示器跟随手势变化UI逻辑；
  • - (void)jx_selectedCell:(CGRect)cellFrame clickedRelativePosition:(JXCategoryCellClickedPosition)clickedRelativePosition根据选中的某个cell，处理过渡效果；

具体实例：参考demo工程里面的JXCategoryIndicatorDotLineView

Cell子类化注意事项

仓库自带：JXCategoryTitleView、JXCategoryTitleImageView、JXCategoryNumberView、JXCategoryDotView、JXCategoryImageView

主要实现的方法：

• - (Class)preferredCellClass返回自定义的cell；
• - (void)refreshDataSource刷新数据源，使用自定义的cellModel；
• - (void)refreshCellModel:(JXCategoryBaseCellModel *)cellModel index:(NSInteger)index初始化、reloadData时对数据源重置；
• - (CGFloat)preferredCellWidthAtIndex:(NSInteger)index根据cell的内容返回对应的宽度；
• - (void)refreshSelectedCellModel:(JXCategoryBaseCellModel *)selectedCellModel unselectedCellModel:(JXCategoryBaseCellModel *)unselectedCellModelcell选中时进行状态刷新；
• - (void)refreshLeftCellModel:(JXCategoryBaseCellModel *)leftCellModel rightCellModel:(JXCategoryBaseCellModel *)rightCellModel ratio:(CGFloat)ratiocell左右滚动切换的时候，进行状态刷新；

具体实例：参考demo工程里面的JXCategoryTitleAttributeView

继承提示

• 任何子类化，view、cell、cellModel三个都要子类化，即使某个子类cell什么事情都不做。用于维护继承链，以免以后子类化都不知道要继承谁了；
• 如果你想完全自定义cell里面的内容，那就继承JXCategoryIndicatorView、JXCategoryIndicatorCell、JXCategoryIndicatorCellModel，就像JXCategoryTitleView、JXCategoryTitleCell、JXCategoryTitleCellModel那样去做；
• 如果你只是在父类进行一些微调，那就继承目标view、cell、cellModel，对cell原有控件微调、或者加入新的控件皆可。就像JXCategoryTitleImageView系列、JXCategoryTitleAttributeView系列那样去做；

侧滑手势

首先，在viewDidAppear加上下面代码：

- (void)viewDidAppear:(BOOL)animated {
    [super viewDidAppear:animated];
    self.navigationController.interactivePopGestureRecognizer.enabled = (self.categoryView.selectedIndex == 0);
}
复制代码

系统默认返回Item

• 点击处理：

#pragma mark - JXCategoryViewDelegate
- (void)categoryView:(JXCategoryBaseView *)categoryView didSelectedItemAtIndex:(NSInteger)index {
    self.navigationController.interactivePopGestureRecognizer.enabled = (index == 0);
}
复制代码

自定义导航栏返回Item

• 设置代理：self.navigationController.interactivePopGestureRecognizer.delegate = (id)self;
• 实现代理方法：

- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldRecognizeSimultaneouslyWithGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer {
    return YES;
}
复制代码

• 点击处理：

#pragma mark - JXCategoryViewDelegate
- (void)categoryView:(JXCategoryBaseView *)categoryView didSelectedItemAtIndex:(NSInteger)index {
    self.navigationController.interactivePopGestureRecognizer.enabled = (index == 0);
}
复制代码

contentScrollView

• 布局灵活：JXCategoryView没有与contentScrollView强关联，你甚至可以不设置这个属性，把它当做简单的SegmentedControl。他们之间布局没有任何要求，可以把JXCategoryView放入导航栏、UITableViewSectionHeader等任何你想要的地方。
• 点击处理：因为充分解耦，在JXCategoryView点击回调中，你需要添加如下代码进行内容滚动切换：

#pragma mark - JXCategoryViewDelegate
- (void)categoryView:(JXCategoryBaseView *)categoryView didSelectedItemAtIndex:(NSInteger)index {
    [self.scrollView setContentOffset:CGPointMake(self.scrollView.bounds.size.width*index, 0) animated:YES];
}
复制代码

补充

该仓库保持随时更新，对于主流新的分类选择效果会第一时间支持。使用过程中，有任何建议或问题，可以通过以下方式联系我： 邮箱：317437084@qq.com QQ群： 112440151

Github地址

下载源码，一睹为快！JXCategoryView