iOS开发--仿新闻首页效果WMPageController的使用详解_IOS开发教程-查字典教程网
iOS开发--仿新闻首页效果WMPageController的使用详解
iOS开发--仿新闻首页效果WMPageController的使用详解
发布时间:2016-12-28 来源:查字典编辑
摘要:这一篇记录的是iOS开发中第三方库WMPageController控件的使用方法,主要是用来分页显示内容的,可以通过手势滑动来切换页面,也可...

这一篇记录的是iOS开发中第三方库WMPageController控件的使用方法,主要是用来分页显示内容的,可以通过手势滑动来切换页面,也可以通过点击标题部分来切换页面,如下图所示:

使用方法:

新建工程DemoTest1,然后通过cocoapods引入WMPageController到项目中,Podfile文件的内容如下:

platform :ios,'7.0' target 'DemoTest1' do pod 'WMPageController', '~> 1.6.4' end

方法一:

(1)创建几个ViewController继承自UIViewController测试用:

(2)打开AppDelegate.m文件,在其中加入下面一个方法:

#import "WMPageController.h" #import "OneViewController.h" #import "ViewController.h" #import "TwoViewController.h" @interface AppDelegate () @property(nonatomic,strong) WMPageController *createPages; @end @implementation AppDelegate - (WMPageController *)createPages { //WMPageController中包含的页面数组 NSArray *controllers = [NSArray arrayWithObjects:[ViewController class], [OneViewController class],[TwoViewController class], nil]; //WMPageController控件的标题数组 NSArray *titles = [NSArray arrayWithObjects:@"体育新闻", @"娱乐新闻",@"直播新闻", nil]; //用上面两个数组初始化WMPageController对象 WMPageController *pageController = [[WMPageController alloc] initWithViewControllerClasses:controllers andTheirTitles:titles]; pageController.menuViewStyle = WMMenuViewStyleLine; pageController.titleColorSelected = [UIColor whiteColor]; pageController.titleColorNormal = [UIColor colorWithRed:168.0/255.0 green:20.0/255.0 blue:4/255.0 alpha:1]; pageController.progressColor = [UIColor colorWithRed:168.0/255.0 green:20.0/255.0 blue:4/255.0 alpha:1]; // pageController.itemsWidths = @[@(70),@(100),@(70)]; // 这里可以设置不同的宽度 //设置WMPageController每个标题的宽度 pageController.menuItemWidth = 375/3; //设置WMPageController标题栏的高度 pageController.menuHeight = 35; //设置WMPageController选中的标题的颜色 pageController.titleColorSelected = [UIColor colorWithRed:200 green:0 blue:0 alpha:1]; return pageController; } - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds]; WMPageController *page = [self createPages]; UINavigationController *na = [[UINavigationController alloc] initWithRootViewController:page]; self.window.rootViewController = na; [self.window makeKeyAndVisible]; return YES; }

方法二:

(1)创建个ViewController继承自WMPageController

(2)编辑ViewController.m文件,代码如下:

初始化设置:

#import "TwoViewController.h" #import "OneViewController.h" #import "TableViewController.h" #import "ThreeViewController.h" @interface ThreeViewController () @property (nonatomic, strong) NSArray *titleData; @end @implementation ThreeViewController #pragma mark 标题数组 - (NSArray *)titleData { if (!_titleData) { _titleData = @[@"单曲", @"详情", @"歌词",@"歌词"]; } return _titleData; } #pragma mark 初始化代码 - (instancetype)init { if (self = [super init]) { self.titleSizeNormal = 15; self.titleSizeSelected = 15; self.menuViewStyle = WMMenuViewStyleLine; self.menuItemWidth = [UIScreen mainScreen].bounds.size.width / self.titleData.count; self.menuHeight = 50; } return self; }

WMPageController --Datasource & Delegate

#pragma mark - Datasource & Delegate #pragma mark 返回子页面的个数 - (NSInteger)numbersOfChildControllersInPageController:(WMPageController *)pageController { return self.titleData.count; } #pragma mark 返回某个index对应的页面 - (UIViewController *)pageController:(WMPageController *)pageController viewControllerAtIndex:(NSInteger)index { switch (index) { case 0:{ TwoViewController *vcClass = [[TwoViewController alloc] init]; vcClass.title = @"1"; return vcClass; } break; case 1:{ OneViewController *vcClass = [OneViewController new]; vcClass.title = @"2"; return vcClass; } break; case 2:{ TableViewController *vcClass = [TableViewController new]; vcClass.title = @"3"; return vcClass; } break; default:{ OneViewController *vcClass = [OneViewController new]; vcClass.title = @"4"; return vcClass; } break; } } #pragma mark 返回index对应的标题 - (NSString *)pageController:(WMPageController *)pageController titleAtIndex:(NSInteger)index { return self.titleData[index]; }

相关设置:

/** * Values and keys can set properties when initialize child controlelr (it's KVC) * values keys 属性可以用于初始化控制器的时候为控制器传值(利用 KVC 来设置) 使用时请确保 key 与控制器的属性名字一致!!(例如:控制器有需要设置的属性 type,那么 keys 所放的就是字符串 @"type") */ @property (nonatomic, strong) NSMutableArray<id> *values; @property (nonatomic, strong) NSMutableArray<NSString *> *keys; /** * 各个控制器的 class, 例如:[UITableViewController class] * Each controller's class, example:[UITableViewController class] */ @property (nonatomic, copy) NSArray<Class> *viewControllerClasses; /** * 各个控制器标题 * Titles of view controllers in page controller. */ @property (nonatomic, copy) NSArray<NSString *> *titles; @property (nonatomic, strong, readonly) UIViewController *currentViewController; /** * 设置选中几号 item * To select item at index */ @property (nonatomic, assign) int selectIndex; /** * 点击相邻的 MenuItem 是否触发翻页动画 (当当前选中与点击Item相差大于1是不触发) * Whether to animate when press the MenuItem, if distant between the selected and the pressed is larger than 1,never animate. */ @property (nonatomic, assign) BOOL pageAnimatable; /** * 选中时的标题尺寸 * The title size when selected (animatable) */ @property (nonatomic, assign) CGFloat titleSizeSelected; /** * 非选中时的标题尺寸 * The normal title size (animatable) */ @property (nonatomic, assign) CGFloat titleSizeNormal; /** * 标题选中时的颜色, 颜色是可动画的. * The title color when selected, the color is animatable. */ @property (nonatomic, strong) UIColor *titleColorSelected; /** * 标题非选择时的颜色, 颜色是可动画的. * The title's normal color, the color is animatable. */ @property (nonatomic, strong) UIColor *titleColorNormal; /** * 标题的字体名字 * The name of title's font */ @property (nonatomic, copy) NSString *titleFontName; /** * 导航栏高度 * The menu view's height */ @property (nonatomic, assign) CGFloat menuHeight; // 当所有item的宽度加起来小于屏幕宽时,PageController会自动帮助排版,添加每个item之间的间隙以填充整个宽度 // When the sum of all the item's width is smaller than the screen's width, pageController will add gap to each item automatically, in order to fill the width. /** * 每个 MenuItem 的宽度 * The item width,when all are same,use this property */ @property (nonatomic, assign) CGFloat menuItemWidth; /** * 各个 MenuItem 的宽度,可不等,数组内为 NSNumber. * Each item's width, when they are not all the same, use this property, Put `NSNumber` in this array. */ @property (nonatomic, copy) NSArray<NSNumber *> *itemsWidths; /** * 导航栏背景色 * The background color of menu view */ @property (nonatomic, strong) UIColor *menuBGColor; /** * Menu view 的样式,默认为无下划线 * Menu view's style, now has two different styles, 'Line','default' */ @property (nonatomic, assign) WMMenuViewStyle menuViewStyle; @property (nonatomic, assign) WMMenuViewLayoutMode menuViewLayoutMode; /** * 进度条的颜色,默认和选中颜色一致(如果 style 为 Default,则该属性无用) * The progress's color,the default color is same with `titleColorSelected`.If you want to have a different color, set this property. */ @property (nonatomic, strong) UIColor *progressColor; /** * 定制进度条在各个 item 下的宽度 */ @property (nonatomic, strong) NSArray *progressViewWidths; /// 定制进度条,若每个进度条长度相同,可设置该属性 @property (nonatomic, assign) CGFloat progressWidth; /// 调皮效果,用于实现腾讯视频新效果,请设置一个较小的 progressWidth @property (nonatomic, assign) BOOL progressViewIsNaughty; /** * 是否发送在创建控制器或者视图完全展现在用户眼前时通知观察者,默认为不开启,如需利用通知请开启 * Whether notify observer when finish init or fully displayed to user, the default is NO. * See `WMPageConst.h` for more information. */ @property (nonatomic, assign) BOOL postNotification; /** * 是否记录 Controller 的位置,并在下次回来的时候回到相应位置,默认为 NO (若当前缓存中存在不会触发) * Whether to remember controller's positon if it's a kind of scrollView controller,like UITableViewController,The default value is NO. * 比如 `UITabelViewController`, 当然你也可以在自己的控制器中自行设置, 如果将 Controller.view 替换为 scrollView 或者在Controller.view 上添加了一个和自身 bounds 一样的 scrollView 也是OK的 */ @property (nonatomic, assign) BOOL rememberLocation __deprecated_msg("Because of the cache policy,this property can abondon now."); /** 缓存的机制,默认为无限制 (如果收到内存警告, 会自动切换) */ @property (nonatomic, assign) WMPageControllerCachePolicy cachePolicy; /** 预加载机制,在停止滑动的时候预加载 n 页 */ @property (nonatomic, assign) WMPageControllerPreloadPolicy preloadPolicy; /** Whether ContentView bounces */ @property (nonatomic, assign) BOOL bounces; /** * 是否作为 NavigationBar 的 titleView 展示,默认 NO * Whether to show on navigation bar, the default value is `NO` */ @property (assign, nonatomic) BOOL showOnNavigationBar; /** * 用代码设置 contentView 的 contentOffset 之前,请设置 startDragging = YES * Set startDragging = YES before set contentView.contentOffset = xxx; */ @property (nonatomic, assign) BOOL startDragging; /** 下划线进度条的高度 */ @property (nonatomic, assign) CGFloat progressHeight; /** WMPageController View' frame */ @property (nonatomic, assign) CGRect viewFrame; /** * Menu view items' margin / make sure it's count is equal to (controllers' count + 1),default is 0 顶部菜单栏各个 item 的间隙,因为包括头尾两端,所以确保它的数量等于控制器数量 + 1, 默认间隙为 0 */ @property (nonatomic, copy) NSArray<NSNumber *> *itemsMargins; /** * set itemMargin if all margins are the same, default is 0 如果各个间隙都想同,设置该属性,默认为 0 */ @property (nonatomic, assign) CGFloat itemMargin; /** 顶部 menuView 和 scrollView 之间的间隙 */ @property (nonatomic, assign) CGFloat menuViewBottomSpace; /** progressView 到 menuView 底部的距离 */ @property (nonatomic, assign) CGFloat progressViewBottomSpace; /** progressView's cornerRadius */ @property (nonatomic, assign) CGFloat progressViewCornerRadius; /** 顶部导航栏 */ @property (nonatomic, weak) WMMenuView *menuView; /** 内部容器 */ @property (nonatomic, weak) WMScrollView *scrollView; /** MenuView 内部视图与左右的间距 */ @property (nonatomic, assign) CGFloat menuViewContentMargin; /** * 左滑时同时启用其他手势,比如系统左滑、sidemenu左滑。默认 NO (会引起一个小问题,第一个和最后一个控制器会变得可以斜滑, 还未解决) */ @property (assign, nonatomic) BOOL otherGestureRecognizerSimultaneously; /** * 构造方法,请使用该方法创建控制器. 或者实现数据源方法. / * Init method,recommend to use this instead of `-init`. Or you can implement datasource by yourself. * * @param classes 子控制器的 class,确保数量与 titles 的数量相等 * @param titles 各个子控制器的标题,用 NSString 描述 * * @return instancetype */ - (instancetype)initWithViewControllerClasses:(NSArray<Class> *)classes andTheirTitles:(NSArray<NSString *> *)titles; /** * A method in order to reload MenuView and child view controllers. If you had set `itemsMargins` or `itemsWidths` `values` and `keys` before, make sure you have update them also before you call this method. And most important, PAY ATTENTION TO THE COUNT OF THOSE ARRAY. 该方法用于重置刷新父控制器,该刷新包括顶部 MenuView 和 childViewControllers.如果之前设置过 `itemsMargins` 和 `itemsWidths` `values` 以及 `keys` 属性,请确保在调用 reload 之前也同时更新了这些属性。并且,最最最重要的,注意数组的个数以防止溢出。 */ - (void)reloadData; /** * Update designated item's title 更新指定序号的控制器的标题 * * @param title 新的标题 * @param index 目标序号 */ - (void)updateTitle:(NSString *)title atIndex:(NSInteger)index; /** * Update designated item's title and width 更新指定序号的控制器的标题以及他的宽度 * * @param title 新的标题 * @param index 目标序号 * @param width 对应item的新宽度 */ - (void)updateTitle:(NSString *)title andWidth:(CGFloat)width atIndex:(NSInteger)index; /** 当 app 即将进入后台接收到的通知 */ - (void)willResignActive:(NSNotification *)notification; /** 当 app 即将回到前台接收到的通知 */ - (void)willEnterForeground:(NSNotification *)notification;

源码demo:源码下载

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持查字典教程网。

相关阅读
推荐文章
猜你喜欢
附近的人在看
推荐阅读
拓展阅读
  • 大家都在看
  • 小编推荐
  • 猜你喜欢
  • 最新IOS开发学习
    热门IOS开发学习
    编程开发子分类