Latest 1.1.2
Homepage https://github.com/Danie1s/DNSPageView
License MIT
Platforms ios 8.0, requires ARC
Authors

Version
License
Platform

DNSPageView一个纯Swift的轻量级、灵活且易于使用的pageView框架,titleView和contentView可以布局在任意地方,可以纯代码初始化,也可以使用xib或者storyboard初始化,并且提供了常见样式属性进行设置。

如果你使用的开发语言是Objective-C,请使用DNSPageView-ObjC

Features:

  • [x] 使用简单
  • [x] 多种初始化方式
  • [x] 灵活布局
  • [x] 常见的样式
  • [x] 双击titleView的回调
  • [x] contentView滑动监听

Requirements

  • iOS 8.0+

  • Xcode 10.0+

  • Swift 4.2+

Installation

CocoaPods

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

Manually

If you prefer not to use any of the aforementioned dependency managers, you can integrate DNSPageView into your project manually.

Example

To run the example project, clone the repo, and run DNSPageView.xcodeproj .

DNSPageView
DNSPageView
DNSPageView
DNSPageView

Usage

直接使用DNSPageView初始化

// 创建DNSPageStyle,设置样式
let style = DNSPageStyle()
style.isTitleScrollEnable = true
style.isScaleEnable = true

// 设置标题内容
let titles = ["头条", "视频", "娱乐", "要问", "体育" , "科技" , "汽车" , "时尚" , "图片" , "游戏" , "房产"]

// 创建每一页对应的controller
let childViewControllers: [ContentViewController] = titles.map { _ -> ContentViewController in
    let controller = ContentViewController()
    controller.view.backgroundColor = UIColor.randomColor
    return controller
}

let size = UIScreen.main.bounds.size

// 创建对应的DNSPageView,并设置它的frame
// titleView和contentView会连在一起
let pageView = DNSPageView(frame: CGRect(x: 0, y: 64, width: size.width, height: size.height), style: style, titles: titles, childViewControllers: childViewControllers)
view.addSubview(pageView)

使用xib或者storyboard初始化

在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: [ContentViewController] = titles.map { _ -> ContentViewController in
    let controller = ContentViewController()
    controller.view.backgroundColor = UIColor.randomColor
    return controller
}

// 对contentView进行设置
contentView.childViewControllers = childViewControllers
contentView.startIndex = startIndex
contentView.style = style

// 最后要调用setupUI方法
contentView.setupUI()

// 让titleView和contentView进行联系起来
titleView.delegate = contentView
contentView.delegate = titleView

使用DNSPageViewManager初始化,再分别对titleView和contentView进行布局

创建DNSPageViewManager

private lazy var pageViewManager: DNSPageViewManager = {
    // 创建DNSPageStyle,设置样式
    let style = DNSPageStyle()
    style.isShowBottomLine = true
    style.isTitleScrollEnable = true
    style.titleViewBackgroundColor = UIColor.clear

    // 设置标题内容
    let titles = ["头条", "视频", "娱乐", "要问", "体育"]

    // 创建每一页对应的controller
    let childViewControllers: [ContentViewController] = titles.map { _ -> ContentViewController in
        let controller = ContentViewController()
        controller.view.backgroundColor = UIColor.randomColor
        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的中的可选属性

/// 如果contentView中的view需要实现某些刷新的方法,请让对应的childViewController遵守这个协议
@objc public protocol DNSPageReloadable: class {

    /// 如果需要双击标题刷新或者作其他处理,请实现这个方法
    @objc optional func titleViewDidSelectedSameTitle()

    /// 如果pageContentView滚动到下一页停下来需要刷新或者作其他处理,请实现这个方法
    @objc optional func contentViewDidEndScroll()
}

常见问题

  • 标签比较少时,titleView不固定、会滑动

    style.isTitleViewScrollEnabled = true时,代表标签会比较多,所以默认会滑动。如果标签比较少,建议设置style.isTitleViewScrollEnabled = false

  • 标签下划线的宽度跟随文字的宽度

    style.isTitleViewScrollEnabled = false时,表示标签比较少,默认每个标签平分整个titleView的宽度,而下划线的宽度等于标签的宽度,这种样式的需求也很常见。

    要想实现标签下划线的宽度跟随文字的宽度,需要设置style.isTitleViewScrollEnabled = true,结合第一个问题,如果标签比较少,则需要手动计算标签的宽度,设置对应的titleView宽度,详细的代码可以参考demo中的第四种样式。

License

DNSPageView is available under the MIT license. See the LICENSE file for more info.

Latest podspec

{
    "name": "DNSPageView",
    "version": "1.1.2",
    "swift_version": "4.2",
    "summary": "DNSPageView is a lightweight, pure-Swift library.",
    "description": "DNSPageView is a lightweight, pure-Swift library for pageView.",
    "homepage": "https://github.com/Danie1s/DNSPageView",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "Daniels": "[email protected]"
    },
    "source": {
        "git": "https://github.com/Danie1s/DNSPageView.git",
        "tag": "1.1.2"
    },
    "platforms": {
        "ios": "8.0"
    },
    "source_files": "DNSPageView/*.swift",
    "requires_arc": true,
    "pod_target_xcconfig": {
        "SWIFT_VERSION": "4.2"
    }
}

Pin It on Pinterest

Share This