BmoViewPager 4.0.2

BmoViewPager 4.0.2

TestsTested
LangLanguage SwiftSwift
License MIT
ReleasedLast Release Oct 2017
SwiftSwift Version 4.0
SPMSupports SPM

Maintained by Lee Zhe Yu.


Downloads

Total592
Week145
Month391

Installs

Apps57
Apps WeekApps This Week 22
Test Targets2
Test WeekTests This week 1
powered by Segment

GitHub

Stars133
Watchers6
Forks14
Issues0
Contributors1
Pull Requests0

Code

Files9
LOCLines of Code 1,274


  • By
  • LEE ZHE YU




⚠️ The latest version for Swift 3.2 is 3.2.0 ⚠️

⚠️ The latest version for Swift 4.0 is 4.0.0 ⚠️

A ViewPager with NavigationBar component based on UIPageViewController and UICollectionView, which is a convenience way to supply and manager each viewController.

I want to make UIPageViewController more intuitive for using it, like UITableView, and supply a navigationBar quickly and simply.

More importantly, when UIPageViewController scroll continuously, pageControl sometimes will get wrong index, this viewPager can help you solve it.

There are some standard dataSource and delegate implemented for generating each page and navigationBar, each of these classes have simple sample code showing in the Pod Example for BmoViewPager.

Simple Usage

Create a UIView extend BmoViewPager

Implement BmoViewPagerDataSource

give page count and each page controller, just like using tableView

func bmoViewPagerDataSourceNumberOfPage(in viewPager: BmoViewPager) -> Int {
    return YourPageCount
}
func bmoViewPagerDataSource(_ viewPager: BmoViewPager, viewControllerForPageAt page: Int) -> UIViewController {
    return YourPageViewController
}

With a NavigationBar

Create a UIView extend BmoViewPagerNavigationBar

Assign a BmoViewPager to the BmoViewPagerNavigationBar

using default style, only need to give the each page title

func bmoViewPagerDataSourceNaviagtionBarItemTitle(_ viewPager: BmoViewPager, navigationBar: BmoViewPagerNavigationBar, forPageListAt page: Int) -> String? {
    return YourPageTitleString
}

navigation item title can custom attributed

func bmoViewPagerDataSourceNaviagtionBarItemNormalAttributed(_ viewPager: BmoViewPager, navigationBar: BmoViewPagerNavigationBar, forPageListAt page: Int) -> [NSAttributedStringKey : Any]? {
    return [
        NSAttributedStringKey.foregroundColor : UIColor.lightGray,
        NSAttributedStringKey.font : UIFont.systemFont(ofSize: 14.0)
    ]
}
func bmoViewPagerDataSourceNaviagtionBarItemHighlightedAttributed(_ viewPager: BmoViewPager, navigationBar: BmoViewPagerNavigationBar, forPageListAt page: Int) -> [NSAttributedStringKey : Any]? {
    return [
        NSAttributedStringKey.foregroundColor : UIColor.red,
        NSAttributedStringKey.font : UIFont.boldSystemFont(ofSize: 14.0)
    ]
}

if you don't want use default style, you can custom your own background view and highlighted background view

Advanced Usage

Support Vertical and Horizontal direction scroll

BmoNavigationBar Auto Focus (Default is true)

BmoNavigationBar Title can set normal and highlighted attributed style

BmoViewPager infinitScroll (Default is false)

BmoViewPager presentedPageIndex can programmatically assign the present page

Custom NavigationBar animation, you can get scroll progress from BmoViewPagerDelegate

Navigation bar interporation animation when change viewPager page by tap navigationItem

InfiniteScroll Custom NavigationBar animation

PageControl Optimized

native pageController have a default pageControl if you implement the
func presentationCount(for pageViewController: UIPageViewController) -> Int and
func presentationIndex(for pageViewController: UIPageViewController) -> Int
but sometimes the index have a little bug, if you feel the way too, hope it help you

Native PageController continuously scroll continuously scroll using bmoViewPager

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

  • iOS 8.0+
  • Xcode 8.0+
  • Swift 3.0+

Installation

Manually

If you prefer not to use the dependency managers, you can integrate BmoViewPager into your project manually, just copy the BmoViewPager folder into your project.

Author

LEE ZHE YU, [email protected]

License

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