Skip to content

Latest commit

 

History

History
141 lines (102 loc) · 6.63 KB

READMEOBJC.md

File metadata and controls

141 lines (102 loc) · 6.63 KB
Raw

前言

  • 从 2.0.0 版本起，升级为 Swift 编程语言
  • 从 2.1.0 版本起，已兼容 Objective-C 语义
  • Objective-C 编程语言最后的版本是 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 版本并拖拽 “SGPagingView” 文件夹到工程中

代码介绍

  • 初始化方法
// 配置类
SGPageTitleViewConfigure *configure = [SGPageTitleViewConfigure pageTitleViewConfigure];

// 标题视图
SGPageTitleView *pageTitleView = [SGPageTitleView pageTitleViewWithFrame:frame delegate:self titleNames:titleNames configure:configure];
[self.view addSubview:pageTitleView];
    
// 内容视图
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-07-09 ：v1.5.0 版本升级：具体相关信息请查看 releases 中版本介绍

  • 2019-01-09 ：v1.6.0 版本升级：支持 autolayout 布局

  • 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 左右内边距属性