rakutou / spreadbutton

a Button can spread its sub path button like the flower if you click，once again，close.

SpreadButton

A Button can spread its sub path button like the flower if you click，once again，close.
一个当你点击它后会像花或者镰刀一样展开的按钮，迎来0.1.5版本后，你可以切换一种位置模式，把它当iphone里的AssistiveTouch.
---0.1.5更新粘连边缘模式(home键模式)---

>个人博客原文: http://zyden.vicp.cc/zyspreadbutton/ Demo github地址: https://github.com/liuzhiyi1992/SpreadButton 欢迎转载，请注明出处谢谢

##Summary
顾名思义，一个会散开的按钮，主体按钮被点击后触发子按钮的展出，选择其中一个功能子按钮，或者点击任意地方，触发子按钮的收缩隐藏。 SpreadButton设计有2种展开方式，2种位置模式，8种展开方向。
A Button spread its sub path buttons like the flower or sickle(two spread mode) if you click it, once again, close.And you can also change the SpreadPositionMode between FixedMode & TouchBorderMode， while one like the marbleBall fixed on the wall, another one like the AssistiveTouch is iphone。

**两种展开模式(SpreadMode)：**镰刀模式 & 花朵模式

 **两种位置模式(SpreadPositionMode)：**锁定模式 & 粘连边缘模式，在粘连边缘模式下，根据主体按钮的位置，会实时更新展开模式
粘连边缘模式下 不同展开模式位置指示图： 

##Contact
###you can play the demo online in appetize.io

##Installation
####Cocoapods

pod 'SpreadButton'

####Fork form my github let your project include SpreadButton.swift & SpreadSubButton.swift
oc项目需要在bridge头文件里import他们

##Custom-made **Property：** - animationDuring: assign the ‘animationDuring’ can also change ‘animationDuringSpread’ & ‘animationDuringClose’，default is 0.2 - coverAlpha - coverColor - mode: `case SpreadModeSickleSpread case SpreadModeFlowerSpread` - radius: spread Radius - direction: `case SpreadDirectionTop case SpreadDirectionBottom case SpreadDirectionLeft case SpreadDirectionRight case SpreadDirectionLeftUp case SpreadDirectionLeftDown case SpreadDirectionRightUp case SpreadDirectionRightDown` - touchBorderMargin: margin border in SpreadPositionModeTouchBorder - buttonWillSpreadBlock - buttonDidSpreadBlock - buttonWillCloseBlock - buttonDidCloseBlock
**private static:** ---you can edit the default in the source--- - private static let sickleSpreadAngleDefault: CGFloat = 90.0 - private static let flowerSpreadAngleDefault: CGFloat = 120.0 - private static let spredaDirectionDefault: SpreadDirection = .SpreadDirectionTop - private static let spreadRadiusDefault: CGFloat = 100.0 - private static let coverAlphaDefault: CGFloat = 0.1 - private static let touchBorderMarginDefault: CGFloat = 10.0 - private static let touchBorderAnimationDuringDefault = 0.5 - private static let animationDuringDefault = 0.2

##Usage 以swift为例子：
1.通过SpreadButton的构造方法来创建一个SpreadButton对象，传入主体按钮的背景图片，高亮图片(非必须)，还有位置，如果传入的UIImage为nil，放心，编译时就会报错

let spreadButton = SpreadButton(image: UIImage(named: "powerButton"),
                       highlightImage: UIImage(named: "powerButton_highlight"),
                             position: CGPointMake(40, UIScreen.mainScreen().bounds.height - 40))

2.创建子按钮(SpreadSubButton)，传入背景图片，高亮图片(非必须)，还有一个尾随闭包，子按钮被点击后我们这个闭包会被调用，同样的，如果传入的UIImage为nil，编译时会报错

let btn1 = SpreadSubButton(backgroundImage: UIImage(named: "clock"), 
                            highlightImage: UIImage(named: "clock_highlight")) { (index, sender) -> Void in
     print("first button be clicked!!!")
}

let btn2 = SpreadSubButton(backgroundImage: UIImage(named: "pencil"), 
                            highlightImage: UIImage(named: "pencil_highlight")) { (index, sender) -> Void in
     print("second button be clicked!!!")
}
//像这样你可以创建更多

3.通过-setSubButtons为SpreadButton设置子按钮，这里你可以传入nil或者SpreadButton?试试，没关系，里面做了保险，会排除，哈哈扯远了，用到的知识可以看看我的这篇文章

spreadButton?.setSubButtons([btn1, btn2, btn3, btn4, btn5])

4.根据你的需求，去定制这个SpreadButton，具体可以选什么参数，看看上面的Custom-made

spreadButton?.mode = SpreadMode.SpreadModeSickleSpread
spreadButton?.direction = SpreadDirection.SpreadDirectionRightUp
spreadButton?.positionMode = SpreadPositionMode.SpreadPositionModeFixed

/*  and you can assign a newValue to change the default
spreadButton?.animationDuring = 0.2
spreadButton?.animationDuringClose = 0.25
spreadButton?.radius = 180
spreadButton?.coverAlpha = 0.3
spreadButton?.coverColor = UIColor.yellowColor()  
spreadButton?.touchBorderMargin = 10.0
*/

5.每种动作的前后，都有对应的Block供使用，像这样给他们赋值:

spreadButton?.buttonWillSpreadBlock = { print(CGRectGetMaxY($0.frame)) }
spreadButton?.buttonDidSpreadBlock = { _ in print("did spread") }
spreadButton?.buttonWillCloseBlock = { _ in print("will closed") }
spreadButton?.buttonDidCloseBlock = { _ in print("did closed") }

6.最后加到你的view里面，ok，可以开始玩耍

if spreadButton != nil {
    self.view.addSubview(spreadButton!)
}

##License SpreadButton is released under the MIT license. See LICENSE for details.