DNSPageView一个纯Swift的轻量级、灵活且易于使用的PageView框架，titleView和contentView可以布局在任意地方，可以纯代码初始化，也可以使用xib或者storyboard初始化，并且提供了常见样式属性进行设置。
如果你使用的开发语言是Objective-C，请使用DNSPageView-ObjC
- 使用简单
- 多种初始化方式
- 灵活布局
- 常见的样式
- 双击
titleView的回调 -
contentView滑动监听
- iOS 8.0+
- Xcode 10.2+
- Swift 5.0+
CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:
$ gem install cocoapodsCocoaPods 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'
use_frameworks!
target '<Your Target Name>' do
pod 'DNSPageView'
endThen, run the following command:
$ pod installIf you prefer not to use any of the aforementioned dependency managers, you can integrate DNSPageView into your project manually.
To run the example project, clone the repo, and run DNSPageView.xcodeproj .
// 创建DNSPageStyle，设置样式
let style = DNSPageStyle()
style.isTitleViewScrollEnabled = true
style.isTitleScaleEnabled = true
// 设置标题内容
let titles = ["头条", "视频", "娱乐", "要问", "体育" , "科技" , "汽车" , "时尚" , "图片" , "游戏" , "房产"]
// 创建每一页对应的controller
let childViewControllers: [UIViewController] = titles.map { _ -> UIViewController in
let controller = UIViewController()
addChild(controller)
return controller
}
let y = UIApplication.shared.statusBarFrame.height + (navigationController?.navigationBar.frame.height ?? 0)
let size = UIScreen.main.bounds.size
// 创建对应的DNSPageView，并设置它的frame
// titleView和contentView会连在一起
let pageView = DNSPageView(frame: CGRect(x: 0, y: y, width: size.width, height: size.height), style: style, titles: titles, childViewControllers: childViewControllers)
view.addSubview(pageView)在xib或者storyboard中拖出2个UIView，让它们分别继承DNSPageTitleView和DNSPageContentView，拖线到代码中
@IBOutlet weak var titleView: DNSPageTitleView!
@IBOutlet weak var contentView: DNSPageContentView!对DNSPageTitleView和DNSPageContentView进行设置
// 创建DNSPageStyle，设置样式
let style = DNSPageStyle()
style.titleViewBackgroundColor = UIColor.red
style.isShowCoverView = true
// 设置标题内容
let titles = ["头条", "视频", "娱乐", "要问", "体育"]
// 设置默认的起始位置
let startIndex = 2
// 对titleView进行设置
titleView.titles = titles
titleView.style = style
titleView.currentIndex = startIndex
// 最后要调用setupUI方法
titleView.setupUI()
// 创建每一页对应的controller
let childViewControllers: [UIViewController] = titles.map { _ -> UIViewController in
let controller = UIViewController()
addChild(controller)
return controller
}
// 对contentView进行设置
contentView.childViewControllers = childViewControllers
contentView.startIndex = startIndex
contentView.style = style
// 最后要调用setupUI方法
contentView.setupUI()
// 让titleView和contentView进行联系起来
titleView.delegate = contentView
contentView.delegate = titleView创建DNSPageViewManager
private lazy var pageViewManager: DNSPageViewManager = {
// 创建DNSPageStyle，设置样式
let style = DNSPageStyle()
style.isShowBottomLine = true
style.isTitleViewScrollEnabled = true
style.titleViewBackgroundColor = UIColor.clear
// 设置标题内容
let titles = ["头条", "视频", "娱乐", "要问", "体育"]
// 创建每一页对应的controller
let childViewControllers: [UIViewController] = titles.map { _ -> UIViewController in
let controller = UIViewController()
addChild(controller)
return controller
}
return DNSPageViewManager(style: style, titles: titles, childViewControllers: childViewControllers)
}()布局titleView和contentView
// 单独设置titleView的frame
navigationItem.titleView = pageViewManager.titleView
pageViewManager.titleView.frame = CGRect(x: 0, y: 0, width: 180, height: 44)
// 单独设置contentView的大小和位置，可以使用autolayout或者frame
let contentView = pageViewManager.contentView
view.addSubview(pageViewManager.contentView)
contentView.snp.makeConstraints { (maker) in
maker.edges.equalToSuperview()
}DNSPageStyle中提供了常见样式的属性，可以按照不同的需求进行设置，包括可以设置初始显示的页面
DNSPageView提供了常见事件监听回调，它属于DNSPageTitleViewDelegate的中的可选属性
/// DNSPageView的事件回调，如果有需要，请让对应的childViewController遵守这个协议
@objc public protocol DNSPageEventHandleable: class {
/// 重复点击pageTitleView后调用
@objc optional func titleViewDidSelectSameTitle()
/// pageContentView的上一页消失的时候，上一页对应的controller调用
@objc optional func contentViewDidDisappear()
/// pageContentView滚动停止的时候，当前页对应的controller调用
@objc optional func contentViewDidEndScroll()
}-
style.isTitleViewScrollEnabled如果
titles的数量比较少，建议设置style.isTitleViewScrollEnabled = false，titleView会固定，style.titleMargin不起作用，每个title平分整个titleView的宽度，下划线的宽度等于title的宽度。如果标签比较多，建议设置
style.isTitleViewScrollEnabled = true，titleView会滑动，下划线的宽度随着title文字的宽度变化而变化 -
标签下划线的宽度跟随文字的宽度
设置
style.isTitleViewScrollEnabled = true，可以参考Demo中的第四种样式。 -
由于
DNSPageView是基于UIScrollView实现，那么就无法避免它的一些特性：-
当控制器被
UINavigationController管理，且navigationBar.isTranslucent = true的时候，当前控制器的view是从y = 0开始布局的，所以为了防止部分内容被navigationBar遮挡，系统默认会给UIScrollView添加offset。如果想取消这个特性：- iOS 11 以前，在控制器中设置
automaticallyAdjustsScrollViewInsets = false - iOS 11 以后引入
SafeArea概念，设置UIScrollView的属性contentInsetAdjustmentBehavior = .never - 其实这个效果还与
UIViewController的其他属性有关系，但因为各种组合的情景过于复杂，所以不在此一一描述
- iOS 11 以前，在控制器中设置
-
DNSPageContentView用UICollectionView实现，所以这个特性有机会造成UICollectionView的经典警告：The behavior of the UICollectionViewFlowLayout is not defined because:
the item height must be less than the height of the UICollectionView minus the section insets top and bottom values, minus the content insets top and bottom values
从而引发一些Bug
-
以上只是可能出现的Bug之一，由于
Demo不能覆盖所有的场景，不同的布局需求可能会引起不同的Bug，开发者需要明确了解自己的布局需求，注意细节，了解iOS布局特性，并且作出对应的调整，不能完全参照Demo。
-
DNSPageView is available under the MIT license. See the LICENSE file for more info.