No Description

mortimer eeea6b3646 加了商城 6 years ago
..
SGPagingView eeea6b3646 加了商城 6 years ago
LICENSE eeea6b3646 加了商城 6 years ago
README.md eeea6b3646 加了商城 6 years ago

README.md

SGPagingView

目录

效果图

主要内容的介绍

  • 指示器遮盖样式

  • 指示器固定样式

  • 指示器动态样式

  • 指示器下划线样式

  • 指示器长度自定义

  • 标题文字渐显效果

  • 标题文字缩放效果

  • 多种指示器滚动样式

SGPagingView 集成

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

代码介绍

SGPagingView 的使用(详细使用, 请参考 Demo)

    /// pageTitleView 
    SGPageTitleViewConfigure *configure = [SGPageTitleViewConfigure pageTitleViewConfigure];
    
    self.pageTitleView = [SGPageTitleView pageTitleViewWithFrame:frame delegate:self titleNames:titleNames configure:configure];
    [self.view addSubview:_pageTitleView];
    
    
    /// pageContentView
    self.pageContentView = [[SGPageContentView alloc] initWithFrame:frame parentVC:self childVCs:childVCs];
    _pageContentView.delegatePageContentView = self;
    [self.view addSubview:_pageContentView];
  • 滚动内容视图的代理方法 ```
  • (void)pageContentView:(SGPageContentView *)pageContentView 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.pageContentView setPageCententViewCurrentIndex:selectedIndex]; } ```

SGPagingView 的介绍

主要属性、方法 描述
selectedIndex 选中标题下标
resetSelectedIndex 重置标题下标
titleFont 标题文字字号大小,默认 15 号字体
titleColor 普通状态下标题按钮文字的颜色,默认为黑色
titleSelectedColor 选中状态下标题按钮文字的颜色,默认为红色
indicatorColor 指示器颜色,默认为红色
indicatorStyle 指示器样式,默认为下划线样式;下划线、遮盖样式
indicatorHeight 指示器高度;下划线样式下默认为 2.f,遮盖样式下,默认为标题文字的高度,若大于 SGPageTitleView,则高度为 SGPageTitleView 高度,下划线样式未做处理
indicatorAdditionalWidth 指示器的额外宽度,默认为 0.f,介于按钮文字宽度与按钮宽度之间;若大于按钮的宽度,则为按钮的宽度
spacingBetweenButtons 按钮之间的间距,默认 20.f
indicatorStyle 指示器样式;SGIndicatorStyleDefault、SGIndicatorStyleCover、SGIndicatorStyleFixed、SGIndicatorStyleDynamic(仅在 SGIndicatorScrollStyleDefault 样式下支持)
indicatorCornerRadius 遮盖样式下圆角属性,默认为 0.f;若圆角大于 1/2 指示器高度,则圆角大小为 1/2 指示器高度
indicatorScrollStyle 指示器滚动样式
resetTitleWithIndex:newTitle: 更改指定下标的标题

问题及解决方案

1、CocoaPods 安装 SGPagingView 时,遇到的问题及解决方案

  • 若在使用 CocoaPods 安装 SGPagingView 时,出现 [!] Unable to find a specification for SGPagingView 提示时,打开终端先输入 pod repo remove master;执行完毕后再输入 pod setup 即可 (可能会等待一段时间) ***

2、关于父子控制器的说明(SGPageContentView 与 SGPageContentScrollView)

SGPageContentView 使用的是 UICollectionView 的重用机制管理子视图 内部是先添加子视图控制器到父视图控制器上([self.parentViewController addChildViewController:childVC]),再添加子视图的 view 到父视图的 view 上的([cell.contentView addSubview:childVC.view]),这时会存在一个问题:即第一次加载第一个子视图时,第一个子视图的 viewWillAppear 方法不会被调用;原因是,先调用 addChildViewController,子视图控制器与父视图控制器的事件同步,即当父视图控制器的 viewDidAppear 调用时,子视图控制器的 viewDidAppear 方法会调用一次,再调用 addSubView 也不会触发viewWillAppear 和 viewDidAppear;所以第一次加载子视图控制器时 viewWillAppear 不会被调用,再去加载其他子视图控制器不会出现这种问题了。说明:针对这种情况网络数据请求建议在 viewDidLoad 或 viewDidAppear 中作处理

SGPageContentScrollView 使用的是 UIScrollView 拖拽结束后的方法加载子视图 内部是先添加子视图的 view 到父视图的 view 上的([self.scrollView addSubview:childVC.view]),再添加子视图控制器到父视图控制器上([self.parentViewController addChildViewController:childVC]),这时会存在一个问题:即第一次加载第一个子视图时,第一个子视图的 viewDidAppear 方法会调用二次;原因是,先调用 addSubView 时,viewWillAppear 和 viewDidAppear 会各调用一次,再 addChildViewController 时,子视图控制器与父视图控制器的事件同步,即当父视图控制器的 viewDidAppear 调用时,子视图控制器的 viewDidAppear 方法会再调用一次;所以第一次加载的子视图控制器时 viewDidAppear 方法会被调用两次,再去加载其他子视图控制器不会出现这种问题。说明:针对这种情况网络请求数据建议在 viewWillAppear 或 viewDidLoad 中作处理


3、关于侧滑返回手势(请参考 DefaultVCPopGesture 类以及点击子控制器对下一界面所做的处理)

1、如果是系统默认返回 item ;只需实现 SGPageContentView 的 pageContentView:offsetX:代理方法或 SGPageContentScrollView 的 pageContentScrollView:offsetX:代理方法,并在此方法实现以下代码即可,如:
- (void)pageContentScrollView:(SGPageContentScrollView *)pageContentScrollView offsetX:(CGFloat)offsetX {
    if (offsetX == 0) {
        self.navigationController.interactivePopGestureRecognizer.enabled = YES;
    } else {
        self.navigationController.interactivePopGestureRecognizer.enabled = NO;
    }
}
2、如果是自定义返回 item

a. 设置代理:self.navigationController.interactivePopGestureRecognizer.delegate = (id)self;

b. 遵循协议:UINavigationControllerDelegate

c. 实现代理方法:

- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldRecognizeSimultaneouslyWithGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer {
    return YES;
}

d. 实现 SGPageContentView 的 pageContentView:offsetX:代理方法或 SGPageContentScrollView 的 pageContentScrollView:offsetX:代理方法;实现代码如 1、

3、issues 关于返回手势 已有开发者提供了解决方案,可供参看

版本介绍

  • 2016-10-07 :初始版本的创建

  • 2017-04-13 :版本升级(根据标题内容自动识别 SGPageTitleView 是静止还是滚动)

  • 2017-06-01 :v1.1.0 解决标题中既有中文又有英文存在的指示器滚动错乱问题以及性能优化

  • 2017-06-15 :v1.1.5 新增新浪微博模块以及代码的优化

  • 2017-07-21 :v1.1.7 新增 SGPageContentScrollView 类以及加入 pods 管理

  • 2017-10-17 :v1.3.0 版本升级(新增 SGPageTitleViewConfigure 类,提供更多的属性设置以及支持指示器遮盖样式)

  • 2017-10-28 :v1.3.2 SGPageTitleViewConfigure 类新增指示器遮盖样式下的边框宽度及边框颜色属性

  • 2017-11-01 :适配 iOS 11(如果你是 Xcode 8 的运行环境,请在 releases 中下载 v1.3.2 的代码进行运行)

  • 2017-11-28 :v1.3.3 SGPageContentView 与 SGPageContentScrollView 新增代理方法,用来处理侧滑返回手势

  • 2017-12-07 :v1.3.4 新增指示器固定样式

  • 2017-12-28 :v1.3.5 新增指示器动态样式(仅在 SGIndicatorScrollStyleDefault 样式下支持)

  • 2017-12-28 :v1.3.6 解决 SGPageTitleView 标题点击与 SGPageContentView 滚动问题

Concluding remarks

  • 如在使用中, 遇到什么问题或有更好建议者, 请记得 Issues me 或 kingsic@126.com 邮箱联系我