Skip to content

Library provides easy to implement variation of Android (Material Design) Floating Action Button for iOS. You can use it as your app small side menu. ๐ŸŒถ

License

Notifications You must be signed in to change notification settings

robertherdzik/RHSideButtons

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

51 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Version License Platform Language Twitter

RHSideButtons ๐ŸŒถ

Library provides easy to implement variation of Android (Material Design) Floating Action Button for iOS. You can use it as your app small side menu. ๐ŸŒถ

Play with it ๐Ÿ˜Ž

Installation

You can install RHSideButtons library using CocoaPods:

pod 'RHSideButtons'

or you can simply copy RHSideButtons folder to your project.

Usage

You just need implement RHSideButtonsDataSource and RHSideButtonsDelegate similar to well-known UIKit design.

// You need to firstly create trigger button. You can do this using block or your builder object which should conform to 'RHButtonViewConfigProtocol'
// RHTriggerButtonView allows you to change image for pressed state! ๐Ÿ‘Œ๐Ÿป
let triggerButton = RHTriggerButtonView(pressedImage: UIImage(named: "exit_icon")!) {
    $0.image = UIImage(named: "trigger_img")
    $0.hasShadow = true
}

// Then you need to create instance of SideButtons coordinator class with your View Controller view (it can be even TableView)
sideButtonsView = RHSideButtons(parentView: view, triggerButton: triggerButton)
sideButtonsView.delegate = self
sideButtonsView.dataSource = self

// When SideButtons controller is initialized properly you should set thier position in view in e.g. viewWillAppear method:
override func viewWillAppear(animated: Bool) {
    super.viewWillAppear(animated)

    sideBttns?.setTriggerButtonPosition(CGPoint(x: bounds.width - 85, y: bounds.height - 85))
}

... let us prepare our data models for buttons ๐Ÿ’ฅ below you can see one of many ways to do this:

//Finally you should create array of buttons which will feed our dataSource and Delegate methods :) e.g.:
let button_1 = RHButtonView {
    $0.image = UIImage(named: "icon_1")
    $0.hasShadow = true
}

let button_2 = RHButtonView {
    $0.image = UIImage(named: "icon_2")
    $0.hasShadow = true
}

let button_3 = RHButtonView {
    $0.image = UIImage(named: "icon_3")
    $0.hasShadow = true
}

buttonsArr.appendContentsOf([button_1, button_2, button_3])

//Similar as it is in TableView, now you should reload buttons with new values
sideButtonsView.reloadButtons()

๐Ÿ’ก important thing is that you need to reload buttons when your datasource has changed using reloadButtons() method (๐Ÿ˜ฑ simple rightโ“)

RHSideButtonsDataSource

func sideButtonsNumberOfButtons(sideButtons: RHSideButtons) -> Int
func sideButtons(sideButtons: RHSideButtons, buttonAtIndex index: Int) -> RHButtonView

RHSideButtonsDelegate

func sideButtons(sideButtons: RHSideButtons, didSelectButtonAtIndex index: Int)
func sideButtons(sideButtons: RHSideButtons, didTriggerButtonChangeStateTo state: RHButtonState)

Support for left-handers :)

If you decide to position RHSideButtons on the left site of view, buttons will dissapears to the left side of screen automatically.

e.g.:

sideBttns?.setTriggerButtonPosition(CGPoint(x:25, y: frame.size.height - 85))

Swift support

Library ver Swift ver
1.0 2.2
1.0.1 3.0
1.1.0 4.0

Check the Demo project

Please check out the demo project, you can see there what is the best (in my opinion ๐Ÿค”) way to implement my buttons. Please keep in mind that Readme contains the simplest way to implement this control.

About

Library provides easy to implement variation of Android (Material Design) Floating Action Button for iOS. You can use it as your app small side menu. ๐ŸŒถ

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published