Latest 1.5.5
Homepage https://github.com/kingsic/SGPagingView
License MIT
Platforms ios 7.0, requires ARC
Authors

Swift Version

结构图

SGPagingView

SGPageTitleViewConfigure(SGPageTitleView 初始化配置信息)

SGPageTitleView(用于与 SGPageContent 联动)

SGPageContentScrollView(内部由 UIScrollView 实现)

SGPageContentCollectionView(内部由 UICollectionView 实现)

效果图

SGPagingView

主要内容介绍

  • 系统样式

  • 图片样式

  • 指示器遮盖样式

  • 指示器固定样式

  • 指示器动态样式

  • 指示器下划线样式

  • 指示器长度自定义

  • 标题文字渐显效果

  • 标题文字缩放效果

  • 多种指示器滚动样式

Installation

  • 1、CocoaPods 导入 pod ‘SGPagingView’, ‘~> 1.5.5’
  • 2、下载、拖拽 “SGPagingView” 文件夹到工程中

代码介绍

SGPagingView 的使用(详细使用, 请参考 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 关于返回手势 已有开发者提供了解决方案,仅供参看


版本介绍

  • 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 修复 v1.3.6 选中标题重复点击恢复默认状态以及 SGPageTitleViewConfigure 新增配置属性

  • 2018-05-09 :v1.4.0 版本升级(SGPageTitleView.h 中的部分属性调整到 SGPageTitleViewConfigure.h)

  • 2018-06-01 :v1.4.2 新增标题间分割线属性、根据下标设置标题的 attributedTitle 方法以及设置标题图片位置样式方法

  • 2018-07-01 :v1.4.3 优化标题首次点击居中问题以及修复标题文字缩放切换到后台再返回时存在的标题字号问题

  • 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 标题文字缩放效果由文字缩放调整为控件缩放

Author

License

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

Latest podspec

{
    "name": "SGPagingView",
    "version": "1.5.5",
    "summary": "A powerful and easy to use segment control",
    "homepage": "https://github.com/kingsic/SGPagingView",
    "license": "MIT",
    "authors": {
        "kingsic": "[email protected]"
    },
    "platforms": {
        "ios": "7.0"
    },
    "source": {
        "git": "https://github.com/kingsic/SGPagingView.git",
        "tag": "1.5.5"
    },
    "source_files": "SGPagingView/**/*.{h,m}",
    "requires_arc": true
}

Pin It on Pinterest

Share This