kongfanwu / jxcategoryview Goto Github PK

There is an English version of README here. just click it！

A powerful and easy to use category view (segmentedcontrol, pagingview, pagerview, pagecontrol, scrollview) (腾讯新闻、网易新闻、今日头条、QQ音乐、京东、爱奇艺等所有主流APP分类切换滚动视图)

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

• 效果更加全面，使用更加方便；
• 使用子类化管理代码，逻辑更清晰，功能扩展更简单；

说明	Gif
颜色渐变
大小缩放
指示器LineView
指示器LineView京东风格
指示器LineView爱奇艺风格
指示器EllipseLayer
指示器EllipseLayer遮罩
指示器ImageView(小船)
指示器滚动效果(足球)
指示器背景图(菜篮)
SegmentedControl
导航栏使用
分割线
TitleImage_Top
TitleImage_Left
TitleImage_Bottom
TitleImage_Right
TitleImage_OnlyImage
自定义-数字
个人主页(上下左右滚动、header悬浮)

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

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

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

• 学习借鉴了MJRefresh的子类化**：基类搭建基础，子类实现特殊效果。便于代码管理，功能扩展；
• JXCategoryComponentView、JXCategoryBackgroundImageView、JXCategoryLineStyleView完成指示器效果；
  • 如果要自定义指示器效果，选择其中一个继承，但是需要修改继承链，比如你继承JXCategoryComponentView实现XXView，那么之前继承于它的JXCategoryBackgroundImageView就要继承于XXView，不然XXView的效果不能得到传递；
• JXCategoryTitleView、JXCategoryTitleImageView、JXCategoryNumberView完成cell显示自定义；
  • 如果要自定义cell样式，选择其中一个继承，并修改cell样式；
• 特殊说明： 即使提供了灵活扩展，我的源码也不可能满足所有情况，建议大家可以通过fork仓库，维护自己的一套效果。也可以直接拖入源文件进行修改。
• 个人主页效果：上下左右滚动且HeaderView悬浮的实现，用的是我写的这个库JXPagingView。

多个属性可以任意搭配使用，但是效果需要自己把控，效果不是越多越好哟

self.categoryView = [[JXCategoryTitleView alloc] initWithFrame:CGRectMake(0, 0, WindowsSize.width, categoryViewHeight)];
self.categoryView.delegate = self;
self.categoryView.contentScrollView = self.scrollView;
//------配置各类属性------//
[self.view addSubview:self.categoryView];

数据源、属性配置有变动时（比如从服务器拉取回来数据），需要调用reloadDatas方法刷新状态。

任何子类化，view、cell、cellModel三个都要子类化，即使某个子类cell什么事情都不做。用于维护继承链，以免以后子类化都不知道要继承谁了

主要重载的方法，参考：JXCategoryTitleView、JXCategoryTitleImageView、JXCategoryNumberView

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

参考：JXCategoryComponentView、JXCategoryBackgroundImageView、JXCategoryLineStyleView

• 背景指示器视图自定义，添加到backgroundContainerView上面（比如backgroundEllipseLayer、backgroundImageView）；
• 底部指示图自定义，添加collectionView上面（比如indicatorLineView、indicatorImageView）；
• - (void)refreshState重载，根据属性刷新指示器状态；
• - (void)contentOffsetOfContentScrollViewDidChanged:(CGPoint)contentOffset重载，根据滚动进度刷新指示器状态；
• - (BOOL)selectItemWithIndex:(NSInteger)index重载，自定义点击的时候指示器刷新逻辑；

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

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

• 点击处理：

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

• 设置代理：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);
}

• 布局灵活：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];
}

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

喜欢就star❤️一下吧

JXCategoryView is released under the MIT license.