开源框架VTMagic的使用介绍

特性概要

• 每一个页面都是一个完整的控制器，友好支持个性化自定义；

• 页面切换时能准确触发相应的生命周期方法（viewWillAppear:等），便于管理各自页面的数据加载和其它逻辑处理；

• 导航栏支持多种布局样式，包括自适应文本宽度、自动平分、居中布局以及自定义宽度等；

• 能够在任意子控制器中，经过self.magicController获取最近的上层主控制器，方便跨层级处理逻辑；

• 支持内嵌webview，若滑动手势没法响应，能够经过handlePanGesture:解决；

• 支持页面重用和横竖屏切换；

更多特性请参见VTMagicView.h文件。

预览图

使用

VTMagic支持CocoaPods，只需在Podfile文件中添加以下代码便可：

1	pod "VTMagic"

集成

关于VTMagic的集成方法主要有如下两种：

1. 直接实例化VTMagicController对象，而后添加到当前控制器中。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

- (void)viewDidLoad {     [super viewDidLoad];     [self addChildViewController:self.magicController];     [self.view addSubview:_magicController.view];     [_magicController didMoveToParentViewController:self];     [_magicController.magicView reloadData]; } - (VTMagicController *)magicController {     if (!_magicController) {         _magicController = [[VTMagicController alloc] init];         _magicController.magicView.navigationColor = [UIColor whiteColor];         _magicController.magicView.sliderColor = [UIColor redColor];         _magicController.magicView.layoutStyle = VTLayoutStyleDivide;         _magicController.magicView.switchStyle = VTSwitchStyleDefault;         _magicController.magicView.navigationHeight = 40.f;         _magicController.magicView.dataSource = self;         _magicController.magicView.delegate = self;     }     return _magicController; }

2. 继承VTMagicController，而后在viewDidLoad中完成相应配置。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

#import "VTMagicController.h" @interface ViewController : VTMagicController @end @implementation ViewController - (void)viewDidLoad {     [super viewDidLoad];     self.magicView.navigationColor = [UIColor whiteColor];     self.magicView.sliderColor = [UIColor redColor];     self.magicView.layoutStyle = VTLayoutStyleDefault;     self.magicView.switchStyle = VTSwitchStyleDefault;     self.magicView.navigationHeight = 40.f;     self.magicView.dataSource = self;     self.magicView.delegate = self;     [self.magicView reloadData]; }

VTMagicViewDataSource协议

无论是经过以上哪一种方法集成的，都须要实现数据源协议< VTMagicViewDataSource >，主要有如下三个方法:

集成效果

下划线样式

气泡样式

 

 

其它

重要协议

除了数据源协议< VTMagicViewDataSource >外 ，VTMagic中的重要协议还有< VTMagicViewDelegate >和< VTMagicReuseProtocol >。前者用于在主控制器中处理页面切换事件；后者用于子控制器被重用时，清除旧数据等逻辑处理。

VTMagicViewDelegate协议

1 2 3 4 5 6 7 8 9 10 11 12

- (void)magicView:(VTMagicView *)magicView viewDidAppeare:(UIViewController *)viewController atPage:(NSUInteger)pageIndex {     NSLog(@"pageIndex:%ld viewDidAppeare:%@",pageIndex, viewController.view); } - (void)magicView:(VTMagicView *)magicView viewDidDisappeare:(UIViewController *)viewController atPage:(NSUInteger)pageIndex {     NSLog(@"pageIndex:%ld viewDidDisappeare:%@",pageIndex, viewController.view); } - (void)magicView:(VTMagicView *)magicView didSelectItemAtIndex:(NSUInteger)itemIndex {     NSLog(@"didSelectItemAtIndex:%ld", (long)itemIndex); }

VTMagicReuseProtocol

1 2 3 4

- (void)vtm_prepareForReuse {     NSLog(@"clear old data if needed:%@", self); }

其它

• 你能够在任意子控制器中，经过self.magicController获取最近的上层主控制器，magicController遵循协议< VTMagicProtocol >，以便完成一些必要的跨层级的逻辑处理，前提是你须要import文件。

1 2	NSInteger currentPage = self.magicController.currentPage; UIViewController *viewController = self.magicController.currentViewController;

• 切换到指定页面，页面切换有两种方式：

1	[self.magicView switchToPage:3 animated:YES];

或者

1	[self.magicController switchToPage:3 animated:YES];

• 获取指定页面控制器，一样有两种方式：

1	UIViewController *viewController = [self.magicView viewControllerAtPage:3];

或者

1	UIViewController *viewController = [self.magicController viewControllerAtPage:3];

结束语

最后，按照惯例，若是你喜欢这个轮子，请留下一颗star，也欢迎你们扩散，这是对做者最大的鼓励和支持，拜谢！！！

GitHub地址：https://github.com/tianzhuo112/VTMagic