效果示例
这是一个控件悬停的UI效果实现,类似于网易云课堂的详情页UI效果
更新 2020 - 11 - 04
由于之前的设计对项目的侵入性太强(需要继承自代码提供的父类),导致在项目中实际应用时,很多功能限制,导致诸多不便。本次更新针对这个问题提供了一个抽象层:
- 管理类
- FMMixScrollBaseDelegateManager
将所有交互逻辑放在了这里
- FMMixScrollBaseDelegateManager
- 配置
- FMMixScrollConfig
可配置内容:
- FMMixScrollConfig
/** 传入的子控制器的数组 ps:不可变数组, 最多不要超过5个(暂不支持滑动)*/
@property (nonatomic, strong) NSArray <UIViewController *>*childVCArr;
/** 传入的UITableView 或 UICollectionView数组 ps:不可变数组, 最多不要超过5个(暂不支持滑动)*/
@property (nonatomic, strong) NSArray <UIScrollView *>*scrollTorCArr;
/** 转入的头部视图的image图片的名称 */
@property (nonatomic, strong) NSString *headImageName;
/** 是否允许headView缩放,默认NO */
@property (nonatomic, assign) BOOL isStretch;
/** 顶部图片高度 */
@property (nonatomic, assign) CGFloat headImage_H;
/** 按钮的高度 ps:宽度由按钮个数决定,平分屏幕宽度 */
@property (nonatomic, assign) CGFloat button_H;
/** bar悬停的位置 ps:默认为navigationBar + statusBar的高度 */
@property (nonatomic, assign) CGFloat barStop_H;
/** button下面指示条的颜色 */
@property (nonatomic, strong) UIColor *indicatorColor;
/** 是否隐藏指示条 */
@property (nonatomic, assign) BOOL isIndicatorHidden;
/** button的名称 */
@property (nonatomic, strong) NSArray *btnTitleArr;
/** button的选中名称 */
@property (nonatomic, strong) NSArray *btnSelectedTitleArr;
/** button的font */
@property (nonatomic, strong) UIFont *btnFont;
/** button的selected title color */
@property (nonatomic, strong) UIColor *btnSelectedTitleColor;
/** button的normal titl color*/
@property (nonatomic, strong) UIColor *btnNormalTitleColor;
/** button的背景颜色 */
@property (nonatomic, strong) UIColor *btnBackColor;
/** view 是否需要懒加载,ps:为YES时,子视图初次初始化时,若bar不在原位,会自动置回 */
@property (nonatomic, assign) BOOL shouldLazyLoad;
/// 测试使用
@property (nonatomic, assign) BOOL isTest;
项目中具体使用示例:(swift 版本)
lazy var manager: FMMixScrollBaseDelegateManager = {
// 配置类
let config = FMMixScrollConfig()
// 子controller
let processing = WBWorkRecordProcessingViewController()
processing.isMixScroll = true
let success = WBWorkRecordSuccessViewController()
success.isMixScroll = true
let failure = WBWorkRecordFailureViewController()
failure.isMixScroll = true
// 设置具体配置项
config.headImage_H = WBWorkRecordDetailHeader.H
config.childVCArr = [processing, success, failure]
config.scrollTorCArr = [processing.tableView, success.tableView, failure.tableView]
config.btnTitleArr = [
LocalizedString("wbProcessing", value: "处理中", comment: "处理中"),
LocalizedString("wbSuccess", value: "成功", comment: "成功"),
LocalizedString("wbFailure", value: "失败", comment: "失败")]
config.btnBackColor = UIColor.appWhite
let manager = FMMixScrollBaseDelegateManager(config: config, fatherController: self)
// 设置子controller的delegate为manager
processing.delegate = manager
success.delegate = manager
failure.delegate = manager
// 设置 manager的delegate为当前控制器(即父控制器)
manager.delegate = self
return manager
}()
// 实现manager的代理方法
extension WBWorkRecordDetailViewController: FMMixScrollManagerDelegate {
func currentSelectedIndex(_ index: Int) {
headerView.updateLabelTextColor(index)
}
}
1.工程引入FMBaseViewController, 并添加要自定义的controller
- 有关头部image及button的相关设置通过,FMBaseViewController的属性进行设置,示例代码如下:
FMBaseViewController *bvc = [[FMBaseViewController alloc] init];
bvc.btnBackColor = [UIColor cyanColor];
bvc.btnTitleArr = @[@"张三", @"李四", @"王五"];
bvc.indicatorColor = [UIColor yellowColor];
bvc.isIndicatorHidden = YES;
bvc.headImage_H = 100;
bvc.button_H = 30;
bvc.headImageName = @"picture_3";
bvc.isStretch = NO;
2.注意:自定义的controller 必须继承于FMBaseTableViewController.h,
- 子控制器类型1 :FMTableViewStylePlain 初始化代码如下:
FMT2ViewController *t2 = [[FMT2ViewController alloc] initWithTableViewStyle:FMTableViewStylePlain];
或者(default)
FMT1ViewController *t1 = [[FMT1ViewController alloc] init];
- 子控制器类型2:FMTableViewStyleGroup 初始化代码如下:
FMT2ViewController *t2 = [[FMT2ViewController alloc] initWithTableViewStyle:FMTableViewStyleGrouped];
或者(用属性修改)
FMT1ViewController *t2 = [[FMT1ViewController alloc] init];
t2.tableViewStyle = FMTableViewStyleGrouped;
3.头部视图是否可以拉伸:
isStretch 属性(default is YES)
- 测试效果查看,在AppDelegate.m 的launch函数中添加(或替换)如下代码:
FMBaseViewController *bvc = [[FMBaseViewController alloc] init];
self.window.rootViewController = bvc;
[self.window makeKeyAndVisible];
- 自定义子controller初始化后传入该数组childVCArr,示例代码如下:
FMBaseViewController *bvc = [[FMBaseViewController alloc] init];
FMT1ViewController *t1 = [[FMT1ViewController alloc] init];
FMT2ViewController *t2 = [[FMT2ViewController alloc] initWithTableViewStyle:FMTableViewStyleGrouped];
FMT3ViewController *t3= [[FMT3ViewController alloc] init];
bvc.childVCArr = @[t1, t2, t3];
子控制器最好不要超过5个, 暂不支持滑动(以后可能添加,敬请期待!)
- headView上的内容可自定义添加,通过 ftc.headView可拿到head部分的视图添加自己的控件。
- 支持cocoaPods 安装
pod search FMHoverScrollKit
在Podfile中添加
pod "FMHoverScrollKit"
pod install || pod update
2018.08.01更新
增加对UICollectionView的支持,controller必须继承自FMBaseCollectionViewController
*示例代码
FMT1ViewController *t1 = [[FMT1ViewController alloc] init];
t1.tableViewStyle = FMTableViewStyleGrouped;
FMC1ViewController *c1 = [[FMC1ViewController alloc] init];
FMT3ViewController *t3= [[FMT3ViewController alloc] init];
效果示例 - 全collectionView
效果示例 - collectionView 和 tableView混合
github Demo下载地址
- (第一次写简书,多多指教)