Skip to content

yaddaa/CSSimpleSideMenu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

51 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CSSimpleSideMenu

Version License Platform

Example

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

Screenshots

Requirements

  • Xcode 9.4.
  • Swift 4.1.
  • iOS 10 or higher.

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate SideMenu into your Xcode project using CocoaPods, specify it in your Podfile:

pod 'CSSimpleSideMenu'

Then, run the following command:

$ pod install

Usage

First Step:

import CSSimpleSideMenu

Second Step:

//example
let firstViewController = UIViewController()
let secondViewController = UIViewController()

let controllers = [
    SideMenuControllerModel(with: firstViewController, name: "First"),
    SideMenuControllerModel(with: secondViewController, name: "Second")
]

// create customization model
let customization = SideMenuCustomizationModel()

//customize
customization.position = .left

//configure
SideMenu.configure(with: controllers, customization: customization)

Important:

You need to call (SideMenu.configure) func at start your app

SideMenu.configure(with: controllers, customization: customization)

Customization Model Properties

//----------------- Background side menu settings

// you can set just background colod
public var backgroundColor: UIColor = UIColor(red: 0.209, green: 0.251, blue: 0.311, alpha: 1)

// or background image
public var backgroundImage: UIImage? = nil

//----------------- Customize items

// background color for selected item
public var menuItemsSelectedColor: UIColor = UIColor(red: 1.0, green: 1.0, blue: 1.0, alpha: 0.1)

public var menuItemsFont: UIFont = .boldSystemFont(ofSize: 17)
public var menuItemsTitleColor: UIColor = .white
public var menuItemsHeight: CGFloat = 64

//----------------- Top and bottom images

public var topImage: UIImage? = nil
public var bottomImage: UIImage? = nil

public var imagesContentMode: UIViewContentMode  = .scaleAspectFit

public var bottomImageHeight: CGFloat = 0

// top offset for menu items depends on this property
public var topImageHeight: CGFloat = UIScreen.main.bounds.height * 0.25


//----------------- Menu position
//set .left or .right side menu position
public var position: SideMenuEnums.Position = .left

Author

Chelak Stas, yaddaa2@gmail.com

License

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

A simple side menu for small projects