iOS开发者必备！WMZPageController 10分钟快速集成教程：从安装到基础使用

iOS开发者必备！WMZPageController 10分钟快速集成教程：从安装到基础使用

【免费下载链接】WMZPageController分页控制器,替换UIPageController方案,具备完整的生命周期,多种指示器样式,多种标题样式,可悬浮,支持ios13暗黑模式(仿优酷,爱奇艺,今日头条,简书,京东等多种标题菜单) (Pagination controller with full life cycle, multiple indicator styles, multiple title styles)项目地址: https://gitcode.com/gh_mirrors/wm/WMZPageController

WMZPageController是一款高性能iOS分页控制器，作为UIPageController的完美替代方案，它具备完整的生命周期管理、多种指示器样式、丰富的标题样式以及悬浮功能，能轻松实现优酷、爱奇艺、今日头条等主流App的标题菜单效果。本文将带你10分钟内完成从安装到基础使用的全过程，让你的App轻松拥有专业级分页体验。

为什么选择WMZPageController？🌟

作为iOS开发者，你是否曾被UIPageController的内存占用问题和手势冲突所困扰？WMZPageController通过UIScrollView实现分页逻辑，不仅完美解决了系统控件的缺陷，还带来了更多实用功能：

• 完整生命周期：子控制器/视图支持viewWillAppear、viewDidAppear等标准生命周期方法
• 多样化样式：提供AQY、PDD、TT、JD等多种动画样式，满足不同App风格需求
• 灵活悬浮效果：支持导航栏透明度变化、头部放大、固定底部等多种悬浮模式
• 无依赖集成：纯原生代码实现，无需额外第三方库支持
• 链式语法：优雅的API设计，一行代码即可完成复杂配置

准备工作：环境要求与安装指南 📦

系统要求

• iOS 9.0+
• Xcode 9.0+

安装方式

方式一：CocoaPods（推荐）

1. 确保CocoaPods已更新至最新版本
2. 在Podfile中添加：

   pod 'WMZPageController'

3. 执行pod install或pod update
4. 导入头文件：#import "WMZPageController.h"

方式二：手动安装

1. 克隆仓库：git clone https://gitcode.com/gh_mirrors/wm/WMZPageController
2. 将WMZPageController/WMZPageController目录下的源文件添加到工程
3. 导入头文件：#import "WMZPageController.h"

快速上手：10分钟实现基础分页功能 ⚡

步骤1：创建配置参数

WMZPageController使用WMZPageParam对象管理所有配置，支持链式语法和常规语法两种方式：

// 链式语法（推荐） WMZPageParam *param = PageParam() .wTitleArrSet(@[@"推荐",@"视频",@"资讯",@"我的"]) .wViewController = ^UIViewController * _Nullable(NSInteger index) { // 返回对应索引的子控制器 return [TestVC new]; } .wTopSuspensionSet(YES); // 启用悬浮功能

步骤2：初始化分页控制器

WMZPageController *pageVC = [[WMZPageController alloc] initWithParam:param]; [self.navigationController pushViewController:pageVC animated:YES];

步骤3：实现悬浮协议（可选）

如果需要使用悬浮功能，子控制器需实现WMZPageProtocol协议：

// 在子控制器中实现 - (UIScrollView*)getMyScrollView { return self.tableView; // 返回需要参与悬浮计算的滚动视图 }

核心功能解析：让分页更强大 🚀

标题样式自定义

WMZPageController支持丰富的标题样式，通过字典配置可实现红点提示、图文混合等效果：

param.wTitleArr = @[ @{WMZPageKeyName:@"推荐", WMZPageKeyBadge:@(YES)}, // 带红点 @{WMZPageKeyName:@"视频", WMZPageKeyImage:@"video_icon"}, // 图文混合 @{WMZPageKeyName:@"资讯", WMZPageKeyTitleColor:[UIColor grayColor]} // 自定义颜色 ];

常用动画效果

框架内置多种流行App的动画样式，只需一行代码即可切换：

// 设置动画样式为今日头条风格 param.wAnimalTypeSet(WMZPageAnimalToutiao);

生命周期管理

子控制器可通过实现协议方法获得完整的生命周期回调：

- (void)pageViewWillAppear { NSLog(@"页面即将显示"); } - (void)pageViewDidDisappear { NSLog(@"页面已经消失"); }

常见问题解决 💡

Q1：设置悬浮后底部无法滑动？

A：检查子控制器是否实现WMZPageProtocol协议并正确返回滚动视图，同时确保没有覆盖库内的滑动代理方法。

Q2：如何调整整体布局偏移？

A：使用以下属性自定义布局参数：

// 调整距离顶部位置 param.wCustomNaviBarYSet(^CGFloat(CGFloat nowY) { return nowY + 20; // 增加20pt偏移 });

Q3：如何动态更新标题数据？

A：更新标题数组后调用updateTitle方法：

param.wTitleArr = @[@"新标题1",@"新标题2"]; [pageVC updateTitle];

进阶学习资源 📚

• 完整API文档：WMZPageController/WMZPageParam.h
• 示例代码：DemoVC/UseDemo/全部属性/AllPropertiesVC.m
• 特殊效果实现：DemoVC/UseDemo/复杂使用/淘宝/WMZTaoBaoDemo.m

WMZPageController凭借其丰富的功能和简洁的API，已成为iOS分页控制器的理想选择。无论是简单的标签页切换还是复杂的嵌套悬浮效果，都能轻松实现。现在就集成到你的项目中，为用户带来更流畅的分页体验吧！

【免费下载链接】WMZPageController分页控制器,替换UIPageController方案,具备完整的生命周期,多种指示器样式,多种标题样式,可悬浮,支持ios13暗黑模式(仿优酷,爱奇艺,今日头条,简书,京东等多种标题菜单) (Pagination controller with full life cycle, multiple indicator styles, multiple title styles)项目地址: https://gitcode.com/gh_mirrors/wm/WMZPageController