SGPagingView

• Swift Version

• QQ群：825339547

• 1.6.0 开始支持 autolayout 创建

• SGTagsView 设计来源于本框架中的 SGPageTitleView

结构图

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 方法不调用
• addChildViewController 与 viewWillAppear、viewDidAppear 关系说明

---

四、关于侧滑返回手势（请参考 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.