DNSPageView一个纯Swift的轻量级、灵活且易于使用的PageView
框架,titleView
和contentView
可以布局在任意地方,可以纯代码初始化,也可以使用xib
或者storyboard
初始化,并且提供了常见样式属性进行设置。
如果你使用的开发语言是Objective-C,请使用DNSPageView-ObjC
titleView
的回调contentView
滑动监听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'
use_frameworks!
target '<Your Target Name>' do
pod 'DNSPageView'
end
Then, run the following command:
$ pod install
If 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
.
// 创建PageStyle,设置样式
let style = PageStyle()
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
// 创建对应的PageView,并设置它的frame
// titleView和contentView会连在一起
let pageView = PageView(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
,让它们分别继承PageTitleView
和PageContentView
,拖线到代码中
@IBOutlet weak var titleView: PageTitleView!
@IBOutlet weak var contentView: PageContentView!
对PageTitleView和PageContentView进行设置
// 创建PageStyle,设置样式
let style = PageStyle()
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: PageViewManager = {
// 创建PageStyle,设置样式
let style = PageStyle()
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 PageViewManager(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()
}
PageStyle
中提供了常见样式的属性,可以按照不同的需求进行设置,包括可以设置初始显示的页面
DNSPageView提供了常见事件监听回调,它属于PageTitleViewDelegate
的中的可选属性
/// DNSPageView的事件回调,如果有需要,请让对应的childViewController遵守这个协议
@objc public protocol PageEventHandleable: 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。如果想取消这个特性:
automaticallyAdjustsScrollViewInsets = false
SafeArea
概念,设置UIScrollView
的属性contentInsetAdjustmentBehavior = .never
UIViewController
的其他属性有关系,但因为各种组合的情景过于复杂,所以不在此一一描述PageContentView
用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.
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。