SGPagingView
-
QQ群：825339547
-
1.6.0 开始支持 autolayout 创建
结构图
SGPageTitleViewConfigure（SGPageTitleView 初始化配置信息）
SGPageTitleView（用于与 SGPageContent 联动）
SGPageContentScrollView（内部由 UIScrollView 实现）
SGPageContentCollectionView（内部由 UICollectionView 实现）
效果图
主要内容介绍
-
系统样式 -
图片样式 -
指示器遮盖样式 -
指示器固定样式 -
指示器动态样式 -
指示器下划线样式 -
指示器长度自定义 -
多种指示器滚动样式 -
标题文字渐显效果 -
标题文字缩放效果 -
标题文字富文本样式
Installation
- 1、CocoaPods 导入 pod 'SGPagingView', '~> 1.6.7'
- 2、下载、拖拽 “SGPagingView” 文件夹到工程中
代码介绍
SGPagingView 的使用（详细使用，请参考 API 及 Demo）
/// pageTitleViewConfigure
SGPageTitleViewConfigure *configure = [SGPageTitleViewConfigure pageTitleViewConfigure];
/// pageTitleView
SGPageTitleView *pageTitleView = [SGPageTitleView pageTitleViewWithFrame:frame delegate:self titleNames:titleNames configure:configure];
[self.view addSubview:pageTitleView];
/// pageContent
SGPageContentScrollView *pageContentScrollView = [[SGPageContentScrollView alloc] initWithFrame:frame parentVC:self childVCs:childVCs];
pageContentScrollView.delegatePageContentScrollView = self;
[self.view addSubview:pageContentScrollView];
- 滚动内容视图的代理方法
- (void)pageContentScrollView:(SGPageContentScrollView *)pageContentScrollView progress:(CGFloat)progress originalIndex:(NSInteger)originalIndex targetIndex:(NSInteger)targetIndex {
[self.pageTitleView setPageTitleViewWithProgress:progress originalIndex:originalIndex targetIndex:targetIndex];
}
- 滚动标题视图的代理方法
- (void)pageTitleView:(SGPageTitleView *)pageTitleView selectedIndex:(NSInteger)selectedIndex {
[self.pageContentScrollView setPageCententScrollViewCurrentIndex:selectedIndex];
}
问题及解决方案
一、CocoaPods 安装 SGPagingView 时，遇到的问题及解决方案
- 若在使用 CocoaPods 安装 SGPagingView 时，出现 [!] Unable to find a specification for SGPagingView 提示时，打开终端先输入 pod repo remove master；执行完毕后再输入 pod setup 即可 (可能会等待一段时间)
二、标题文字缩放属性与指示器关系
- 标题文字缩放属性与指示器下划线、遮盖样式不兼容，但固定及动态样式兼容
三、关于父子控制器的说明（SGPageContentScrollView 与 SGPageContentCollectionView）
参考链接
四、关于侧滑返回手势（请参考 DefaultVCPopGesture 类以及点击子控制器对下一界面所做的处理）
1、如果是系统默认返回 item ；只需实现 SGPageContentScrollView 的 pageContentScrollView:offsetX:代理方法或 SGPageContentCollectionView 的 pageContentCollectionView:offsetX:代理方法，并在此方法实现以下代码即可，如：
- (void)pageContentScrollView:(SGPageContentScrollView *)pageContentScrollView index:(NSInteger)index {
if (index == 0) {
self.navigationController.interactivePopGestureRecognizer.enabled = YES;
} else {
self.navigationController.interactivePopGestureRecognizer.enabled = NO;
}
}
2、如果是自定义返回 item
a. 需单独在 .h 文件中导入 #import "SGPagingViewPopGestureVC.h"，且控制器继承 SGPagingViewPopGestureVC;
b. 实现 SGPageContentScrollView 的 pageContentScrollView:index:代理方法或 SGPageContentCollectionView 的 pageContentCollectionView:index:代理方法
- (void)pageContentScrollView:(SGPageContentScrollView *)pageContentScrollView index:(NSInteger)index {
if (index == 0) {
self.navigationController.interactivePopGestureRecognizer.enabled = YES;
} else {
self.navigationController.interactivePopGestureRecognizer.enabled = NO;
}
}
温馨提示一：由于 index != 0 时 self.navigationController.interactivePopGestureRecognizer.enabled = NO; 所以 push 到下一控制器需在 viewDidLoad 中设置为 YES；
温馨提示二：导航栏包装自定义返回 item 使用 SGPagingView 也会导致侧滑返回失效解决方案同（2、如果是自定义返回 item）；如果你工程中某个控制器使用自定义返回 item 解决方案同（2、如果是自定义返回 item）；这里只是提供一种解决方案，仅供参考。如果你有更好的解决方案欢迎联我
温馨提示三：自定义返回 item 导致侧滑返回手势失效参考链接
3、issues 关于返回手势 已有开发者提供了解决方案，仅供参看
五、只有 PageContent 为 SGPageContentScrollView 且 selectedIndex != 0 与 insertSubview 方法同时出现时造成程序崩溃
- 第一种解决方案：更换 SGPageContentScrollView 为 SGPageContentCollectionView 即可
- 第一种解决方案：默认子控制器为0，即 selectedIndex 不设置
- 第三种解决方案：代码如下处理
[self.view addSubview:_pageContentScrollView];
dispatch_async(dispatch_get_main_queue(), ^{
[self.view insertSubview:self.pageContentScrollView atIndex:0];
});
- 如不需要 autolayout 创建，导入 v1.5.6（无需考虑上述问题）
版本介绍
-
2016-10-07 ：初始版本的创建
-
2017-04-13 ：版本升级（根据标题内容自动识别 SGPageTitleView 是静止还是滚动样式）
-
2017-07-21 ：v1.1.7 加入 CocoaPods 管理以及新增 SGPageContentScrollView 类
-
2017-10-17 ：v1.3.0 版本升级（新增 SGPageTitleViewConfigure 类并提供更多属性设置以及支持指示器遮盖样式）
-
2018-05-08 ：v1.3.7 修复 1.3.6 版本选中标题重复点击恢复默认状态以及 SGPageTitleViewConfigure 新增配置属性
-
2018-07-09 ：v1.5.0 版本升级（具体相关信息请查看 releases 中版本介绍）
-
2018-08-28 ：v1.5.2 SGPageContentScrollView 内部代码优化处理（感谢 petyou 提供的优化方案）
-
2018-09-01 ：v1.5.3 SGPageTitleView 内部代码优化以及新增 SGPagingViewPopGestureVC 用于解决侧滑返回手势
-
2018-09-26 ：v1.5.5 标题文字缩放效果由文字缩放调整为控件缩放
-
2018-12-01 ：v1.5.6 SGPageTitleView 新增重置标题、指示器颜色方法
-
2019-01-09 ：v1.6.0 支持 autolayout 创建
-
2019-03-27 ：v1.6.1 修复 1.6.0 版本 addBadgeForIndex 方法内 badge 布局问题
-
2019-07-17 ：v1.6.3 修复设置图片样式下图片布局问题以及对内部代码的优化处理
-
2019-07-20 ：v1.6.5 滚动样式下 titleTextZoom 属性支持指示器下划线及遮盖样式下的滚动
-
2019-07-22 ：v1.6.6 SGPageTitleViewConfigure 新增 equivalence 属性支持静止样式下标题从左到右自动布局
-
2019-07-27 ：v1.6.7 支持标题文字上下行样式以及 titleGradientEffect 属性与 resetTitleColor:titleSelectedColor: 方法的兼容
License
SGPagingView is released under the MIT license. See LICENSE for details.