-
Notifications
You must be signed in to change notification settings - Fork 282
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
167 changed files
with
5,005 additions
and
7,395 deletions.
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,192 +1,58 @@ | ||
|
|
||
| # SGPagingView | ||
|
|
||
|
|
||
| * [Swift 版本](https://github.com/kingsic/PagingViewKit) | ||
|
|
||
| * QQ群：825339547 | ||
|
|
||
| * [SGTagsView 设计来源于本框架中的 SGPageTitleView](https://github.com/kingsic/SGFastfish) | ||
| ## 前言 | ||
| * 2.0.0 版本起，升级为 Swift 编程语言 | ||
| * [Objc 版本说明](https://github.com/kingsic/SGPagingView/blob/master/READMEOBJC.md) | ||
|
|
||
|
|
||
| ## 结构图 | ||
| ``` | ||
| SGPageTitleViewConfigure（SGPageTitleView 初始化配置信息） | ||
| SGPageTitleView（用于与 SGPageContent 联动） | ||
| SGPageContentScrollView（内部由 UIScrollView 实现） | ||
| SGPageContentCollectionView（内部由 UICollectionView 实现） | ||
| ``` | ||
|  | ||
|
|
||
|
|
||
| ## 效果图 | ||
|  | ||
|
|
||
|
|
||
| ## 主要内容介绍 | ||
| * `系统样式`<br> | ||
|
|
||
| * `图片样式`<br> | ||
|
|
||
| * `指示器遮盖样式`<br> | ||
|
|
||
| * `指示器固定样式`<br> | ||
|
|
||
| * `指示器动态样式`<br> | ||
|
|
||
| * `指示器下划线样式`<br> | ||
|
|
||
| * `指示器长度自定义`<br> | ||
|
|
||
| * `多种指示器滚动样式`<br> | ||
|
|
||
| * `标题文字渐显效果`<br> | ||
|
|
||
| * `标题文字缩放效果`<br> | ||
|
|
||
| * `标题文字富文本样式`<br> | ||
|
|
||
|
|
||
| ## Installation | ||
| * 1、CocoaPods 导入 pod 'SGPagingView', '~> 1.7.2' | ||
| * 2、下载、拖拽 “SGPagingView” 文件夹到工程中 | ||
| ## Installation | ||
| * CocoaPods 导入 pod 'SGPagingView', '~> 2.0.0' | ||
|
|
||
|
|
||
| ## 代码介绍 | ||
| * 初始化方法 | ||
| ``` | ||
| /// 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]; | ||
| ``` | ||
| let configure = SGPagingTitleViewConfigure() | ||
| // PagingTitle | ||
| let pagingTitleView = SGPagingTitleView(frame: frame, titles: titles, configure: configure) | ||
| pagingTitleView.delegate = self | ||
| view.addSubview(pagingTitleView) | ||
| * 滚动内容视图的代理方法 | ||
| // PagingContent | ||
| let pagingContentView = SGPagingContentScrollView(frame: frame, parentVC: self, childVCs: childVCs) | ||
| pagingContentView.delegate = self | ||
| view.addSubview(pagingContentView) | ||
| ``` | ||
| - (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 即可 (可能会等待一段时间) | ||
| *** | ||
|
|
||
| ### 二、父子视图 autolayout 及 frame | ||
| * 父视图使用 autolayout 约束，子视图也需使用 autolayout 去约束；父视图使用 frame 布局，子视图也需使用 frame 去布局 | ||
| *** | ||
|
|
||
| ### 三、关于父子控制器的说明（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:代理方法，并在此方法实现以下代码即可，如： | ||
| * SGPagingTitleView 代理方法 | ||
| ``` | ||
| - (void)pageContentScrollView:(SGPageContentScrollView *)pageContentScrollView index:(NSInteger)index { | ||
| if (index == 0) { | ||
| self.navigationController.interactivePopGestureRecognizer.enabled = YES; | ||
| } else { | ||
| self.navigationController.interactivePopGestureRecognizer.enabled = NO; | ||
| } | ||
| func pagingTitleView(titleView: SGPagingTitleView, index: Int) { | ||
| pagingContentView.setPagingContentView(index: index) | ||
| } | ||
| ``` | ||
|
|
||
| #### 2、如果是自定义返回 item | ||
| a. 需单独在 .h 文件中导入 #import "SGPagingViewPopGestureVC.h"，且控制器继承 SGPagingViewPopGestureVC; | ||
|
|
||
| b. 实现 SGPageContentScrollView 的 pageContentScrollView:index:代理方法或 SGPageContentCollectionView 的 pageContentCollectionView:index:代理方法 | ||
| * SGPagingContentView 代理方法 | ||
| ``` | ||
| - (void)pageContentScrollView:(SGPageContentScrollView *)pageContentScrollView index:(NSInteger)index { | ||
| if (index == 0) { | ||
| self.navigationController.interactivePopGestureRecognizer.enabled = YES; | ||
| } else { | ||
| self.navigationController.interactivePopGestureRecognizer.enabled = NO; | ||
| } | ||
| func pagingContentView(contentView: SGPagingContentView, progress: CGFloat, currentIndex: Int, targetIndex: Int) { | ||
| pagingTitleView.setPagingTitleView(progress: progress, currentIndex: currentIndex, targetIndex: targetIndex) | ||
| } | ||
| ``` | ||
|
|
||
| ##### 温馨提示一：由于 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-07-21 ：v1.1.7 加入 CocoaPods 管理及新增 SGPageContentScrollView 类 | ||
|
|
||
| * 2017-10-17 ：v1.3.0 版本升级：新增 SGPageTitleViewConfigure 类及支持指示器遮盖样式 | ||
|
|
||
| * 2018-05-08 ：v1.3.7 修复 1.3.6 版本选中标题重复点击恢复默认状态及新增相关配置属性 | ||
|
|
||
| * 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 新增 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 修复 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: 方法兼容 | ||
|
|
||
| * 2020-11-01 ：v1.6.9 Badge 新增配置属性，支持网络图片，修复无指示器滚动内容视图时标题文字不切换 | ||
|
|
||
| * 2020-12-22 ：v1.7.0 标题不支持换行（极端情况出现的标题换行效果） | ||
|
|
||
| * 2021-01-05 ：v1.7.1 修复退至到后台，标题重新默认选中Bug | ||
| ## Requirements | ||
| * iOS 10.0 + | ||
| * Swift 5.0 + | ||
|
|
||
| * 2021-05-05 ：v1.7.2 新增 SGPageTitleView 左右内边距属性 | ||
|
|
||
| ## Concluding remarks | ||
| * 如有问题 [issues](https://github.com/kingsic/SGPagingView/issues) 或加QQ群：825339547 | ||
|
|
||
| ## License | ||
| SGPagingView is released under the MIT license. See [LICENSE](https://github.com/kingsic/SGPagingView/blob/master/LICENSE) for details. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,154 @@ | ||
|
|
||
| ## 前言 | ||
| * 从2.0.0版本起，Swift 语言将代替之前的 Objective-C 语言 | ||
| * Objective-C 语言最后的版本号是：[1.7.2](https://github.com/kingsic/SGPagingView/releases/tag/1.7.2)，且不在给予维护 | ||
|
|
||
| ## 结构图 | ||
| ``` | ||
| SGPageTitleViewConfigure（SGPageTitleView 初始化配置信息） | ||
| SGPageTitleView（用于与 SGPageContent 联动） | ||
| SGPageContentScrollView（内部由 UIScrollView 实现） | ||
| SGPageContentCollectionView（内部由 UICollectionView 实现） | ||
| ``` | ||
|
|
||
|
|
||
| ## Installation | ||
| * 1、CocoaPods 导入 Objective-C 版本，pod 'SGPagingView', '~> 1.7.2' | ||
| * 2、下载 [1.7.2](https://github.com/kingsic/SGPagingView/releases/tag/1.7.2) 版本并拖拽 “SGPagingView” 文件夹到工程中 | ||
|
|
||
|
|
||
| ## 代码介绍 | ||
| * 初始化方法 | ||
| ``` | ||
| /// 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 即可 (可能会等待一段时间) | ||
| *** | ||
|
|
||
| ### 二、父子视图 autolayout 及 frame | ||
| * 父视图使用 autolayout 约束，子视图也需使用 autolayout 去约束；父视图使用 frame 布局，子视图也需使用 frame 去布局 | ||
| *** | ||
|
|
||
| ### 三、关于父子控制器的说明（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-07-21 ：v1.1.7 加入 CocoaPods 管理及新增 SGPageContentScrollView 类 | ||
|
|
||
| * 2017-10-17 ：v1.3.0 版本升级：新增 SGPageTitleViewConfigure 类及支持指示器遮盖样式 | ||
|
|
||
| * 2018-05-08 ：v1.3.7 修复 1.3.6 版本选中标题重复点击恢复默认状态及新增相关配置属性 | ||
|
|
||
| * 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 新增 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 修复 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: 方法兼容 | ||
|
|
||
| * 2020-11-01 ：v1.6.9 Badge 新增配置属性，支持网络图片，修复无指示器滚动内容视图时标题文字不切换 | ||
|
|
||
| * 2020-12-22 ：v1.7.0 标题不支持换行（极端情况出现的标题换行效果） | ||
|
|
||
| * 2021-01-05 ：v1.7.1 修复退至到后台，标题重新默认选中Bug | ||
|
|
||
| * 2021-05-05 ：v1.7.2 新增 SGPageTitleView 左右内边距属性 |
Oops, something went wrong.