There is an English version of README here. just click it!
A powerful and easy to use category view (segmentedcontrol, segmentview, pagingview, pagerview, pagecontrol) (腾讯新闻、今日头条、QQ音乐、网易云音乐、京东、爱奇艺、腾讯视频、淘宝、天猫、简书、微博等所有主流APP分类切换滚动视图)
与其他的同类三方库对比的优点:
说明 | Gif |
---|---|
LineView | |
LineView京东风格 | |
LineView爱奇艺风格 | |
BallView QQ黏性红点 | |
TriangleView 三角形底部 | |
TriangleView 三角形顶部 | |
BackgroundView椭圆形 | |
BackgroundView椭圆形+阴影 | |
BackgroundView长方形 | |
BackgroundView遮罩有背景 | |
BackgroundView遮罩无背景 | |
ImageView底部(小船) | |
ImageView背景(最佳男歌手) | |
ImageView滚动效果(足球) | |
混合使用 | |
indicator自定义-点线效果 |
JXCategoryIndicatorLineView、JXCategoryIndicatorImageView、JXCategoryIndicatorBallView、JXCategoryIndicatorTriangleView均支持上下位置切换。
说明 | Gif |
---|---|
颜色渐变 | |
大小缩放 | |
Cell背景色渐变 | |
分割线 | |
TitleImage_Top | |
TitleImage_Left | |
TitleImage_Bottom | |
TitleImage_Right | |
Image | |
数字 | |
红点 | |
自定义-多行+富文本 | |
腾讯视频效果 |
说明 | Gif |
---|---|
SegmentedControl | |
导航栏使用 | |
嵌套使用 | |
个人主页(上下左右滚动、header悬浮) | |
垂直列表滚动 高仿腾讯视频 (背景色异常是录屏软件bug) |
Clone代码,把Sources文件夹拖入项目,#import "JXCategoryView.h",就可以使用了;
target '<Your Target Name>' do
pod 'JXCategoryView'
end
JXCategoryIndicatorProtocol
协议,就可以实现你的指示器效果。参考:JXCategoryIndicatorLineView;VerticalListViewController
,未做功能封装,参考里面的代码做,多注意注释,就可以实现了。属性 | 说明 |
---|---|
defaultSelectedIndex | 默认选中的index,用于初始化时指定选中某个index |
selectedIndex | 只读属性,当前选中的index |
cellWidth | cell的宽度,默认:JXCategoryViewAutomaticDimension |
cellSpacing | cell之间的间距,默认20 |
cellWidthIncrement | cell宽度的补偿值,默认0 |
averageCellWidthEnabled | 当cell内容总宽度小于JXCategoryBaseView的宽度,是否将cellWidth均分。默认为YES。 |
contentScrollView | 需要关联的contentScrollView,内部监听contentOffset
|
属性 | 说明 |
---|---|
titleColor | titleLabel未选中颜色 默认:[UIColor blackColor] |
titleSelectedColor | titleLabel选中颜色 默认:[UIColor redColor] |
titleFont | titleLabel的字体 默认:[UIFont systemFontOfSize:15] |
titleColorGradientEnabled | title的颜色是否渐变过渡 默认:NO |
titleLabelMaskEnabled | titleLabel是否遮罩过滤 默认:NO |
titleLabelZoomEnabled | titleLabel是否缩放 默认:NO |
titleLabelZoomScale | citleLabel缩放比例 默认:1.2 |
imageZoomEnabled | imageView是否缩放 默认:NO |
imageZoomScale | imageView缩放比例 默认:1.2 |
separatorLineShowEnabled | cell分割线是否展示 默认:NO (颜色、宽高可以设置) |
JXCategoryTitleImageType | 图片所在位置:上面、左边、下面、右边 默认:左边 |
属性 | 说明 |
---|---|
JXCategoryIndicatorComponentView.componentPosition | 指示器的位置 默认:Bottom |
JXCategoryIndicatorComponentView.scrollEnabled | 手势滚动、点击切换的时候,是否允许滚动,默认YES |
JXCategoryIndicatorLineView.lineStyle | 普通、京东、爱奇艺效果 默认:Normal |
JXCategoryIndicatorLineView.lineScrollOffsetX | 爱奇艺效果专用,line滚动时x的偏移量,默认为10; |
JXCategoryIndicatorLineView.indicatorLineWidth | 默认JXCategoryViewAutomaticDimension(与cellWidth相等) |
JXCategoryIndicatorLineView.indicatorLineViewHeight | 默认:3 |
JXCategoryIndicatorLineView.indicatorLineViewCornerRadius | 默认JXCategoryViewAutomaticDimension (等于self.indicatorLineViewHeight/2) |
JXCategoryIndicatorLineView.indicatorLineViewColor | 默认为[UIColor redColor] |
JXCategoryIndicatorTriangleView.triangleViewSize | 默认:CGSizeMake(14, 10) |
JXCategoryIndicatorTriangleView.triangleViewColor | 默认为[UIColor redColor] |
JXCategoryIndicatorImageView.indicatorImageView | 设置image |
JXCategoryIndicatorImageView.indicatorImageViewRollEnabled | 是否允许滚动,默认:NO |
JXCategoryIndicatorImageView.indicatorImageViewSize | 默认:CGSizeMake(30, 20) |
JXCategoryIndicatorBackgroundView.backgroundViewWidth | 默认JXCategoryViewAutomaticDimension(与cellWidth相等) |
JXCategoryIndicatorBackgroundView.backgroundViewWidthIncrement | 宽度增量补偿,因为backgroundEllipseLayer一般会比实际内容大一些。默认10 |
JXCategoryIndicatorBackgroundView.backgroundViewHeight | 默认JXCategoryViewAutomaticDimension(与cell高度相等) |
JXCategoryIndicatorBackgroundView.backgroundViewCornerRadius | 默认JXCategoryViewAutomaticDimension(即backgroundViewHeight/2) |
JXCategoryIndicatorBackgroundView.backgroundViewColor | 默认为[UIColor redColor] |
JXCategoryIndicatorBallView.ballViewSize | 默认:CGSizeMake(15, 15) |
JXCategoryIndicatorBallView.ballScrollOffsetX | 小红点的偏移量 默认:20 |
JXCategoryIndicatorBallView.ballViewColor | 默认为[UIColor redColor] |
可以多个IndicatorView搭配使用,但是效果需要自己把控,效果不是越多越好。参考混合使用;
self.categoryView = [[JXCategoryTitleView alloc] initWithFrame:CGRectMake(0, 0, WindowsSize.width, categoryViewHeight)];
self.categoryView.delegate = self;
self.categoryView.contentScrollView = self.scrollView;
//------指示器属性配置------//
//lineView
JXCategoryIndicatorLineView *lineView = [[JXCategoryIndicatorLineView alloc] init];
//triangleView
JXCategoryIndicatorTriangleView *triangleView = [[JXCategoryIndicatorTriangleView alloc] init];
lineView.indicatorLineWidth = 20;
//ballView
JXCategoryIndicatorBallView *ballView = [[JXCategoryIndicatorBallView alloc] init];
//backgroundView
JXCategoryIndicatorBackgroundView *backgroundView = [[JXCategoryIndicatorBackgroundView alloc] init];
titleCategoryView.indicators = @[lineView, triangleView, ballView, backgroundView];
[self.view addSubview:self.categoryView];
- (void)reloadCell:(NSUInteger)index
reloadDatas
方法刷新状态。仓库自带:JXCategoryIndicatorLineView、JXCategoryIndicatorTriangleView、JXCategoryIndicatorImageView、JXCategoryIndicatorBackgroundView、JXCategoryIndicatorBallView
主要实现的方法:
JXCategoryIndicatorProtocol
协议;- (void)jx_refreshState:(CGRect)selectedCellFrame
初始化或reloadDatas,重置状态;- (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
仓库自带:JXCategoryTitleView、JXCategoryTitleImageView、JXCategoryNumberView、JXCategoryDotView、JXCategoryImageView
主要实现的方法:
- (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 *)unselectedCellModel
cell选中时进行状态刷新;- (void)refreshLeftCellModel:(JXCategoryBaseCellModel *)leftCellModel rightCellModel:(JXCategoryBaseCellModel *)rightCellModel ratio:(CGFloat)ratio
cell左右滚动切换的时候,进行状态刷新;具体实例:参考demo工程里面的JXCategoryTitleAttributeView
JXCategoryIndicatorView、JXCategoryIndicatorCell、JXCategoryIndicatorCellModel
,就像JXCategoryTitleView、JXCategoryTitleCell、JXCategoryTitleCellModel
那样去做;JXCategoryTitleImageView系列、JXCategoryTitleAttributeView系列
那样去做;首先,在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);
}
- (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);
}
#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
喜欢就star❤️一下吧
JXCategoryView is released under the MIT license.
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。