Add support for callbacks

Author: kyleweiner

Demo/KWStepperDemo/Controllers/ViewController.swift

@@ -31,10 +31,6 @@ class ViewController: UIViewController, KWStepperDelegate {
             decrementButton: decrementButton,
             incrementButton: incrementButton)
 
-        stepper.addTarget(self,
-            action: "stepperDidChange",
-            forControlEvents: .ValueChanged)
-
         stepper.autoRepeat = true
         stepper.autoRepeatInterval = 0.10
         stepper.wraps = true
@@ -45,8 +41,20 @@ class ViewController: UIViewController, KWStepperDelegate {
         stepper.decrementStepValue = 1
 
         stepper.delegate = self
+        
+        stepper.valueChangedCallback = {
+            self.countLabel.text = NSString(format: "%.f", self.stepper.value)
+        }
+
+        stepper.decrementCallback = {
+            println("decrementCallback: The stepper did decrement")
+        }
+
+        stepper.incrementCallback = {
+            println("incrementCallback: The stepper did increment")
+        }
     }
-    
+
     func configureSwitches() {
         wrapsSwitch.on = stepper.wraps
         autoRepeatSwitch.on = stepper.autoRepeat
@@ -60,16 +68,28 @@ class ViewController: UIViewController, KWStepperDelegate {
             forControlEvents: .ValueChanged)
     }
 
-    // MARK: KWStepper Events
-
-    func stepperDidChange() {
-        countLabel.text = NSString(format: "%.f", stepper.value)
+    // MARK: KWStepperDelegate
+    
+    func KWStepperDidDecrement() {
+    }
+    
+    func KWStepperDidIncrement() {
+    }
+    
+    func KWStepperMaxValueClamped() {
+        println("KWStepperDelegate: Max value clamped")
+        stepperDidClampValue()
+    }
+    
+    func KWStepperMinValueClamped() {
+        println("KWStepperDelegate: Min value clamped")
+        stepperDidClampValue()
     }
 
     func stepperDidClampValue() {
         let minValue = NSString(format: "%.f", stepper.minimumValue)
         let maxValue = NSString(format: "%.f", stepper.maximumValue)
-
+        
         UIAlertView(
             title: "Stepper Limit Reached",
             message: "The step value was clamped, as it must be between \(minValue) and \(maxValue).",
@@ -78,26 +98,6 @@ class ViewController: UIViewController, KWStepperDelegate {
         ).show()
     }
 
-    // MARK: KWStepperDelegate Methods
-    
-    func KWStepperDidDecrement() {
-        println("The stepper did decrement")
-    }
-
-    func KWStepperDidIncrement() {
-        println("The stepper did increment")
-    }
-
-    func KWStepperMaxValueClamped() {
-        println("Max value clamped")
-        stepperDidClampValue()
-    }
-    
-    func KWStepperMinValueClamped() {
-        println("Min value clamped")
-        stepperDidClampValue()
-    }
-    
     // MARK: UISwitch Events
 
     func switchDidChange(sender: UISwitch) {

KWStepper.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name         = "KWStepper"
-  s.version      = "1.0.1"
+  s.version      = "1.2.0"
   s.summary      = "A stepper control with flexible UI and tailored UX."
   s.homepage     = "https://github.com/kyleweiner/KWStepper"
   s.license      = { :type => "MIT", :file => "LICENSE" }
@@ -11,5 +11,5 @@ Pod::Spec.new do |s|
   s.platform     = :ios
   s.ios.deployment_target = "8.0"
   s.requires_arc = true
-  s.description  = "KWStepper is a stepper control written in Swift. Unlike UIStepper, KWStepper allows for a fully customized UI and provides optional delegate methods for tailoring the UX."
+  s.description  = "KWStepper is a stepper control written in Swift. Unlike UIStepper, KWStepper allows for a fully customized UI and provides callbacks for tailoring the UX."
 end

KWStepper/KWStepper.swift

@@ -66,10 +66,18 @@ class KWStepper: UIControl {
                 if let delegate = delegate {
                     delegate.KWStepperDidIncrement?()
                 }
+                
+                if let callback = incrementCallback {
+                    callback()
+                }
             } else {
                 if let delegate = delegate {
                     delegate.KWStepperDidDecrement?()
                 }
+                
+                if let callback = decrementCallback {
+                    callback()
+                }
             }
 
             if value < minimumValue {
@@ -79,6 +87,10 @@ class KWStepper: UIControl {
             }
 
             sendActionsForControlEvents(.ValueChanged)
+            
+            if let callback = valueChangedCallback {
+                callback()
+            }
         }
     }
 
@@ -130,6 +142,31 @@ class KWStepper: UIControl {
         }
     }
 
+    /**
+    Executed when the value is changed.
+    */
+    var valueChangedCallback: (() -> ())?
+
+    /**
+    Executed when the value is decremented.
+    */
+    var decrementCallback: (() -> ())?
+
+    /**
+    Executed when the value is incremented.
+    */
+    var incrementCallback: (() -> ())?
+
+    /**
+    Executed when the max value is clamped.
+    */
+    var maxValueClampedCallback: (() -> ())?
+
+    /**
+    Executed when the min value is clamped.
+    */
+    var minValueClampedCallback: (() -> ())?
+
     var delegate:KWStepperDelegate? = nil
 
     // MARK: Private Variables
@@ -171,6 +208,10 @@ class KWStepper: UIControl {
             if let delegate = delegate {
                 delegate.KWStepperMinValueClamped?()
             }
+            
+            if let callack = minValueClampedCallback {
+                callack()
+            }
         }
     }
 
@@ -189,6 +230,10 @@ class KWStepper: UIControl {
             if let delegate = delegate {
                 delegate.KWStepperMaxValueClamped?()
             }
+            
+            if let callback = maxValueClampedCallback {
+                callback()
+            }
         }
     }
 

README.md

@@ -4,15 +4,21 @@
 [![License](https://img.shields.io/cocoapods/l/KWStepper.svg?style=flat)](https://raw.githubusercontent.com/kyleweiner/KWStepper/master/LICENSE)
 [![Platform](https://img.shields.io/cocoapods/p/KWStepper.svg?style=flat)](http://cocoapods.org/?q=kwstepper)
 
-KWStepper is a stepper control written in Swift. Unlike [UIStepper](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIStepper_Class/index.html), KWStepper allows for a fully customized UI and provides optional delegate methods for tailoring the UX.
+KWStepper is a stepper control written in Swift. Unlike [UIStepper](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIStepper_Class/index.html), KWStepper allows for a fully customized UI and provides callbacks for tailoring the UX.
 
 ![KWStepper Screenshot](screenshots.png)
 
  KWStepper was initially created in Objective-C for [Addo Label's](http://addolabel.com/) [Counters•](https://itunes.apple.com/app/id722416562?mt=8) and is now available in Swift for you to enjoy :)
 
+## Features
+
+* Allows for a fully customized UI.
+* Provides properties for setting different decrement and increment steps.
+* Offers optional callbacks for responding to control events and tailoring the UX.
+
 ## Installation
 
-KWStepper is available on [CocoaPods](http://cocoapods.org), but it doesn't yet work per [this issue](https://github.com/CocoaPods/CocoaPods/issues/2226). For now, simply copy the files in the `KWStepper` directory into your project.
+Simply copy the files in the `KWStepper` directory into your project.
 
 ## Usage
 
@@ -30,7 +36,19 @@ var stepper: KWStepper!
 stepper = KWStepper(
     decrementButton: decrementButton,
     incrementButton: incrementButton)
+```
+
+Respond to control events using the `valueChangedCallback` property.
+
+```swift
+stepper.valueChangedCallback = {
+    self.countLabel.text = NSString(format: "%.f", self.stepper.value)
+}
+```
+
+Or, use the target-action pattern.
 
+```swift
 stepper.addTarget(self,
     action: "stepperDidChange",
     forControlEvents: .ValueChanged)
@@ -42,13 +60,20 @@ func stepperDidChange() {
 }
 ```
 
-### Properties
+### Configuring KWStepper
 
-The properties of KWStepper are identical to [UIStepper](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIStepper_Class/index.html) with the following exceptions:
+With the exception of the `continuous` property, KWStepper offers everything provided by [UIStepper](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIStepper_Class/index.html) and more.
 
-* Instead of a single `stepValue` property, KWStepper provides `decrementStepValue` and `incrementStepValue` properties for setting different decrement and increment steps.
-* There is a `delegate` property that should be set when adhering to the [`KWStepperDelegate`](#kwstepperdelegate) protocol.
-* During user interaction, change events are sent immediately when the value changes–there is no `continuous` property. 
+```swift
+stepper.autoRepeat = true
+stepper.autoRepeatInterval = 0.10
+stepper.wraps = true
+stepper.minimumValue = 0
+stepper.maximumValue = 8
+stepper.value = 0
+stepper.incrementStepValue = 1
+stepper.decrementStepValue = 1
+```
 
 ### KWStepperDelegate
 
@@ -63,6 +88,18 @@ In the demo, `KWStepperMaxValueClamped()` and `KWStepperMinValueClamped()` are u
 
 In [Counters•](https://itunes.apple.com/app/id722416562?mt=8), `KWStepperDidDecrement()` and `KWStepperDidIncrement()` are used to play different sounds when decrementing and incrementing the steppers.
 
+### Callbacks
+
+As an alternative to the `KWStepperDelegate` protocol, KWStepper provides the following callbacks:
+
+* `valueChangedCallback`
+* `decrementCallback`
+* `incrementCallback`
+* `maxValueClampedCallback`
+* `minValueClampedCallback`
+
+
+
 ## Author
 
 KWStepper was written by Kyle Weiner.