HSSetTableViewController 1.3.1

HSSetTableViewController 1.3.1

×

TestsTested ✗
LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Nov 2017

Maintained by hushaohui.

HSSetTableViewController 1.3.1

  • By
  • hushaohui

最好用的设置界面和个人信息框架，上至分割线，下到箭头，标题，详细标题，富文本标题等等统统可配置，可更新，你无须判断indexPath.row。也无须纠结如何更新cell，HSSetTableViewController一行代码帮你搞定！100%App都能用到!!目前版本已经升级到1.2.2版本，增加了界面分类功能，你的UIViewController只需要导入UIViewController+HSSetTableView即可。目前支持继承和分类两种实现方式，建议使用分类！

  • 本库优势：
    1. 支持标题，详细文本配置，分割线自定义，箭头自定义，适配不同App风格。
    2. 支持cell右边文本更新，高度内部计算。支持横竖屏自动适应文本高度。
    3. 支持cell右边图片下载，和图片大小以及圆角设置。
    4. 支持标题，详细富文本配置。
    5. 支持自定义cell和模型
    6. 支持所有cell动态更新内容。

Features

  • [x] 支持最基本cell(左边标题，右边箭头)
  • [x] 支持右边文本cell(左边标题，右边文本，文本属性可配置，高度内部自适应)
  • [x] 支持开关cell(左边标题，右边switch)
  • [x] 支持图片cell(左边标题，右边图片)
  • [x] 支持cell点击以及其它控件事件回调
  • [x] 支持自定义cell和cell事件
  • [x] 代码手动布局，横屏竖屏均适配

Requirements

  • Xcode 7.0以上

Architecture

Main

  • HSBaseCellModel
  • HSImageCellModel
  • HSSwitchCellModel
  • HSTitleCellModel
  • HSTextCellModel
  • HSCustomCellModel
  • HSTitleTableViewCell
  • HSBaseTableViewCell
  • HSImageTableViewCell
  • HSSwitchTableViewCell
  • HSTextTableViewCell
  • HSCustomTableViewCell
  • HSSetTableViewMainController

Category

  • NSArray+HSSafeAccess
  • NSBundle+HSImage
  • NSBundle+HSImage
  • UIColor+HSExtension
  • UIView+HSFrame

Manager

  • HSSetTableViewManager
  • UIViewController+HSSetTableView

Architecture

Renderings

How to use

  • 使用 CocoaPods: 请先安装cocoapods,如果版本太老无法找到,请升级cocopods到最新版本 命令：pod repo update
    • pod 'HSSetTableViewController','~> 1.2.1'
    • 导入头文件：#import <UIViewController+HSSetTableView>或者#import <HSSetTableViewController.h>
  • 直接导入：
    • 拖动 HSSetTableViewController 文件夹以及SDWebImage到你工程目录。
    • 导入头文件：#import "UIViewController+HSSetTableView"或者#import "HSSetTableViewController.h"
  • 使用方法:

    • 分类：你的UIViewController只需要调用初始化方法- (void)initSetTableViewConfigure或者
      - (void)initSetTableViewConfigureWithSectionFooter:(NSArray<UIView *> *)footerViewArry footerHeight:(NSArray<NSNumber *> *)footerHeightArry

    • 继承：你的UIViewController只需要继承基类HSSetTableViewMainController即可

Details (See the example program HSSetTableViewControllerDemo for details)

    //如果是分类，初始化tableView配置。继承则不需要设置
    [self initSetTableViewConfigure];
    
    // 1.创建cell title模型
     HSTitleCellModel *cell1 = [[HSTitleCellModel alloc] initWithTitle:@"相册" actionBlock:^(HSBaseCellModel *model) {
        HSLog(@"点击相册")
    }];
    photo.icon = [UIImage imageNamed:@"MoreMyAlbum"];
    // 2. 创建右边文本显示cell（文本高度自适应）
    HSTextCellModel *cell2 = [[HSTextCellModel alloc] initWithTitle:@"文本更新" detailText:@"加班加到口吐二两鲜血" actionBlock:^(HSBaseCellModel *model) {
        NSLog(@"文本cell点击事件");
    }];
    // 3. 创建右边显示开关cell
    HSSwitchCellModel *cell3 = [[HSSwitchCellModel alloc] initWithTitle:@"开关控制" switchType:YES switchBlock:^(HSBaseCellModel *model, BOOL on) {
        NSLog(@"开关控制 --%d",on);
    }];
    //4.图片cell
    UIImage *placeHolder = [UIImage imageNamed:@"ic_icon_header"];
    HSImageCellModel *cell4 = [[HSImageCellModel alloc] initWithTitle:@"图片" placeholderImage:placeHolder imageUrl:@"http://scimg.jb51.net/170405/2-1F40522332a13.jpg" actionBlock:^(HSBaseCellModel *model) {
        
    } imageBlock:^{
        
    }];
    cell4.controlRightOffset = 40;
    cell4.showArrow = YES;
    
    //5.自定义cell（HSHeaderCellModel必须继承HSCustomCellModel，HSHeaderTableViewCell必须继承HSZhiHuCustomTableViewCell,cellellIdentifier为自定义model绑定的自定义cell，一样的cellellIdentifier说明cell类型是一样，如有不理解请阅读demo）
    __weak __typeof(&*self)weakSelf = self;
    HSHeaderCellModel *header = [[HSHeaderCellModel alloc] initWithCellIdentifier:@"HSHeaderTableViewCell" actionBlock:^(HSBaseCellModel *model) {
        HSHeaderCellModel *hederModel = (HSHeaderCellModel *)model;
        hederModel.text = @"奔跑吧,兄弟";
        [weakSelf updateCellModel:hederModel];
    }];
    header.text = @"天霸动霸tuo";
    header.cellHeight = 100;
    
    //5.添加到数据源
    NSMutableArray *section0 = [NSMutableArray arrayWithObjects:header,cell1,cell2, cell3,cell4,nil];
    [self.hs_dataArry addObject:section0];
    [self.hs_tableView reloadData];
   
   //6.更新每个cellModel属性后，只需要调用完成刷新
   [self updateCellModel:cell4];

Warning

  • 因为涉及到更新问题，添加到数据源的形式请使用NSMutableArray，不要使用NSArray存放。
  • 不是把cell模型直接放入基类数据源，是先放入NSMutableArray的形式。再用self.hs_dataArry添加NSMutableArray。

Hope

  • 如果有任何问题，你可以 issues me!
  • 后续将会对cell扩展和配置，希望能支持更多的主流App.
  • 希望能给更多童鞋带来开发的方便，可以一起讨论，如果你喜欢请给个star。