DNSPageView 的 Objective-C 版本
DNSPageView 的 Objective-C 版本,是一个灵活且易于使用的 pageView 框架,titleView 和 contentView 可以布局在任意地方,可以纯代码初始化,也可以使用 xib 或者 storyboard 初始化,并且提供了常见样式属性进行设置。
如果你使用的开发语言是 Swift,请使用 DNSPageView
iOS 8.0+
Xcode 9.0+
CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:
$ gem install cocoapods
CocoaPods 1.1+ is required to build DNSPageView.
To integrate DNSPageView into your Xcode project using CocoaPods, specify it in your Podfile
:
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
target '<Your Target Name>' do
pod 'DNSPageView-ObjC'
end
Then, run the following command:
$ pod install
If you prefer not to use any of the aforementioned dependency managers, you can integrate DNSPageView-ObjC into your project manually.
To run the example project, clone the repo, and run DNSPageView.xcodeproj
.
// 创建 DNSPageStyle,设置样式
DNSPageStyle *style = [[DNSPageStyle alloc] init];
style.titleViewScrollEnabled = YES;
style.titleScaleEnabled = YES;
// 设置标题内容
NSArray <NSString *>*titles = @[@"头条", @"视频", @"娱乐", @"要问", @"体育", @"科技", @"汽车", @"时尚", @"图片", @"游戏", @"房产"];
// 创建每一页对应的 controller
for (int i = 0; i < titles.count; i++) {
ContentViewController *controller = [[ContentViewController alloc] init];
[self addChildViewController:controller];
}
CGFloat y = [UIApplication sharedApplication].statusBarFrame.size.height + self.navigationController.navigationBar.frame.size.height;
CGSize size = [UIScreen mainScreen].bounds.size;
// 创建对应的 DNSPageView,并设置它的 frame
DNSPageView *pageView = [[DNSPageView alloc] initWithFrame:CGRectMake(0, y, size.width, size.height - y) style:style titles:titles childViewControllers:self.childViewControllers currentIndex:7];
[self.view addSubview:pageView];
在 xib
或者 storyboard
中拖出 2 个 UIView
,让它们分别继承 DNSPageTitleView
和 DNSPageContentView
,拖线到代码中
@property (weak, nonatomic) IBOutlet DNSPageTitleView *titleView;
@property (weak, nonatomic) IBOutlet DNSPageContentView *contentView;
对 DNSPageTitleView 和 DNSPageContentView 进行设置
// 创建 DNSPageStyle,设置样式
DNSPageStyle *style = [[DNSPageStyle alloc] init];
style.titleViewBackgroundColor = [UIColor redColor];
style.showCoverView = YES;
// 设置标题内容
NSArray <NSString *>*titles = @[@"头条", @"视频", @"娱乐", @"要问", @"体育"];
// 设置默认的起始位置
NSInteger startIndex = 2;
// 创建每一页对应的 controller
for (int i = 0; i < titles.count; i++) {
ContentViewController *controller = [[ContentViewController alloc] init];
[self addChildViewController:controller];
}
// 创建 DNSPageViewManager 来设置它们的样式和布局
DNSPageViewManager *pageViewManager = [[DNSPageViewManager alloc] initWithStyle:style
titles:titles
childViewControllers:self.childViewControllers
currentIndex:currentIndex
titleView:self.titleView
contentView:self.contentView];
创建 DNSPageViewManager
- (DNSPageViewManager *)pageViewManager {
if (!_pageViewManager) {
// 创建 DNSPageStyle,设置样式
DNSPageStyle *style = [[DNSPageStyle alloc] init];
style.showBottomLine = YES;
style.titleViewScrollEnabled = YES;
style.titleViewBackgroundColor = [UIColor clearColor];
// 设置标题内容
NSArray <NSString *>*titles = @[@"头条", @"视频", @"娱乐", @"要问", @"体育"];
// 创建每一页对应的 controller
for (int i = 0; i < titles.count; i++) {
ContentViewController *controller = [[ContentViewController alloc] init];
[self addChildViewController:controller];
}
_pageViewManager = [[DNSPageViewManager alloc] initWithStyle:style titles:titles childViewControllers:self.childViewControllers];
}
return _pageViewManager;
}
布局 titleView 和 contentView
// 单独设置 titleView 的 frame
self.navigationItem.titleView = self.pageViewManager.titleView;
self.pageViewManager.titleView.frame = CGRectMake(0, 0, 180, 44);
// 单独设置 contentView 的大小和位置,可以使用 autolayout 或者 frame
DNSPageContentView *contentView = self.pageViewManager.contentView;
[self.view addSubview:contentView];
[contentView makeConstraints:^(MASConstraintMaker *make) {
make.edges.equalTo(self.view);
}];
DNSPageStyle
中提供了常见样式的属性,可以按照不同的需求进行设置,包括可以设置初始显示的页面
DNSPageView 提供了常见事件监听的代理,它属于 DNSPageTitleViewDelegate
的中的属性
/**
DNSPageView 的事件回调,如果有需要,请让对应的 childViewController 遵守这个协议
*/
@protocol DNSPageEventHandlerDelegate <NSObject>
@optional
/**
重复点击 pageTitleView 后调用
*/
- (void)titleViewDidSelectSameTitle;
/**
pageContentView 的上一页消失的时候,上一页对应的 controller 调用
*/
- (void)contentViewDidDisappear;
/**
pageContentView 滚动停止的时候,当前页对应的 controller 调用
*/
- (void)contentViewDidEndScroll;
@end
style.isTitleViewScrollEnabled
如果标签比较少,建议设置 style.titleViewScrollEnabled = NO
,titleView
会固定,style.titleMargin
不起作用,每个标签平分整个 titleView
的宽度,下划线的宽度等于标签的宽度。
如果标签比较多,建议设置 style.titleViewScrollEnabled = YES
,titleView
会滑动,下划线的宽度随着标签文字的宽度变化而变化
标签下划线的宽度跟随文字的宽度
设置 style.titleViewScrollEnabled = YES
,可以参考 demo 中的第四种样式。
由于 DNSPageView
是基于 UIScrollView
实现,那么就无法避免它的一些特性:
UINavigationController
管理,且 navigationBar.isTranslucent = YES
的时候,当前控制器的 view
是从 y = 0
开始布局的,所以为了防止部分内容被 navigationBar
遮挡,系统默认会给 UIScrollView
添加 offset。如果想取消这个特性:
self.automaticallyAdjustsScrollViewInsets = NO
SafeArea
概念,设置 UIScrollView
的属性 contentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentNever
UIViewController
的其他属性有关系,但因为各种组合的情景过于复杂,所以不在此一一描述DNSPageContentView
用 UICollectionView
实现,所以这个特性有机会造成 UICollectionView
的高度小于它的 item
的高度,造成奇怪的 Bug。Demo
不能覆盖所有的场景,不同的布局需求可能会引起不同的 Bug,开发者需要明确了解自己的布局需求,注意细节,了解 iOS 布局特性,并且作出对应的调整,不能完全参照 Demo
。DNSPageView-ObjC is available under the MIT license. See the LICENSE file for more info.