树状结构LLTreeTableViewController使用

2023-01-09 本文已影响0人一个小白iOS

项目中我们会遇到大量的树状列表，每个页面需要的数据和风格样式也不尽相同，新增一个页面就会进行大量的代码复制。所以我们自己封装一个树状列表控件，适配所有页面。

包含功能如下：

多级列表
折叠/展开
单选多选
一键展开 / 折叠 N 级列表
一键勾选 / 取消勾选

使用

创建视图控制器继承我们的 LLTreeTableViewController

image.png
遵守协议 LLTreeTableViewControllerParentClassDelegate
实现对应的协议方法并赋予数据

image.png

- (void)loadData {
    
    MBProgressHUD *toastHUD = [[MBProgressHUD alloc] initWithView:self.navigationController ? self.navigationController.view : self.view];
    toastHUD.backgroundView.style = MBProgressHUDBackgroundStyleSolidColor;
    toastHUD.backgroundView.color = [UIColor colorWithWhite:0.f alpha:.2f];
    toastHUD.label.text = @"加载中";
    toastHUD.removeFromSuperViewOnHide = YES;
    toastHUD.userInteractionEnabled = YES;
    [toastHUD showAnimated:YES];
    if (self.navigationController) {
        [self.navigationController.view addSubview:toastHUD];
    }
    else{
        [self.view addSubview:toastHUD];
    }

    
    
    
    WeakSelf(self);
    StrongSelf(weakSelf);
    LinPropertyScopeReleaseParamsModel *param = [LinPropertyScopeReleaseParamsModel new];
    param.neighNo = kPropertyCurrentNeighMd.neighNo;
    param.applyNo = self.applyNo;
    param.applyType = self.applyType;
    param.applyNoFrom = self.applyNoFrom;
    
    [LinPropertyHttpCloudUtils requestScopeReleaseTreeWithModel:param success:^(id  _Nullable task, LinIOTBaseResponseModel * _Nullable response, NSInteger result) {
        
        NSArray *treeModelArray = [LinScopeReleaseTreeModel objectArrayWithDictArray:response.params];
        
        strongSelf.manager = [strongSelf getTreeDataWithTreeModel:treeModelArray];

        [toastHUD hideAnimated:YES];
        
    } failure:^(id  _Nullable task, NSError * _Nullable error, NSInteger result, NSString * _Nonnull message) {
        
        strongSelf.manager = [strongSelf getTreeDataWithTreeModel:@[]];
        
        [toastHUD hideAnimated:YES];
    }];
    
}

数据创建
主要思路：将表格中的每一行需要显示的数据，封装成item模型，存放在数组当中，然后再将数组数据初始化给LLTreeTableManager类即可。

- (LLTreeTableManager *)getManagerOfCraft {

    // 获取数据并创建树形结构
    NSData *JSONData = [NSData dataWithContentsOfFile:[[NSBundle mainBundle] pathForResource:@"Resource" ofType:@"json"]];
    NSArray *dataArray = [NSJSONSerialization JSONObjectWithData:JSONData options:NSJSONReadingAllowFragments error:nil];

    NSMutableSet *items = [NSMutableSet set];


    [dataArray enumerateObjectsUsingBlock:^(NSDictionary *data, NSUInteger idx, BOOL * _Nonnull stop) {
        LLTreeItem *item = [[LLTreeItem alloc] initWithName:data[@"name"]
                                                         ID:[NSString stringWithFormat:@"%@", data[@"id"]]
                                                   parentID:[NSString stringWithFormat:@"%@", data[@"pid"]]
                                                    orderNo:[NSString stringWithFormat:@"%lu", (unsigned long)idx]
                                                       type:@"test"
                                                     isLeaf:NO
                                                       data:data];
        [items addObject:item];
    }];

    // ExpandLevel 为 0 全部折叠，为 1 展开一级，以此类推，为 NSIntegerMax 全部展开
    LLTreeTableManager *manager = [[LLTreeTableManager alloc] initWithItems:items andExpandLevel:NSIntegerMax];

    return manager;
}

- (LLTreeTableManager *)getManagerOfCity {

    // 获取数据并创建树形结构
    NSData *JSONData = [NSData dataWithContentsOfFile:[[NSBundle mainBundle] pathForResource:@"cityResource" ofType:@"json"]];
    NSArray *provinceArray = [NSJSONSerialization JSONObjectWithData:JSONData options:NSJSONReadingAllowFragments error:nil];

    NSMutableSet *items = [NSMutableSet set];

    // 1. 遍历省份
    [provinceArray enumerateObjectsUsingBlock:^(NSDictionary *province, NSUInteger idx, BOOL * _Nonnull stop) {

        LLTreeItem *provinceItem = [[LLTreeItem alloc] initWithName:province[@"name"]
                                                                 ID:province[@"code"]
                                                           parentID:nil
                                                            orderNo:[NSString stringWithFormat:@"%lu", (unsigned long)idx]
                                                               type:@"province"
                                                             isLeaf:NO
                                                               data:province];
        [items addObject:provinceItem];

        // 2. 遍历城市
        NSArray *cityArray = province[@"children"];
        [cityArray enumerateObjectsUsingBlock:^(NSDictionary *city, NSUInteger idx, BOOL * _Nonnull stop) {

            LLTreeItem *cityItem = [[LLTreeItem alloc] initWithName:city[@"name"]
                                                                 ID:city[@"code"]
                                                           parentID:provinceItem.ID
                                                            orderNo:[NSString stringWithFormat:@"%lu", (unsigned long)idx]
                                                               type:@"city"
                                                             isLeaf:NO
                                                               data:city];
            [items addObject:cityItem];

            // 3. 遍历区
            NSArray *districtArray = city[@"children"];
            [districtArray enumerateObjectsUsingBlock:^(NSDictionary *district, NSUInteger idx, BOOL * _Nonnull stop) {

                LLTreeItem *districtItem = [[LLTreeItem alloc] initWithName:district[@"name"]
                                                                         ID:district[@"code"]
                                                                   parentID:cityItem.ID
                                                                    orderNo:[NSString stringWithFormat:@"%lu", (unsigned long)idx]
                                                                       type:@"district"
                                                                     isLeaf:YES
                                                                       data:district];
                [items addObject:districtItem];
            }];
        }];
    }];

    // ExpandLevel 为 0 全部折叠，为 1 展开一级，以此类推，为 NSIntegerMax 全部展开
    LLTreeTableManager *manager = [[LLTreeTableManager alloc] initWithItems:items andExpandLevel:0];


    return manager;
}

4.树状结构包含的属性以及方法使用

属性

@property (nonatomic, strong) LLTreeTableManager *manager;

@property (nonatomic, assign) BOOL isShowExpandedAnimation;   // 是否显示展开/折叠动画，默认 YES
@property (nonatomic, assign) BOOL isShowArrowIfNoChildNode;  // 是否没有子节点就不显示箭头，默认 NO
@property (nonatomic, assign) BOOL isShowArrow;               // 是否显示文字前方的箭头图片，默认 YES
@property (nonatomic, assign) BOOL isShowCheck;               // 是否显示文字后方的勾选框，默认 YES
@property (nonatomic, assign) BOOL isSingleCheck;             // 是否是单选，默认 NO
@property (nonatomic, assign) BOOL isCancelSingleCheck;       // 是否单选时再次点击取消选择，默认 NO
@property (nonatomic, assign) BOOL isExpandCheckedNode;       // 是否展开已选择的节点，默认 YES
@property (nonatomic, assign) BOOL isShowLevelColor;          // 是否展示层级颜色，默认 YES
@property (nonatomic, assign) BOOL isShowSearchBar;           // 是否显示搜索框，默认 YES
@property (nonatomic, assign) BOOL isSearchRealTime;          // 是否实时查询，默认 YES

@property (nonatomic, strong) NSArray <NSString *>*checkItemIds;    // 从外部传进来的所选择的 itemIds
@property (nonatomic, strong) NSArray <UIColor *>*levelColorArray;  // 层级颜色，默认一级和二级分别为深灰色和浅灰色
@property (nonatomic, strong) UIColor *normalBackgroundColor;       // 默认背景色，默认为白色
@property (nonatomic, assign) BOOL isEnableEdit; //是否可以编辑 默认可以编辑

属性使用

    self.isShowExpandedAnimation  = YES; //是否显示展开/折叠动画
    self.isShowArrowIfNoChildNode = YES; // 是否没有子节点就不显示箭头，默认 NO
    self.isShowArrow              = YES; // 是否显示文字前方的箭头图片，默认 YES
    self.isShowCheck              = YES; // 是否显示文字后方的勾选框，默认 YES
    self.isSingleCheck            = NO;  // 是否是单选，默认 NO
    self.isCancelSingleCheck      = NO;  // 是否单选时再次点击取消选择，默认 NO
    self.isExpandCheckedNode      = YES; // 是否展开已选择的节点，默认 YES
    self.isShowLevelColor         = NO;  // 是否展示层级颜色，默认 YES
    self.isShowSearchBar          = NO;
    self.isEnableEdit = NO;     //是否可以编辑 默认可以编辑

协议实现

#pragma mark - LLTreeTableViewControllerParentClassDelegate
//数据源
- (void)refreshTableViewController:(LLTreeTableViewController *)tableViewController {
    [self loadData];
}

- (void)tableViewController:(LLTreeTableViewController *)tableViewController checkItems:(NSArray<LLTreeItem *> *)items {
    // 这里加一个隔离带目的是可以在这里做出个性化操作，然后再将数据传出
    if ([self.delegate respondsToSelector:@selector(tableViewController:checkItems:)]) {
        [self.delegate tableViewController:self checkItems:items];
    }
    
    [self.navigationController popViewControllerAnimated:YES];
}

- (void)tableViewController:(LLTreeTableViewController *)tableViewController didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
    NSLog(@"点击了第 %ld 行", (long)indexPath.row);
}

- (void)tableViewController:(LLTreeTableViewController *)tableViewController didSelectCheckBoxRowAtIndexPath:(NSIndexPath *)indexPath {
    NSLog(@"点击了第 %ld 行的 checkbox", (long)indexPath.row);
}

方法

/** 全部勾选/全部取消勾选 */
- (void)checkAllItem:(BOOL)isCheck;
/** 全部展开/全部折叠 */
- (void)expandAllItem:(BOOL)isExpand;
/** 展开/折叠到多少层级 */
- (void)expandItemWithLevel:(NSInteger)expandLevel;
/** 准备提交，调用代理方法 */
- (void)prepareCommit;
/** 获取当前显示的 showItems */
- (NSArray *)getShowItems;
/** 获取所有的 Items */
- (NSArray *)getAllItems;
/** 获取所有勾选的 Items */
- (NSArray *)getCheckItems;

方法的使用

//提交
- (void)commitItemClick {
    [self prepareCommit];
}

//全选
- (void)allCheckItemClick {
    [self checkAllItem:YES];
}

//全部展开
- (void)allExpandItemClick {
    [self expandAllItem:YES];
}

树状结构LLTreeTableViewController使用

项目中我们会遇到大量的树状列表，每个页面需要的数据和风格样式也不尽相同，新增一个页面就会进行大量的代码复制。所以我们自己封装一个树状列表控件，适配所有页面。

使用

猜你喜欢

热点阅读