美文网首页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