美文网首页iOS技术分享好东西小知识点
iOS开发-自定制滑动容器控制器RHNavController

iOS开发-自定制滑动容器控制器RHNavController

作者: it_hao528 | 来源:发表于2017-07-11 19:20 被阅读79次
    窗外的雨滴.jpg

    前言:转眼间将近两个月没有更新了,今天来给大家讲解一个封装的简单容器控制器RHNavController,在APP中应用的还是很多的。废话不多说,大家先来看图:


    RHNavController.gif

    原理:标题使用UIButton添加点击事件,下方页面使用UICollectionView实现滑动的控制器。点击上方标题,通过代理回调改变UICollectionViewcontentOffset来实现页面的自动左右切换,手动滑动页面改变当前选中的标题实现页面也标题同步。

    下面,按照图层从上到下来给大家详细讲解各个类的实现。
    首先是标题按钮,定制一个继承与UIButton的子类,通过重写构造方法快速实现各个属性的设置,.m实现如下:

    #import "RHNavItem.h"
    
    @implementation RHNavItem
    
    - (instancetype)initWithFrame:(CGRect)frame itemModel:(RHNavItemModel *)model {
        
        self = [super initWithFrame:frame];
        
        if (self) {
            
            self.titleLabel.font = model.titleFont;
            [self setTitle:model.title forState:UIControlStateNormal];
            [self setTitleColor:model.normalColor forState:UIControlStateNormal];
            [self setTitleColor:model.selectColor forState:UIControlStateSelected];
        }
        return self;
    }
    @end
    

    在此使用了一个model来存储了各个属性,方便对应管理。model.h如下:

    #import <Foundation/Foundation.h>
    #import <UIKit/UIKit.h>
    
    @interface RHNavItemModel : NSObject
    
    // 标题
    @property (nonatomic, copy) NSString * title;
    // 标题文字宽度
    @property (nonatomic, assign) CGFloat titleWidth;
    // 标题对应的按钮宽度
    @property (nonatomic, assign) CGFloat itemWidth;
    // 标题下方线宽度
    @property (nonatomic, assign) CGFloat lineWidth;
    // 标题字体大小
    @property (nonatomic, strong) UIFont * titleFont;
    // 标题未选中颜色
    @property (nonatomic, strong) UIColor * normalColor;
    // 标题选中颜色
    @property (nonatomic, strong) UIColor * selectColor;
    
    // 构造方法快速创建model
    - (instancetype)initWithTitle:(NSString *)title font:(UIFont *)font normalColor:(UIColor *)normalColor selectColor:(UIColor *)selectColor;
    @end
    

    接下来是上方标题按钮所在view的实现,.h文件如下:

    #import <UIKit/UIKit.h>
    #import "RHNavItem.h"
    
    #define kScreen_W [UIScreen mainScreen].bounds.size.width
    #define kScreen_H [UIScreen mainScreen].bounds.size.height
    
    @protocol RHNavViewDelegate;
    @interface RHNavView : UIView
    
    @property (nonatomic, weak) id<RHNavViewDelegate> delegate;
    @property (nonatomic, strong) NSArray * itemModelArr;
    @property (nonatomic, assign) NSInteger selectedIndex;
    
    - (instancetype)initWithFrame:(CGRect)frame itemModels:(NSArray<RHNavItemModel *> *)models;
    
    @end
    @protocol RHNavViewDelegate <NSObject>
    
    @optional
    - (void)navView:(RHNavView *)navView didSelectedItemAtIndex:(NSInteger)index;
    @end
    

    在此定义了回调的代理及重写了构造方法以快速创建对象。下面是在.m文件中的实现:

    #import "RHNavView.h"
    
    #define BtnTag       2016
    #define SVHeight     44     // scrollview高度
    #define LineHeight   2      // 移动线高度
    #define ItemHeight   41     // 按钮高度
    #define LineOriginY  SVHeight - LineHeight - 1  // 移动线 y 点
    @interface RHNavView () <UIScrollViewDelegate>
    
    @property (nonatomic, strong) UIScrollView * scrollView;
    @property (nonatomic, strong) UILabel * lab_line;
    @property (nonatomic, strong) UILabel * lab_lineH;
    @property (nonatomic, strong) NSMutableArray * modelArr;
    @property (nonatomic, strong) NSMutableArray * itemArr;
    
    @end
    
    @implementation RHNavView
    
    - (instancetype)initWithFrame:(CGRect)frame itemModels:(NSArray<RHNavItemModel *> *)models {
        
        self = [super initWithFrame:frame];
        if (self) {
            
            self.backgroundColor = [UIColor whiteColor];
            [self.modelArr removeAllObjects];
            [self.modelArr addObjectsFromArray:models];
            [self addSubviews];
        }
        return self;
    }
    
    - (void)layoutSubviews {
        
        self.scrollView.frame = CGRectMake(0, self.bounds.size.height - SVHeight, self.bounds.size.width, SVHeight);
        self.lab_lineH.frame = CGRectMake(0, self.bounds.size.height - 1, self.bounds.size.width, 1);
        [super layoutSubviews];
    }
    
    #pragma mark - create UI
    
    - (void)addSubviews {
        
        if (_modelArr.count == 0) {
            
            return;
        }
        
        float totalItemWidth = 0;
        for (RHNavItemModel * model in _modelArr) {
            
            totalItemWidth += model.itemWidth;
        }
        
        [self addSubview:self.scrollView];
        [_scrollView addSubview:self.lab_line];
        [self addSubview:self.lab_lineH];
        RHNavItemModel * mod = _modelArr.firstObject;
        _lab_line.backgroundColor = mod.selectColor;
    
        if (_modelArr.count == 1) {
            
            RHNavItemModel * model = _modelArr.firstObject;
            RHNavItem * item = [[RHNavItem alloc] initWithFrame:CGRectMake((kScreen_W - model.itemWidth)/2, 0, model.itemWidth, ItemHeight) itemModel:model];
            [self itemClick:item];
            [_scrollView addSubview:item];
            [self.itemArr addObject:item];
            
            _lab_line.frame = CGRectMake(0, LineOriginY, model.lineWidth, LineHeight);
            _lab_line.center = CGPointMake(item.center.x, _lab_line.center.y);
            
        } else if (_modelArr.count == 2) {
            
            for (int i = 0; i < _modelArr.count; i++) {
                
                RHNavItemModel * model = _modelArr[i];
                RHNavItem * item = [[RHNavItem alloc] initWithFrame:CGRectMake(i * (kScreen_W/2), 0, kScreen_W/2, ItemHeight) itemModel:model];
                item.tag = BtnTag + i;
                [item addTarget:self action:@selector(itemClick:) forControlEvents:UIControlEventTouchUpInside];
                [_scrollView addSubview:item];
                [self.itemArr addObject:item];
                
                if (i == 0) {
                    
                    _lab_line.frame = CGRectMake(0, LineOriginY, model.lineWidth, LineHeight);
                    _lab_line.center = CGPointMake(item.center.x, _lab_line.center.y);
                    [self itemClick:item];
                }
            }
        } else if (kScreen_W >= totalItemWidth) {
            
            for (int i = 0; i < _modelArr.count; i++) {
                
                RHNavItemModel * model = _modelArr[i];
                model.itemWidth += (kScreen_W - totalItemWidth)/_modelArr.count;
            }
            
            float originX = 0;
            
            for (int i = 0; i < _modelArr.count; i++) {
                
                RHNavItemModel * model = _modelArr[i];
                
                RHNavItem * item = [[RHNavItem alloc] initWithFrame:CGRectMake(originX, 0, model.itemWidth, ItemHeight) itemModel:model];
                item.tag = BtnTag + i;
                [item addTarget:self action:@selector(itemClick:) forControlEvents:UIControlEventTouchUpInside];
                [_scrollView addSubview:item];
                [self.itemArr addObject:item];
                originX += model.itemWidth;
                
                if (i == 0) {
                    
                    _lab_line.frame = CGRectMake(0, LineOriginY, model.lineWidth, LineHeight);
                    _lab_line.center = CGPointMake(item.center.x, _lab_line.center.y);
                    [self itemClick:item];
                }
            }
        } else {
            
            _scrollView.contentSize = CGSizeMake(totalItemWidth, 44);
            _scrollView.showsHorizontalScrollIndicator = NO;
            
            float originX = 0;
            for (int i = 0; i < _modelArr.count; i++) {
                
                RHNavItemModel * model = _modelArr[i];
                RHNavItem * item = [[RHNavItem alloc] initWithFrame:CGRectMake(originX, 0, model.itemWidth, ItemHeight) itemModel:model];
                item.tag = BtnTag + i;
                [item addTarget:self action:@selector(itemClick:) forControlEvents:UIControlEventTouchUpInside];
                [_scrollView addSubview:item];
                [self.itemArr addObject:item];
                originX += model.itemWidth;
                
                if (i == 0) {
                    
                    _lab_line.frame = CGRectMake(0, LineOriginY, model.lineWidth, LineHeight);
                    _lab_line.center = CGPointMake(item.center.x, _lab_line.center.y);
                    [self itemClick:item];
                }
            }
        }
    }
    
    #pragma mark - item event
    
    - (void)itemClick:(RHNavItem *)item{
        
        NSInteger index = item.tag - BtnTag;
        
        if ([self.delegate respondsToSelector:@selector(navView:didSelectedItemAtIndex:)]) {
            
            [self.delegate navView:self didSelectedItemAtIndex:index];
        }
        [self setScrollViewContentOffsetWithItem:item];
    }
    
    
    #pragma mark - 重写属性set方法  实现item自动切换
    
    - (void)setSelectedIndex:(NSInteger)selectedIndex {
        
        RHNavItem * item = [self viewWithTag:BtnTag + selectedIndex];
        [self setScrollViewContentOffsetWithItem:item];
    }
    
    #pragma mark - 设置item的位置
    
    - (void)setScrollViewContentOffsetWithItem:(RHNavItem *)item {
        
        NSInteger index = item.tag - BtnTag;
        RHNavItemModel * model = _modelArr[index];
        float scaleX = model.lineWidth / _lab_line.bounds.size.width;
        dispatch_async(dispatch_get_main_queue(), ^{
            
            [UIView animateWithDuration:0.25 animations:^{
                
                _lab_line.center = CGPointMake(item.center.x, _lab_line.center.y);
                _lab_line.transform = CGAffineTransformMakeScale(scaleX, 1);
            } completion:^(BOOL finished) {
                
                _lab_line.frame = CGRectMake(item.frame.origin.x + (model.itemWidth - model.lineWidth)/2, LineOriginY, model.lineWidth, LineHeight);
            }];
        });
        
        //遍历ScrollView的RHNavItem 判断如果是当前点中的item 改变其selected属性为YES  否则改为NO
        for (RHNavItem * navItem in self.itemArr) {
            
            if (navItem != item) {
                
                navItem.selected = NO;
            } else {
                
                navItem.selected = YES;
            }
        }
        
        float totalItemWidth = 0;
        for (RHNavItemModel * model in _modelArr) {
            
            totalItemWidth += model.itemWidth;
        }
        if (kScreen_W >= totalItemWidth) {
            
            return;
        }
        
        if (item.center.x - kScreen_W/2 <= 0) {
            
            [_scrollView setContentOffset:CGPointMake(0, 0) animated:YES];
            return;
        }
        
        if (item.center.x - kScreen_W/2 > 0 && _scrollView.contentSize.width - item.center.x > kScreen_W/2) {
            
            [_scrollView setContentOffset:CGPointMake(item.center.x-kScreen_W/2, 0) animated:YES];
            return;
        }
        
        if (_scrollView.contentSize.width - item.center.x <= kScreen_W/2) {
            
            [_scrollView setContentOffset:CGPointMake(_scrollView.contentSize.width - kScreen_W, 0) animated:YES];
            return;
        }
    }
    
    #pragma mark - setter and getter
    
    - (UIScrollView *)scrollView {
        
        if (!_scrollView) {
            
            UIScrollView * scrollView = [[UIScrollView alloc] init];
            
            _scrollView = scrollView;
        }
        return _scrollView;
    }
    
    - (UILabel *)lab_line {
        
        if (!_lab_line) {
           
            UILabel * label = [[UILabel alloc] init];
            _lab_line = label;
        }
        return _lab_line;
    }
    
    - (UILabel *)lab_lineH {
        
        if (!_lab_lineH) {
            
            UILabel * label = [[UILabel alloc] init];
            label.backgroundColor = [UIColor colorWithRed:220/255.0 green:220/255.0 blue:220/255.0 alpha:1];
            _lab_lineH = label;
        }
        return _lab_lineH;
    }
    
    - (NSMutableArray *)modelArr {
        
        if (!_modelArr) {
            
            _modelArr = [[NSMutableArray alloc] init];
        }
        return _modelArr;
    }
    
    - (NSMutableArray *)itemArr {
        
        if (!_itemArr) {
            
            _itemArr = [[NSMutableArray alloc] init];
        }
        return _itemArr;
    }
    
    - (void)setItemModelArr:(NSArray *)itemModelArr {
        _itemModelArr = itemModelArr;
        [self.modelArr removeAllObjects];
        [self.modelArr addObjectsFromArray:itemModelArr];
        for (int i = 0; i < _itemArr.count; i++) {
            
            RHNavItem * item = _itemArr[i];
            RHNavItemModel * model = _itemModelArr[i];
            item.titleLabel.font = model.titleFont;
            [item setTitleColor:model.normalColor forState:UIControlStateNormal];
            [item setTitleColor:model.selectColor forState:UIControlStateSelected];
            if (i == 0) {
                
                _lab_line.backgroundColor = model.selectColor;
            }
        }
    }
    @end
    

    如果看完了这个类,可以看出这里对标题的个数对应不同的布局做了简单的区分,把所有代码都拿过来了,有点繁琐,还请不要介意。

    下面是关键了,是下方滑动界面与上方标题栏相互关联的实现,这里用到了UIViewController来实现,为了能够更清晰的给大家展示如何封装,还请大家不要觉得代码繁琐,.h文件如下:

    #import <UIKit/UIKit.h>
    
    @interface RHNavController : UIViewController
    
    // navView 背景色
    @property (nonatomic, strong) UIColor * tintColor;
    // 未选中 item 字体颜色
    @property (nonatomic, strong) UIColor * itemNormalColor;
    // 选中 item 字体颜色
    @property (nonatomic, strong) UIColor * itemSelectColor;
    // item 字体大小
    @property (nonatomic, strong) UIFont * itemFont;
    // 父 vc
    @property (nonatomic, weak) UIViewController * parentController;
    // 当前选中的下标
    @property (nonatomic, assign, readonly) NSInteger selectedIndex;
    
    // vc 与 title 个数必须一致
    - (instancetype)initWithControllers:(NSArray<UIViewController *> *)controllers itemTitles:(NSArray<NSString *> *)titles;
    @end
    

    .m文件的实现:

    #import "RHNavController.h"
    #import "RHNavView.h"
    
    // 标题默认未选中颜色
    #define NORMAL_COLOR [UIColor colorWithRed:77/255.0 green:77/255.0 blue:77/255.0 alpha:1.0]
    // 标题默认选中颜色
    #define SELECT_COLOR [UIColor colorWithRed:243/255.0 green:83/255.0 blue:33/255.0 alpha:1.0]
    
    #define RHNAV_COLLECTION_CELL @"RHNav_Collection_Cell_ID"
    
    @interface RHNavController () <UICollectionViewDataSource, UICollectionViewDelegate, UICollectionViewDelegateFlowLayout, RHNavViewDelegate>
    
    @property (nonatomic, strong) NSMutableArray * controllerArr;
    @property (nonatomic, strong) NSMutableArray * modelArr;
    
    @property (nonatomic, strong) UICollectionView * collectionView;
    @property (nonatomic, strong) RHNavView * navView;
    // 是否手动拖拽collectionView
    @property (nonatomic, assign) BOOL isDrag;
    @property (nonatomic, assign) CGFloat navViewH;
    @end
    
    @implementation RHNavController
    
    - (instancetype)initWithControllers:(NSArray<UIViewController *> *)controllers itemTitles:(NSArray<NSString *> *)titles {
        
        self = [super init];
        
        if (self) {
            
            [self.controllerArr addObjectsFromArray:controllers];
            for (int i = 0; i < titles.count; i++) {
                
                RHNavItemModel * model = [[RHNavItemModel alloc] initWithTitle:titles[i] font:[UIFont systemFontOfSize:15] normalColor:NORMAL_COLOR selectColor:SELECT_COLOR];
                [self.modelArr addObject:model];
            }
        }
        return self;
    }
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        
        [self addChildViewControllers];
        [self addSubviews];
    }
    
    #pragma mark - 添加子控制器
    
    - (void)addChildViewControllers {
        
        for (int i = 0; i < self.controllerArr.count; i++) {
            
            UIViewController * vc = (UIViewController *)self.controllerArr[i];
            [self addChildViewController:vc];
        }
    }
    
    #pragma mark - add subviews
    
    - (void)addSubviews {
        
        [self.view addSubview:self.navView];
        [self.view addSubview:self.collectionView];
    }
    
    #pragma mark - navView delegate
    
    - (void)navView:(RHNavView *)navView didSelectedItemAtIndex:(NSInteger)index {
        
        _isDrag = NO;
        [_collectionView setContentOffset:CGPointMake(kScreen_W * index, 0) animated:YES];
        _selectedIndex = index;
    }
    
    #pragma mark - collectionView dataSource
    
    - (NSInteger)collectionView:(UICollectionView *)collectionView numberOfItemsInSection:(NSInteger)section {
        
        return self.controllerArr.count;
    }
    
    - (UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath {
        
        UICollectionViewCell * cell = [collectionView dequeueReusableCellWithReuseIdentifier:RHNAV_COLLECTION_CELL forIndexPath:indexPath];
        if (indexPath.row < self.controllerArr.count) {
            
            UIViewController * controller = self.controllerArr[indexPath.row];
            controller.view.frame = cell.contentView.bounds;
            [cell.contentView.subviews makeObjectsPerformSelector:@selector(removeFromSuperview)];
            [cell.contentView addSubview:controller.view];
        }
        return cell;
    }
    
    - (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout sizeForItemAtIndexPath:(NSIndexPath *)indexPath {
        
        return CGSizeMake(kScreen_W, self.view.bounds.size.height - _navViewH);
    }
    
    //翻页中,是否手动翻页都会触发
    - (void)scrollViewDidScroll:(UIScrollView *)scrollView {
        
        if (_isDrag) {
            
            if (scrollView == _collectionView) {
                
                NSInteger selectIndex = (_collectionView.contentOffset.x + kScreen_W / 2) / kScreen_W;
                _navView.selectedIndex = selectIndex;
                _selectedIndex = selectIndex;
            }
        }
    }
    //开始翻页,只有手动开始翻页才会触发的方法
    - (void)scrollViewWillBeginDragging:(UIScrollView *)scrollView {
        
        _isDrag = YES;
    }
    
    #pragma mark - setter and getter
    
    - (UICollectionView *)collectionView {
        
        if (!_collectionView) {
            
            UICollectionViewFlowLayout * flowLayout = [[UICollectionViewFlowLayout alloc] init];
            flowLayout.scrollDirection = UICollectionViewScrollDirectionHorizontal;
            //两列之间的距离
            flowLayout.minimumInteritemSpacing = 0;
            //两行之间的距离
            flowLayout.minimumLineSpacing = 0;
            
            UICollectionView * collection = [[UICollectionView alloc] initWithFrame:CGRectZero collectionViewLayout:flowLayout];
            collection.backgroundColor = [UIColor whiteColor];
            collection.dataSource = self;
            collection.delegate = self;
            //设置翻页
            collection.pagingEnabled = YES;
            //反弹
            collection.bounces = NO;
            //水平滚动条
            collection.showsHorizontalScrollIndicator = NO;
            [collection registerClass:[UICollectionViewCell class]forCellWithReuseIdentifier:RHNAV_COLLECTION_CELL];
            _collectionView = collection;
        }
        return _collectionView;
    }
    
    - (RHNavView *)navView {
        
        if (!_navView) {
            
            RHNavView * navView = [[RHNavView alloc] initWithFrame:CGRectZero itemModels:self.modelArr];
            navView.delegate = self;
            _navView = navView;
        }
        return _navView;
    }
    
    - (NSMutableArray *)controllerArr {
        
        if (!_controllerArr) {
            
            _controllerArr = [[NSMutableArray alloc] init];
        }
        return _controllerArr;
    }
    
    - (NSMutableArray *)modelArr {
        
        if (!_modelArr) {
            
            _modelArr = [[NSMutableArray alloc] init];
        }
        return _modelArr;
    }
    
    - (void)setParentController:(UIViewController *)parentController {
        
        parentController.automaticallyAdjustsScrollViewInsets = NO;
        [parentController addChildViewController:self];
        [parentController.view addSubview:self.view];
        CGFloat originY = 0;
        if (parentController.navigationController) {
            
            _navViewH = 44;
            if (parentController.navigationController.navigationBar.isTranslucent) {
                
                originY = 64;
            } else {
                
                originY = 0;
            }
        } else {
            
            _navViewH = 64;
        }
        self.navView.frame = CGRectMake(0, originY, kScreen_W, _navViewH);
        self.collectionView.frame = CGRectMake(0, _navViewH + originY, kScreen_W, self.view.bounds.size.height - _navViewH - originY);
        [self.collectionView reloadData];
    }
    
    - (void)setTintColor:(UIColor *)tintColor {
        _tintColor = tintColor;
        
        self.navView.backgroundColor = tintColor;
    }
    
    - (void)setItemNormalColor:(UIColor *)itemNormalColor {
        _itemNormalColor = itemNormalColor;
        for (RHNavItemModel * model in _modelArr) {
            
            model.normalColor = itemNormalColor;
        }
        _navView.itemModelArr = _modelArr;
    }
    
    - (void)setItemSelectColor:(UIColor *)itemSelectColor {
        _itemSelectColor = itemSelectColor;
        for (RHNavItemModel * model in _modelArr) {
            
            model.selectColor = itemSelectColor;
        }
        _navView.itemModelArr = _modelArr;
    }
    
    - (void)setItemFont:(UIFont *)itemFont {
        _itemFont = itemFont;
        for (RHNavItemModel * model in _modelArr) {
            
            model.titleFont = _itemFont;
        }
        _navView.itemModelArr = _modelArr;
    }
    @end
    

    OK,到此就封装结束了,接下来就是使用了,使用是非常的简单,只需要在需求的VC里边通过构造方法创建该控制器,并设置父VC为需求的VC即可。这里就只给大家展示一下在ViewController中的实现如下:

    #import "ViewController.h"
    #import "RHNavController.h"
    #import "FirstViewController.h"
    #import "SecondViewController.h"
    #import "ThirdViewController.h"
    #import "FourthViewController.h"
    #import "FifthViewController.h"
    #import "SixthViewController.h"
    
    @interface ViewController ()
    
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        
        self.title = @"首页";
        [self setNavController];
    }
    
    - (void)setNavController {
        
        FirstViewController * first = [[FirstViewController alloc] init];
        SecondViewController * second = [[SecondViewController alloc] init];
        ThirdViewController * third = [[ThirdViewController alloc] init];
        FourthViewController * fourth = [[FourthViewController alloc] init];
        FifthViewController * fifth = [[FifthViewController alloc] init];
        SixthViewController * sixth = [[SixthViewController alloc] init];
        
        NSArray * controllerArr = @[first, second, third, fourth, fifth, sixth];
        NSArray * titleArr = @[@"first", @"second", @"third", @"fourth", @"fifth", @"sixth"];
        RHNavController * nav = [[RHNavController alloc] initWithControllers:controllerArr itemTitles:titleArr];
    //    nav.tintColor = [UIColor lightGrayColor];
    //    nav.itemNormalColor = [UIColor whiteColor];
    //    nav.itemSelectColor = [UIColor redColor];
    //    nav.itemFont = [UIFont systemFontOfSize:17];
        nav.parentController = self;
    }
    @end
    

    总结该控件的好处就是:所有界面都是独立的,可以在相应的vc里边实现不同的布局。
    如果还有什么疑问的话可以去下载该控件的demo或者对我提问也可,我会在看到的第一时间回复。下载地址:https://github.com/guorenhao/RHNavController

    最后,还是希望能够帮助到有需要的猿友们,愿我们能够共同学习进步,在开发的道路上越走越远。谢谢!

    相关文章

      网友评论

        本文标题:iOS开发-自定制滑动容器控制器RHNavController

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