美文网首页iOS学习征服iOSiOS程序猿
【开发工具】AGCustomPageControllerView

【开发工具】AGCustomPageControllerView

作者: 小子爱搞事 | 来源:发表于2017-02-21 13:54 被阅读146次

仿半糖效果,又和半糖效果有些区别

效果展示:

2月-21-2017 13-30-57.gif 2月-21-2017 13-35-03.gif

对比

半糖效果:

第一个页面 banner 隐藏之后,滑动到其它界面,滑动至 banner 显示时,其它界面会重置回顶部位置。

AGPageControllerViewController:

第一个页面 banner 隐藏之后,滑动到其它界面,滑动至 banner 显示时,不会影响到之前界面的滑动位置,界面位置保持在原来的位置。

优点

1,简单易用

通过继承 AGPageControllerViewController 即可使用。对于每个子控制器的显示,由每个子控制器自己负责即可。

2,自定义标签栏样式

标签栏使用 collectionView 实现,提供了默认的样式。开发者也可以根据自己的需求,重写标签栏 cell 的样式(具体查看 AGPageControllerViewController .h #pragma mark - 自定义标签设置 下提供的方法)。

缺点及待解决的问题:

1,banner 显示时滑动,有底部的 tableView 有跳动

在真机上,效果比较不错,在模拟器和7p大屏幕的手机上,界面的跳动可以被观察到。由于界面需要保持自己原有的位置,因此需要实时的记录滚动时的位置,这导致 banner 显示时的滚动中,可以看到界面会有一些跳动。

2,设置默认选中页时,能够看到切换过程

由于使用的是 collectionView 来实现上面的标签栏,collectionView 中的 cell 没有载入完成时,设置其滚动到指点的 cell 是无效的。

现在的处理方式:
通过延时等待 collectionView 的 cell 载入完毕后在滚动

3,- (void)setContentOffset:(CGPoint)contentOffset animated:(BOOL)animated; 方法的问题

标签切换的过程中涉及到滚动的位置问题,如果设置滚动的时候,设置 animated 为 YES,滚动的位置就会发生偏差。
AGPageControllerViewController 提供了界面滚动会顶部的 方法 - (void)allViewScrollToTop;,也会出现同样的问题。

现在的处理方法:
将 animated 设置为NO,但是在切换的过程中,界面没有滚动的过程,一下就切换过去了

文件结构

Paste_Image.png

使用:

工程地址:
https://github.com/againxu/AGCustomPageControllerView.git
里面包含了具体的使用方法

一,继承 AGPageControllerViewController 使用。
@interface ViewController1 : AGPageControllerViewController

使用提供的初始化方法 - (instancetype)initWithChildControllers:(NSArray<UIViewController *> *)ag_childControllers; 进行设置

    // 创建要显示的子控制器
    NSMutableArray *childVcs = [NSMutableArray array];
    for (int index = 0; index < 10; index++) {
        
        if (index % 2) {
            TableViewController *tabVc = [[TableViewController alloc] init];
            tabVc.title = [NSString stringWithFormat:@"==== %d ====", index];
            [childVcs addObject:tabVc];
        }else{
            CollectionViewController *collVc = [[CollectionViewController alloc] init];
            collVc.title = [NSString stringWithFormat:@"== %d ==", index];
            [childVcs addObject:collVc];
        }
    }
    
    ViewController1 *vc = [[ViewController1 alloc] initWithChildControllers:childVcs];

AGPageControllerViewController 中提供了具体配置方法,可以根据具体的需要来实现需求:

// 头部视图是否允许滚动
@property (nonatomic, assign) BOOL scrollEnable;

/** 设置子控件(滚动标签和自控制是否弹性效果) */
@property (nonatomic, assign) BOOL subViewsbounces;

/** 滚动标签样式 */
@property (nonatomic, assign) AGLabelAlignment labelAlignment;

/** 标签选中的样式 */
@property (nonatomic, assign) AGSelectStyle selectStyle;

/** 设置当前标签位置 */
- (void)setCurrentLabelIndex:(NSInteger)index;

/** 头视图 */
- (UIView *)tableHeaderView;

/** 标签栏高度 */
- (CGFloat)heightOfscrollLabelControl;

/** 重写:�自定义滑动条上的视图 */
//- (UIView *)viewForSectionHeader;

/** 滚动条右侧视图:默认无 */
- (UIView *)rightViewForSectionHeader;

/** 更新头部视图:tableViewHeader 如果是动态设定的,可以使用此方法更新 */
- (void)reloadTableViewHeader;

/** 更新子控制器 */
- (void)updateChildContollers:(NSArray<UIViewController *> *)childControllers;
- (void)reloadPageControlChildControllers;

/** 所有视图滚动到顶部 */
- (void)allViewScrollToTop;

#pragma mark - 自定义标签设置
/** 注册自定义类型的 标签 */
/** 这是个代理方法,如果需要注册自定义的 lable cell,实现代理进行注册 */
- (void)registerCellForScrollLabel:(AGScrollLabelView *)scrollLabelView;

/** 自定义类型标签 */
- (UICollectionViewCell *)scrollLabel:(AGScrollLabelView *)scrollLabelView collectionView:(UICollectionView *)collectionView cellforIndexPath:(NSIndexPath *)indexPath;

/** 标签个数,如果只显示title(通过设置vc.titles即可),不需要实现这里的方法 */
- (NSInteger)numberOfItemsInScrollLabelView:(AGScrollLabelView *)scrollLabelView;

/** 自定义类型标签的size */
- (CGSize)scrollLabel:(AGScrollLabelView *)scrollLabelView sizeForCellAtIndexPath:(NSIndexPath *)indexPath;

/** 当前选中的 标签 */
- (void)scrollLabelScrollCell:(UICollectionViewCell *)cell atIndex:(NSInteger)index;
二,自定义标签栏标签样式

在继承 AGPageControllerViewController 的子类中重写下面的方法。方法的使用和 collectionView 的数据源方法一样,具体见 demo

/** 注册自定义类型的 标签 */
/** 这是个代理方法,如果需要注册自定义的 lable cell,实现代理进行注册 */
- (void)registerCellForScrollLabel:(AGScrollLabelView *)scrollLabelView;

/** 自定义类型标签 */
- (UICollectionViewCell *)scrollLabel:(AGScrollLabelView *)scrollLabelView collectionView:(UICollectionView *)collectionView cellforIndexPath:(NSIndexPath *)indexPath;

/** 标签个数,如果只显示title(通过设置vc.titles即可),不需要实现这里的方法 */
- (NSInteger)numberOfItemsInScrollLabelView:(AGScrollLabelView *)scrollLabelView;

/** 自定义类型标签的size */
- (CGSize)scrollLabel:(AGScrollLabelView *)scrollLabelView sizeForCellAtIndexPath:(NSIndexPath *)indexPath;
对自定义标签的选中样式进行设置

在自定义的 cell 中实现如下方法,并进行样式的设定即可


/** 设置选中状态的样式 */
- (void)setSelected:(BOOL)selected{
    [super setSelected:selected];
    if (selected) {
        self.label.textColor = [UIColor redColor];
    }
    else{
        self.label.textColor = [UIColor whiteColor];
    }
}

细节处理:

1,子控制器 viewDidLoad 触发实际控制

子控制器是添加在 collectionView 的 cell 上,cell 会预先加载视图,因此如果在 - (UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath 方法中直接添加控制器的 view ,有些控制器的 view 在 cell 没有显示出来时就已经添加到 cell 上了。

处理:

a,- (UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath 处理已经显示过的控制器视图,如果没有显示过,不通过该方法显示
b,滑动过程中视图的添加,通过判断滑动结束时,在 cell 上添加控制器的 view ,并进行标记

/** 用来保存显示过的视图控制器的下标,默认包含下标 0,通过 `- (UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath ` 方法添加 */
_didLoadViewIndex = @[@0].mutableCopy;

- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView{
    if ([self.delegate respondsToSelector:@selector(containerCollectionViewController:scrollAtIndex:currentContentController:)]) {
    NSInteger index = scrollView.contentOffset.x / CGRectGetWidth(self.collectionView.frame);
    if (![self.didLoadViewIndex containsObject:@(index)]) {
        [self.didLoadViewIndex addObject:@(index)];
        UICollectionViewCell *cell = [self.collectionView cellForItemAtIndexPath:[NSIndexPath indexPathForRow:index inSection:0]];
        UIViewController *vc = self.ag_childControllers[index];
        vc.view.frame = self.frame;
        [cell.contentView.subviews makeObjectsPerformSelector:@selector(removeFromSuperview)];
        [cell.contentView addSubview:vc.view];
    }
}

- (UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath {
    UICollectionViewCell *cell = [collectionView dequeueReusableCellWithReuseIdentifier:reuseIdentifier forIndexPath:indexPath];
    [cell.contentView.subviews makeObjectsPerformSelector:@selector(removeFromSuperview)];
    if ([self.didLoadViewIndex containsObject:@(indexPath.row)]) {
        UIViewController *vc = self.ag_childControllers[indexPath.row];
        vc.view.frame = self.frame;
        [cell.contentView addSubview:vc.view];
    }
    return cell;
}

使用中遇到的问题处理:

1,tableView的上拉获取数据刷新,如果出现界面跳动,判断获取的数据是否为空,为空则tableView不reloaData

if (data.count) {
    [self.tableView reloadData];
}

对于项目中的存在的问题,如果有好的解决方案,希望能够提出来,一起讨论讨论

相关文章

网友评论

    本文标题:【开发工具】AGCustomPageControllerView

    本文链接:https://www.haomeiwen.com/subject/ojlxwttx.html