当前位置：首页 > news >正文

如何在iOS应用中快速集成WMPageController：10分钟入门教程

news 2026/7/17 14:11:39

如何在iOS应用中快速集成WMPageController：10分钟入门教程

【免费下载链接】WMPageControllerAn easy solution to page controllers like NetEase News项目地址: https://gitcode.com/gh_mirrors/wm/WMPageController

WMPageController是一个轻量级的iOS页面控制器解决方案，类似于网易新闻的页面切换效果。它提供了简洁的API和灵活的配置选项，让开发者能够快速实现滑动切换页面的功能，提升用户体验。无论是新闻类应用、电商平台还是内容展示类App，WMPageController都能帮助你轻松构建专业的分页界面。

🌟 WMPageController核心功能介绍

WMPageController作为一款高效的iOS页面控制器，主要特点包括：

流畅的滑动体验：实现了类似网易新闻的左右滑动切换页面效果
灵活的菜单配置：支持多种菜单样式和动画效果
智能缓存机制：提供多种缓存策略，优化内存使用
预加载功能：可配置预加载相邻页面，提升用户体验
高度可定制：支持自定义标题样式、进度条、菜单布局等

📋 准备工作

在开始集成WMPageController之前，请确保你的开发环境满足以下要求：

iOS 8.0+ 系统版本
Xcode 8.0+ 开发环境
Objective-C 语言基础

首先，通过以下命令克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/wm/WMPageController

🚀 快速集成步骤

1. 添加核心文件到项目

将以下核心文件添加到你的iOS项目中：

WMPageController/WMPageController.h
WMPageController/WMPageController.m
WMPageController/WMMenuView/目录下的所有文件

2. 导入头文件

在需要使用WMPageController的视图控制器中导入头文件：

#import "WMPageController.h"

3. 实现数据源方法

WMPageController需要实现两个必须的数据源方法来定义菜单和内容视图的布局：

// 设置内容视图的frame - (CGRect)pageController:(WMPageController *)pageController preferredFrameForContentView:(WMScrollView *)contentView { return CGRectMake(0, 64, self.view.bounds.size.width, self.view.bounds.size.height - 64); } // 设置菜单视图的frame - (CGRect)pageController:(WMPageController *)pageController preferredFrameForMenuView:(WMMenuView *)menuView { return CGRectMake(0, 20, self.view.bounds.size.width, 44); }

4. 创建并配置WMPageController

使用初始化方法创建WMPageController实例，并设置必要的属性：

// 定义子控制器类和标题 NSArray *classes = @[[FirstViewController class], [SecondViewController class], [ThirdViewController class]]; NSArray *titles = @[@"首页", @"发现", @"我的"]; // 创建WMPageController实例 WMPageController *pageController = [[WMPageController alloc] initWithViewControllerClasses:classes andTheirTitles:titles]; // 设置代理和数据源 pageController.delegate = self; pageController.dataSource = self; // 配置菜单样式 pageController.menuViewStyle = WMMenuViewStyleLine; pageController.titleColorSelected = [UIColor redColor]; pageController.titleColorNormal = [UIColor blackColor]; pageController.titleSizeSelected = 18; pageController.titleSizeNormal = 16; // 添加到当前控制器 [self addChildViewController:pageController]; [self.view addSubview:pageController.view]; [pageController didMoveToParentViewController:self];

⚙️ 常用配置选项

WMPageController提供了丰富的配置选项，让你可以根据应用需求定制页面效果：

缓存策略

// 设置缓存策略，默认为无限制 pageController.cachePolicy = WMPageControllerCachePolicyBalanced;

缓存策略包括：

WMPageControllerCachePolicyDisabled- 禁用缓存
WMPageControllerCachePolicyNoLimit- 无限制缓存
WMPageControllerCachePolicyLowMemory- 低内存模式
WMPageControllerCachePolicyBalanced- 平衡模式
WMPageControllerCachePolicyHigh- 高缓存模式

预加载策略

// 设置预加载策略 pageController.preloadPolicy = WMPageControllerPreloadPolicyNear;

预加载策略包括：

WMPageControllerPreloadPolicyNever- 不预加载
WMPageControllerPreloadPolicyNeighbour- 预加载相邻页面
WMPageControllerPreloadPolicyNear- 预加载附近2个页面

菜单外观定制

// 设置进度条颜色 pageController.progressColor = [UIColor blueColor]; // 设置进度条高度 pageController.progressHeight = 3; // 设置菜单项间距 pageController.itemMargin = 15; // 设置菜单项宽度 pageController.menuItemWidth = 80;

🎯 实际应用示例

以下是一个完整的WMPageController集成示例，展示了如何在实际项目中使用：

#import "WMPageController.h" #import "FirstViewController.h" #import "SecondViewController.h" #import "ThirdViewController.h" @interface MainViewController () <WMPageControllerDataSource, WMPageControllerDelegate> @property (nonatomic, strong) WMPageController *pageController; @end @implementation MainViewController - (void)viewDidLoad { [super viewDidLoad]; // 初始化页面控制器 [self setupPageController]; } - (void)setupPageController { // 定义子控制器和标题 NSArray *classes = @[[FirstViewController class], [SecondViewController class], [ThirdViewController class]]; NSArray *titles = @[@"首页", @"发现", @"我的"]; // 创建页面控制器 self.pageController = [[WMPageController alloc] initWithViewControllerClasses:classes andTheirTitles:titles]; self.pageController.delegate = self; self.pageController.dataSource = self; // 配置页面控制器 self.pageController.menuViewStyle = WMMenuViewStyleLine; self.pageController.titleColorSelected = [UIColor colorWithRed:255/255.0 green:70/255.0 blue:70/255.0 alpha:1.0]; self.pageController.titleColorNormal = [UIColor colorWithRed:102/255.0 green:102/255.0 blue:102/255.0 alpha:1.0]; self.pageController.titleSizeSelected = 17; self.pageController.titleSizeNormal = 15; self.pageController.progressColor = self.pageController.titleColorSelected; self.pageController.progressHeight = 2; self.pageController.itemMargin = 15; self.pageController.cachePolicy = WMPageControllerCachePolicyBalanced; self.pageController.preloadPolicy = WMPageControllerPreloadPolicyNeighbour; self.pageController.selectIndex = 0; // 添加到当前视图 [self addChildViewController:self.pageController]; [self.view addSubview:self.pageController.view]; self.pageController.view.frame = self.view.bounds; [self.pageController didMoveToParentViewController:self]; } #pragma mark - WMPageControllerDataSource - (CGRect)pageController:(WMPageController *)pageController preferredFrameForContentView:(WMScrollView *)contentView { return CGRectMake(0, 64, self.view.bounds.size.width, self.view.bounds.size.height - 64); } - (CGRect)pageController:(WMPageController *)pageController preferredFrameForMenuView:(WMMenuView *)menuView { return CGRectMake(0, 20, self.view.bounds.size.width, 44); } #pragma mark - WMPageControllerDelegate - (void)pageController:(WMPageController *)pageController didEnterViewController:(__kindof UIViewController *)viewController withInfo:(NSDictionary *)info { NSLog(@"进入页面: %@", info[@"title"]); // 可以在这里进行页面进入时的操作 } @end