JXCategoryView 使用教程

JXCategoryView 使用教程

JXCategoryViewA powerful and easy to use category view (segmentedcontrol, segmentview, pagingview, pagerview, pagecontrol) (腾讯新闻、今日头条、QQ音乐、网易云音乐、京东、爱奇艺、腾讯视频、淘宝、天猫、简书、微博等所有主流APP分类切换滚动视图)项目地址:https://gitcode.com/gh_mirrors/jx/JXCategoryView

项目介绍

JXCategoryView 是一个强大且易于使用的分类视图库，适用于 iOS 开发。它提供了多种分类选择效果，如分段控制、分页视图、页面控制等，广泛应用于腾讯新闻、今日头条、QQ音乐、网易云音乐等主流应用中。该库支持自定义和扩展，能够满足各种复杂的UI需求。

项目快速启动

安装

首先，通过 CocoaPods 安装 JXCategoryView：

pod 'JXCategoryView'

基本使用

1. 导入库：

   #import "JXCategoryView.h"
   

2. 遵守协议：

   @interface ViewController () <JXCategoryViewDelegate, JXCategoryListContainerViewDelegate>
   @property (nonatomic, strong) JXCategoryTitleView *categoryView;
   @property (nonatomic, strong) JXCategoryListContainerView *listContainerView;
   @end
   

3. 初始化 JXCategoryTitleView：

   self.categoryView = [[JXCategoryTitleView alloc] initWithFrame:CGRectMake(0, 0, self.view.bounds.size.width, 50)];
   self.categoryView.delegate = self;
   self.categoryView.titles = @[@"新闻", @"视频", @"音乐"];
   [self.view addSubview:self.categoryView];
   

4. 初始化 JXCategoryListContainerView：

   self.listContainerView = [[JXCategoryListContainerView alloc] initWithType:JXCategoryListContainerType_ScrollView delegate:self];
   self.listContainerView.frame = CGRectMake(0, 50, self.view.bounds.size.width, self.view.bounds.size.height - 50);
   [self.view addSubview:self.listContainerView];
   self.categoryView.listContainer = self.listContainerView;
   

应用案例和最佳实践

案例一：新闻应用

在新闻应用中，JXCategoryView 可以用来实现不同新闻类别的切换，如下所示：

self.categoryView.titles = @[@"头条", @"娱乐", @"体育", @"科技"];

案例二：音乐播放器

在音乐播放器中，JXCategoryView 可以用来实现不同音乐分类的切换，如下所示：

self.categoryView.titles = @[@"推荐", @"排行榜", @"歌单", @"电台"];

最佳实践

• 动态更新标题：如果需要动态更新标题，可以通过 reloadData 方法实现：

  [self.categoryView reloadData];
  

• 自定义指示器：JXCategoryView 支持多种指示器样式，可以根据需求进行自定义：

  self.categoryView.indicators = @[indicator];
  

典型生态项目

JXCategoryViewExt

JXCategoryViewExt 是对 JXCategoryView 的扩展，提供了更多的功能和优化，如动态刷新标题和指示器颜色、支持 RTL 等。可以通过以下方式安装：

pod 'JXCategoryViewExt'

主要功能

• 动态刷新标题和指示器颜色：

  [self.categoryView gk_refreshCellState];
  [self.categoryView gk_refreshIndicatorState];
  

• 支持 RTL：

  self.categoryView.gk_refreshCellAndIndicatorState;
  

通过这些扩展，可以进一步增强 JXCategoryView 的功能，满足更多复杂的UI需求。

JXCategoryViewA powerful and easy to use category view (segmentedcontrol, segmentview, pagingview, pagerview, pagecontrol) (腾讯新闻、今日头条、QQ音乐、网易云音乐、京东、爱奇艺、腾讯视频、淘宝、天猫、简书、微博等所有主流APP分类切换滚动视图)项目地址:https://gitcode.com/gh_mirrors/jx/JXCategoryView