PagingMenuController

This library is inspired by PageMenu.

Standard mode with flexible item width

Segmented control mode

Infinite mode with fixed item width

Customization

PagingMenuControllerCustomizable

  • default page index to show as a first view
defaultPage: Int
Swift
  • duration for paging view animation
animationDuration: TimeInterval
Swift
  • isScrollEnabled for paging view. Set false in case of using swipe-to-delete on your table view
isScrollEnabled: Bool
Swift
  • background color for paging view
backgroundColor: UIColor
Swift
  • number of lazy loading pages
lazyLoadingPage: LazyLoadingPage
public enum LazyLoadingPage {
    case one // Currently sets false to isScrollEnabled at this moment. Should be fixed in the future.
    case three
    case all // Currently not available for Infinite mode
}
Swift
  • a set of menu controller
menuControllerSet: MenuControllerSet
public enum MenuControllerSet {
        case single
        case multiple
    }
Swift
  • component type of PagingMenuController
componentType: ComponentType
public enum ComponentType {
    case menuView(menuOptions: MenuViewCustomizable)
    case pagingController(pagingControllers: [UIViewController])
    case all(menuOptions: MenuViewCustomizable, pagingControllers: [UIViewController])
}
Swift
  • background color for menu view
backgroundColor: UIColor
Swift
  • background color for selected menu item
selectedBackgroundColor: UIColor
Swift
  • height for menu view
height: CGFloat
Swift
  • duration for menu view animation
animationDuration: TimeInterval
Swift
  • decelerating rate for menu view
deceleratingRate: CGFloat
Swift
  • menu item position
menuSelectedItemCenter: Bool
Swift
  • menu mode and scrolling mode
displayMode: MenuDisplayMode

public enum MenuDisplayMode {
    case standard(widthMode: MenuItemWidthMode, centerItem: Bool, scrollingMode: MenuScrollingMode)
    case segmentedControl
    case infinite(widthMode: MenuItemWidthMode, scrollingMode: MenuScrollingMode) // Requires three paging views at least
}

public enum MenuItemWidthMode {
    case flexible
    case fixed(width: CGFloat)
}

public enum MenuScrollingMode {
  case scrollEnabled
  case scrollEnabledAndBouces
  case pagingEnabled
}
Swift

if centerItem is true, selected menu item is always on center

if MenuScrollingMode is ScrollEnabled or ScrollEnabledAndBouces, menu view allows scrolling to select any menu item
if MenuScrollingMode is PagingEnabled, menu item should be selected one by one

  • menu item focus mode
focusMode: MenuFocusMode
public enum MenuFocusMode {
    case none
    case underline(height: CGFloat, color: UIColor, horizontalPadding: CGFloat, verticalPadding: CGFloat)
    case roundRect(radius: CGFloat, horizontalPadding: CGFloat, verticalPadding: CGFloat, selectedColor: UIColor)
}
Swift
  • dummy item view number for Infinite mode
dummyItemViewsSet: Int
Swift
  • menu position
menuPosition: MenuPosition

public enum MenuPosition {
    case top
    case bottom
}
Swift
  • divider image to display right aligned in each menu item
dividerImage: UIImage?
Swift
  • horizontal margin for menu item
horizontalMargin: CGFloat
Swift
  • menu item mode
displayMode: MenuItemDisplayMode
public enum MenuItemDisplayMode {
    case text(title: MenuItemText)
    case multilineText(title: MenuItemText, description: MenuItemText)
    case image(image: UIImage, selectedImage: UIImage?)
    case custom(view: UIView)
}
Swift

Usage

import PagingMenuController to use PagingMenuController in your file.

Using Storyboard

struct MenuItem1: MenuItemViewCustomizable {}
struct MenuItem2: MenuItemViewCustomizable {}

struct MenuOptions: MenuViewCustomizable {
    var itemsOptions: [MenuItemViewCustomizable] {
        return [MenuItem1(), MenuItem2()]
    }
}

struct PagingMenuOptions: PagingMenuControllerCustomizable {
    var componentType: ComponentType {
        return .all(menuOptions: MenuOptions(), pagingControllers: [UIViewController(), UIViewController()])
    }
}

let pagingMenuController = self.childViewControllers.first as! PagingMenuController
pagingMenuController.setup(options)
pagingMenuController.onMove = { state in
    switch state {
    case let .willMoveController(menuController, previousMenuController):
        print(previousMenuController)
        print(menuController)
    case let .didMoveController(menuController, previousMenuController):
        print(previousMenuController)
        print(menuController)
    case let .willMoveItem(menuItemView, previousMenuItemView):
        print(previousMenuItemView)
        print(menuItemView)
    case let .didMoveItem(menuItemView, previousMenuItemView):
        print(previousMenuItemView)
        print(menuItemView)
    case .didScrollStart:
        print("Scroll start")
    case .didScrollEnd:
        print("Scroll end")
    }
}
Swift
  • You should add ContainerView into your view controller's view and set PagingMenuController as the embedded view controller's class

See PagingMenuControllerDemo target in demo project for more details

Coding only

struct MenuItem1: MenuItemViewCustomizable {}
struct MenuItem2: MenuItemViewCustomizable {}

struct MenuOptions: MenuViewCustomizable {
    var itemsOptions: [MenuItemViewCustomizable] {
        return [MenuItem1(), MenuItem2()]
    }
}

struct PagingMenuOptions: PagingMenuControllerCustomizable {
    var componentType: ComponentType {
        return .all(menuOptions: MenuOptions(), pagingControllers: [UIViewController(), UIViewController()])
    }
}

let options = PagingMenuOptions()
let pagingMenuController = PagingMenuController(options: options)

addChildViewController(pagingMenuController)
view.addSubview(pagingMenuController.view)
pagingMenuController.didMove(toParentViewController: self)
Swift

See PagingMenuControllerDemo2 target in demo project for more details

public enum MenuMoveState {
    case willMoveController(to: UIViewController, from: UIViewController)
    case didMoveController(to: UIViewController, from: UIViewController)
    case willMoveItem(to: MenuItemView, from: MenuItemView)
    case didMoveItem(to: MenuItemView, from: MenuItemView)
    case didScrollStart
    case didScrollEnd
}

pagingMenuController.onMove = { state in
    switch state {
    case let .willMoveController(menuController, previousMenuController):
        print(previousMenuController)
        print(menuController)
    case let .didMoveController(menuController, previousMenuController):
        print(previousMenuController)
        print(menuController)
    case let .willMoveItem(menuItemView, previousMenuItemView):
        print(previousMenuItemView)
        print(menuItemView)
    case let .didMoveItem(menuItemView, previousMenuItemView):
        print(previousMenuItemView)
        print(menuItemView)
    case .didScrollStart:
        print("Scroll start")
    case .didScrollEnd:
        print("Scroll end")
    }
}
Swift

Moving to a menu tag programmatically

// if you pass a nonexistent page number, it'll be ignored
pagingMenuController.move(toPage: 1, animated: true)
Swift

Changing PagingMenuController's option

Call setup method with new options again.
It creates a new paging menu controller. Do not forget to cleanup properties in child view controller.

Requirements

iOS9+
Swift 3.0+
Xcode 8.0+

v1.4.0 for iOS 8 in Swift 3.0
v1.2.0 for iOS 8 in Swift 2.3

Installation

CocoaPods

PagingMenuController is available through CocoaPods. To install
it, simply add the following line to your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
use_frameworks!

pod "PagingMenuController"

post_install do |installer|
 installer.pods_project.targets.each do |target|
   target.build_configurations.each do |config|
     config.build_settings['SWIFT_VERSION'] = '3.0'
   end
 end
end
Ruby

Then, run pod install

In case you haven't installed CocoaPods yet, run the following command

$ gem install cocoapods
Ruby

Carthage

PagingMenuController is available through Carthage.

To install PagingMenuController into your Xcode project using Carthage, specify it in your Cartfile:

github "kitasuke/PagingMenuController"
Ruby

Then, run carthage update --toolchain com.apple.dt.toolchain.Swift_3_0

You can see Carthage/Build/iOS/PagingMenuController.framework now, so drag and drop it to Linked Frameworks and Libraries in General menu tab with your project.
Add the following script to New Run Script Phase in Build Phases menu tab.

/usr/local/bin/carthage copy-frameworks
Ruby

Also add the following script in Input Files

$(SRCROOT)/Carthage/Build/iOS/PagingMenuController.framework
Ruby

In case you haven't installed Carthage yet, download the latest pkg from Carthage

Manual

Copy all the files in Pod/Classes directory into your project.

GitHub

kitasuke/PagingMenuController

2493447

Paging view controller with customizable menu in Swift — Read More

Latest commit to the master branch on 2-9-2022
Download as zip