SGPagingView

结构图

SGPageTitleViewConfigure（SGPageTitleView 初始化配置信息）

SGPageTitleView（用于与 SGPageContent 联动）

SGPageContentScrollView（内部由 UIScrollView 实现）

SGPageContentCollectionView（内部由 UICollectionView 实现）

效果图

主要内容介绍

系统样式
图片样式
指示器遮盖样式
指示器固定样式
指示器动态样式
指示器下划线样式
指示器长度自定义
多种指示器滚动样式
标题文字渐显效果
标题文字缩放效果
标题文字富文本样式

Installation

1、CocoaPods 导入 pod 'SGPagingView', '~> 1.6.9'
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 即可 (可能会等待一段时间)

二、父子视图 autolayout 及 frame

父视图使用 autolayout 约束，子视图也需使用 autolayout 去约束；父视图使用 frame 布局，子视图也需使用 frame 去布局

三、关于父子控制器的说明（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-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 中版本介绍
2018-08-28 ：v1.5.2 SGPageContentScrollView 内部代码优化处理（感谢 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 新增配置属性，支持网络图片，修复无指示器滚动内容视图时标题文字不切换

License

SGPagingView is released under the MIT license. See LICENSE for details.

imooccodejesse / sgpagingview Goto Github PK

sgpagingview's Introduction