# SGPagingView
**Repository Path**: cuiyu8580/SGPagingView
## Basic Information
- **Project Name**: SGPagingView
- **Description**: A powerful and easy to use segment control 【QQ、淘宝、微博、腾讯、网易新闻、今日头条等标题滚动视图】
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 0
- **Created**: 2019-12-25
- **Last Updated**: 2020-12-23
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# SGPagingView
* [Swift Version](https://github.com/kingsic/SGPagingView-Swift)
* QQ群：825339547
* 1.6.0 开始支持 autolayout 创建
* [SGTagsView 设计来源于本框架中的 SGPageTitleView](https://github.com/kingsic/SGCrayfish)
## 结构图
```
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）
###### 参考链接
* [添加子视图控制器时，子视图控制器的 viewWillAppear 方法不调用](https://blog.csdn.net/u012907783/article/details/78972227)
* [addChildViewController 与 viewWillAppear、viewDidAppear 关系说明](https://blog.csdn.net/zhaoxy_thu/article/details/50826190)
***
### 四、关于侧滑返回手势（请参考 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 导致侧滑返回手势失效[参考链接](https://www.jianshu.com/p/33ce1340a543)
#### 3、issues [关于返回手势](https://github.com/kingsic/SGPagingView/issues/25) 已有开发者提供了解决方案，仅供参看
***
### 五、只有 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](https://github.com/kingsic/SGPagingView/releases) 中版本介绍）
* 2018-08-28 ：v1.5.2 SGPageContentScrollView 内部代码优化处理（感谢 [petyou](https://github.com/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](https://github.com/kingsic/SGPagingView/blob/master/LICENSE) for details.