转载

开源框架VTMagic的使用介绍

本文授权转载，作者：九流书生（简书）

VTMagic

有很多开发者曾尝试模仿写出类似网易、腾讯等应用的菜单分页组件，但遍观其设计，大多都比较粗糙，不利于后续维护和扩展。琢磨良久，最终决定开源这个耗时近两年打磨而成的框架，以便大家可以快速实现类似需求，而不用把大量的精力浪费在重复造轮子的过程中，VTMagic目前在多个项目中稳定运行一年多。

特性概要

每个页面都是一个完整的控制器，友好支持个性化自定义；
页面切换时能准确触发相应的生命周期方法（viewWillAppear:等），便于管理各自页面的数据加载和其它逻辑处理；
导航栏支持多种布局样式，包括自适应文本宽度、自动平分、居中布局以及自定义宽度等；
可以在任意子控制器中，通过self.magicController获取最近的上层主控制器，方便跨层级处理逻辑；
支持内嵌webview，若滑动手势无法响应，可以通过handlePanGesture:解决；
支持页面重用和横竖屏切换；

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

开源框架VTMagic的使用介绍

预览图

使用

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

pod "VTMagic"

集成

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

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

- (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中完成相应配置。

#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 >，主要有以下三个方法:

开源框架VTMagic的使用介绍

集成效果

开源框架VTMagic的使用介绍

下划线样式

开源框架VTMagic的使用介绍

气泡样式

开源框架VTMagic的使用介绍

其它

重要协议

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

VTMagicViewDelegate协议

- (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

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

其它

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

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

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

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

或者

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

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

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

或者

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

结束语

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

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

正文到此结束

所属分类：移动开发

本文标签： Select src db2 数据 App dataSource 协议开发者需求自适应 web UI 代码 CocoaPods 配置 GitHub 开源 tar API 开发 ACE https 管理分页生命 git IDE 实例 http db
版权声明： 本文为互联网转载文章，出处已在文章中说明(部分除外)。如果侵权，请联系本站长删除，谢谢。
本文海报： 生成海报一生成海报二

其他链接

关于本站

本站定位：个人技术类博客

本站作用：写博客、记日志、闲聊扯淡鼓捣技术。

问题交流

开源框架VTMagic的使用介绍

热门推荐

相关文章

说给你听

本文目录

随机标签

书籍教程

近期评论

网站信息

其他链接

关于本站

问题交流