@@ -11,56 +11,79 @@ import UIKit
1111@IBDesignable public class GMStepper: UIControl {
1212
1313 /// Current value of the stepper. Defaults to 0.
14− public var value = 0 {
14+ @objc @IBInspectable public var value: Double = 0 {
1515 didSet {
1616 value = min(maximumValue, max(minimumValue, value))
17− label.text = String(value)
17+
18+ let isInteger = floor(value) == value
19+
20+ //
21+ // If we have items, we will display them as steps
22+ //
23+
24+ if isInteger && stepValue == 1.0 && items.count > 0 {
25+ label.text = items[Int(value)]
26+ }
27+ else if showIntegerIfDoubleIsInteger && isInteger {
28+ label.text = String(stringInterpolationSegment: Int(value))
29+ } else {
30+ label.text = String(stringInterpolationSegment: value)
31+ }
1832
1933 if oldValue != value {
20− sendActionsForControlEvents(.ValueChanged)
34+ sendActions(for: .valueChanged)
2135 }
2236 }
2337 }
2438
2539 /// Minimum value. Must be less than maximumValue. Defaults to 0.
26− @IBInspectable public var minimumValue: Int = 0 {
40+ @objc @IBInspectable public var minimumValue: Double = 0 {
2741 didSet {
28− value = 0
42+ value = min(maximumValue, max(minimumValue, value))
2943 }
3044 }
3145
32− /// Maximum value. Must be more than minimumValue. Defaults to 10.
33− @IBInspectable public var maximumValue: Int = 10 {
46+ /// Maximum value. Must be more than minimumValue. Defaults to 100.
47+ @objc @IBInspectable public var maximumValue: Double = 100 {
3448 didSet {
35− value = 0
49+ value = min(maximumValue, max(minimumValue, value))
3650 }
3751 }
3852
39− /// Text on the left button. Be sure that it fits in the button. Defaults to "-".
40− @IBInspectable public var leftButtonText: String = "-" {
53+ /// Step/Increment value as in UIStepper. Defaults to 1.
54+ @objc @IBInspectable public var stepValue: Double = 1
55+
56+ /// The same as UIStepper's autorepeat. If true, holding on the buttons or keeping the pan gesture alters the value repeatedly. Defaults to true.
57+ @objc @IBInspectable public var autorepeat: Bool = true
58+
59+ /// If the value is integer, it is shown without floating point.
60+ @objc @IBInspectable public var showIntegerIfDoubleIsInteger: Bool = true
61+
62+ /// Text on the left button. Be sure that it fits in the button. Defaults to "−".
63+ @objc @IBInspectable public var leftButtonText: String = "−" {
4164 didSet {
42− leftButton.setTitle(leftButtonText, forState: .Normal)
65+ leftButton.setTitle(leftButtonText, for: .normal)
4366 }
4467 }
4568
4669 /// Text on the right button. Be sure that it fits in the button. Defaults to "+".
47− @IBInspectable public var rightButtonText: String = "+" {
70+ @objc @IBInspectable public var rightButtonText: String = "+" {
4871 didSet {
49− rightButton.setTitle(rightButtonText, forState: .Normal)
72+ rightButton.setTitle(rightButtonText, for: .normal)
5073 }
5174 }
5275
5376 /// Text color of the buttons. Defaults to white.
54− @IBInspectable public var buttonsTextColor: UIColor = UIColor.whiteColor() {
77+ @objc @IBInspectable public var buttonsTextColor: UIColor = UIColor.white {
5578 didSet {
5679 for button in [leftButton, rightButton] {
57− button.setTitleColor(buttonsTextColor, forState: .Normal)
80+ button.setTitleColor(buttonsTextColor, for: .normal)
5881 }
5982 }
6083 }
6184
6285 /// Background color of the buttons. Defaults to dark blue.
63− @IBInspectable public var buttonsBackgroundColor: UIColor = UIColor(red:0.21, green:0.5, blue:0.74, alpha:1) {
86+ @objc @IBInspectable public var buttonsBackgroundColor: UIColor = UIColor(red:0.21, green:0.5, blue:0.74, alpha:1) {
6487 didSet {
6588 for button in [leftButton, rightButton] {
6689 button.backgroundColor = buttonsBackgroundColor
@@ -70,7 +93,7 @@ import UIKit
7093 }
7194
7295 /// Font of the buttons. Defaults to AvenirNext-Bold, 20.0 points in size.
73− public var buttonsFont = UIFont(name: "AvenirNext-Bold", size: 20.0)! {
96+ @objc public var buttonsFont = UIFont(name: "AvenirNext-Bold", size: 20.0)! {
7497 didSet {
7598 for button in [leftButton, rightButton] {
7699 button.titleLabel?.font = buttonsFont
@@ -79,95 +102,216 @@ import UIKit
79102 }
80103
81104 /// Text color of the middle label. Defaults to white.
82− @IBInspectable public var labelTextColor: UIColor = UIColor.whiteColor() {
105+ @objc @IBInspectable public var labelTextColor: UIColor = UIColor.white {
83106 didSet {
84107 label.textColor = labelTextColor
85108 }
86109 }
87110
88111 /// Text color of the middle label. Defaults to lighter blue.
89− @IBInspectable public var labelBackgroundColor: UIColor = UIColor(red:0.26, green:0.6, blue:0.87, alpha:1) {
112+ @objc @IBInspectable public var labelBackgroundColor: UIColor = UIColor(red:0.26, green:0.6, blue:0.87, alpha:1) {
90113 didSet {
91114 label.backgroundColor = labelBackgroundColor
92115 }
93116 }
94117
95118 /// Font of the middle label. Defaults to AvenirNext-Bold, 25.0 points in size.
96− public var labelFont = UIFont(name: "AvenirNext-Bold", size: 25.0)! {
119+ @objc public var labelFont = UIFont(name: "AvenirNext-Bold", size: 25.0)! {
97120 didSet {
98121 label.font = labelFont
99122 }
100123 }
124+ /// Corner radius of the middle label. Defaults to 0.
125+ @objc @IBInspectable public var labelCornerRadius: CGFloat = 0 {
126+ didSet {
127+ label.layer.cornerRadius = labelCornerRadius
128+
129+ }
130+ }
101131
102132 /// Corner radius of the stepper's layer. Defaults to 4.0.
103− @IBInspectable public var cornerRadius: CGFloat = 4.0 {
133+ @objc @IBInspectable public var cornerRadius: CGFloat = 4.0 {
104134 didSet {
105135 layer.cornerRadius = cornerRadius
106136 clipsToBounds = true
107137 }
108138 }
139+
140+ /// Border width of the stepper and middle label's layer. Defaults to 0.0.
141+ @objc @IBInspectable public var borderWidth: CGFloat = 0.0 {
142+ didSet {
143+ layer.borderWidth = borderWidth
144+ label.layer.borderWidth = borderWidth
145+ }
146+ }
147+
148+ /// Color of the border of the stepper and middle label's layer. Defaults to clear color.
149+ @objc @IBInspectable public var borderColor: UIColor = UIColor.clear {
150+ didSet {
151+ layer.borderColor = borderColor.cgColor
152+ label.layer.borderColor = borderColor.cgColor
153+ }
154+ }
109155
110156 /// Percentage of the middle label's width. Must be between 0 and 1. Defaults to 0.5. Be sure that it is wide enough to show the value.
111− @IBInspectable public var labelWidthWeight: CGFloat = 0.5 {
157+ @objc @IBInspectable public var labelWidthWeight: CGFloat = 0.5 {
112158 didSet {
113159 labelWidthWeight = min(1, max(0, labelWidthWeight))
114160 setNeedsLayout()
115161 }
116162 }
117163
164+ /// Color of the flashing animation on the buttons in case the value hit the limit.
165+ @objc @IBInspectable public var limitHitAnimationColor: UIColor = UIColor(red:0.26, green:0.6, blue:0.87, alpha:1)
166+
118167 /**
119168 Width of the sliding animation. When buttons clicked, the middle label does a slide animation towards to the clicked button. Defaults to 5.
120169 */
121− private let labelSlideLength: CGFloat = 5
170+ let labelSlideLength: CGFloat = 5
122171
123172 /// Duration of the sliding animation
124− private let labelSlideDuration: NSTimeInterval = 0.1
173+ let labelSlideDuration = TimeInterval(0.1)
174+
175+ /// Duration of the animation when the value hits the limit.
176+ let limitHitAnimationDuration = TimeInterval(0.1)
177+
178+ lazy var leftButton: UIButton = {
179+ let button = UIButton()
180+ button.setTitle(self.leftButtonText, for: .normal)
181+ button.setTitleColor(self.buttonsTextColor, for: .normal)
182+ button.backgroundColor = self.buttonsBackgroundColor
183+ button.titleLabel?.font = self.buttonsFont
184+ button.addTarget(self, action: #selector(GMStepper.leftButtonTouchDown), for: .touchDown)
185+ button.addTarget(self, action: #selector(GMStepper.buttonTouchUp), for: .touchUpInside)
186+ button.addTarget(self, action: #selector(GMStepper.buttonTouchUp), for: .touchUpOutside)
187+ button.addTarget(self, action: #selector(GMStepper.buttonTouchUp), for: .touchCancel)
188+ return button
189+ }()
190+
191+ lazy var rightButton: UIButton = {
192+ let button = UIButton()
193+ button.setTitle(self.rightButtonText, for: .normal)
194+ button.setTitleColor(self.buttonsTextColor, for: .normal)
195+ button.backgroundColor = self.buttonsBackgroundColor
196+ button.titleLabel?.font = self.buttonsFont
197+ button.addTarget(self, action: #selector(GMStepper.rightButtonTouchDown), for: .touchDown)
198+ button.addTarget(self, action: #selector(GMStepper.buttonTouchUp), for: .touchUpInside)
199+ button.addTarget(self, action: #selector(GMStepper.buttonTouchUp), for: .touchUpOutside)
200+ button.addTarget(self, action: #selector(GMStepper.buttonTouchUp), for: .touchCancel)
201+ return button
202+ }()
203+
204+ lazy var label: UILabel = {
205+ let label = UILabel()
206+ label.textAlignment = .center
207+ if self.showIntegerIfDoubleIsInteger && floor(self.value) == self.value {
208+ label.text = String(stringInterpolationSegment: Int(self.value))
209+ } else {
210+ label.text = String(stringInterpolationSegment: self.value)
211+ }
212+ label.textColor = self.labelTextColor
213+ label.backgroundColor = self.labelBackgroundColor
214+ label.font = self.labelFont
215+ label.layer.cornerRadius = self.labelCornerRadius
216+ label.layer.masksToBounds = true
217+ label.isUserInteractionEnabled = true
218+ let panRecognizer = UIPanGestureRecognizer(target: self, action: #selector(GMStepper.handlePan))
219+ panRecognizer.maximumNumberOfTouches = 1
220+ label.addGestureRecognizer(panRecognizer)
221+ return label
222+ }()
223+
224+ var labelOriginalCenter: CGPoint!
225+ var labelMaximumCenterX: CGFloat!
226+ var labelMinimumCenterX: CGFloat!
227+
228+ enum LabelPanState {
229+ case Stable, HitRightEdge, HitLeftEdge
230+ }
231+ var panState = LabelPanState.Stable
125232
126− /// Duration of the flashing animation when the value hits the limit.
127− private let limitHitAnimationDuration: NSTimeInterval = 0.1
233+ enum StepperState {
234+ case Stable, ShouldIncrease, ShouldDecrease
235+ }
236+ var stepperState = StepperState.Stable {
237+ didSet {
238+ if stepperState != .Stable {
239+ updateValue()
240+ if autorepeat {
241+ scheduleTimer()
242+ }
243+ }
244+ }
245+ }
246+
247+
248+ @objc public var items : [String] = [] {
249+ didSet {
250+ let isInteger = floor(value) == value
251+
252+ //
253+ // If we have items, we will display them as steps
254+ //
255+
256+ if isInteger && stepValue == 1.0 && items.count > 0 {
257+
258+ var value = Int(self.value)
259+
260+ if value >= items.count {
261+ value = items.count - 1
262+ self.value = Double(value)
263+ }
264+ else {
265+ label.text = items[value]
266+ }
267+ }
268+ }
269+ }
128270
129− /// Color of the flashing animation on the buttons in case the value hit the limit.
130− @IBInspectable public var limitHitAnimationColor: UIColor = UIColor(red:0.26, green:0.6, blue:0.87, alpha:1)
271+ /// Timer used for autorepeat option
272+ var timer: Timer?
131273
132− private let leftButton = UIButton()
133− private let rightButton = UIButton()
134− private let label = UILabel()
274+ /** When UIStepper reaches its top speed, it alters the value with a time interval of ~0.05 sec.
275+ The user pressing and holding on the stepper repeatedly:
276+ - First 2.5 sec, the stepper changes the value every 0.5 sec.
277+ - For the next 1.5 sec, it changes the value every 0.1 sec.
278+ - Then, every 0.05 sec.
279+ */
280+ let timerInterval = TimeInterval(0.05)
281+
282+ /// Check the handleTimerFire: function. While it is counting the number of fires, it decreases the mod value so that the value is altered more frequently.
283+ var timerFireCount = 0
284+ var timerFireCountModulo: Int {
285+ if timerFireCount > 80 {
286+ return 1 // 0.05 sec * 1 = 0.05 sec
287+ } else if timerFireCount > 50 {
288+ return 2 // 0.05 sec * 2 = 0.1 sec
289+ } else {
290+ return 10 // 0.05 sec * 10 = 0.5 sec
291+ }
292+ }
135293
136− required public init(coder aDecoder: NSCoder) {
294+ @objc required public init?(coder aDecoder: NSCoder) {
137295 super.init(coder: aDecoder)
138296 setup()
139297 }
140298
141− public override init(frame: CGRect) {
299+ @objc public override init(frame: CGRect) {
142300 super.init(frame: frame)
143301 setup()
144302 }
145303
146− private func setup() {
147− leftButton.setTitle(leftButtonText, forState: .Normal)
148− leftButton.setTitleColor(buttonsTextColor, forState: .Normal)
149− leftButton.backgroundColor = buttonsBackgroundColor
150− leftButton.titleLabel?.font = buttonsFont
151− leftButton.addTarget(self, action: "leftButtonTapped:", forControlEvents: .TouchDown)
304+ func setup() {
152305 addSubview(leftButton)
153−
154− rightButton.setTitle(rightButtonText, forState: .Normal)
155− rightButton.setTitleColor(buttonsTextColor, forState: .Normal)
156− rightButton.backgroundColor = buttonsBackgroundColor
157− rightButton.titleLabel?.font = buttonsFont
158− rightButton.addTarget(self, action: "rightButtonTapped:", forControlEvents: .TouchDown)
159306 addSubview(rightButton)
160−
161− label.textAlignment = .Center
162− label.text = String(value)
163− label.textColor = labelTextColor
164− label.backgroundColor = labelBackgroundColor
165− label.font = labelFont
166307 addSubview(label)
167308
168309 backgroundColor = buttonsBackgroundColor
169310 layer.cornerRadius = cornerRadius
170311 clipsToBounds = true
312+ labelOriginalCenter = label.center
313+
314+ NotificationCenter.default.addObserver(self, selector: #selector(GMStepper.reset), name: NSNotification.Name.UIApplicationWillResignActive, object: nil)
171315 }
172316
173317 public override func layoutSubviews() {
@@ -177,51 +321,201 @@ import UIKit
177321 leftButton.frame = CGRect(x: 0, y: 0, width: buttonWidth, height: bounds.size.height)
178322 label.frame = CGRect(x: buttonWidth, y: 0, width: labelWidth, height: bounds.size.height)
179323 rightButton.frame = CGRect(x: labelWidth + buttonWidth, y: 0, width: buttonWidth, height: bounds.size.height)
324+
325+ labelMaximumCenterX = label.center.x + labelSlideLength
326+ labelMinimumCenterX = label.center.x - labelSlideLength
327+ labelOriginalCenter = label.center
328+ }
329+
330+ func updateValue() {
331+ if stepperState == .ShouldIncrease {
332+ value += stepValue
333+ } else if stepperState == .ShouldDecrease {
334+ value -= stepValue
335+ }
336+ }
337+
338+ deinit {
339+ resetTimer()
340+ NotificationCenter.default.removeObserver(self)
341+ }
342+
343+ /// Useful closure for logging the timer interval. You can call this in the timer handler to test the autorepeat option. Not used in the current implementation.
344+// lazy var printTimerGaps: () -> () = {
345+// var prevTime: CFAbsoluteTime?
346+//
347+// return { _ in
348+// var now = CFAbsoluteTimeGetCurrent()
349+// if let prevTime = prevTime {
350+// print(now - prevTime)
351+// }
352+// prevTime = now
353+// }
354+// }()
355+}
356+
357+// MARK: Pan Gesture
358+extension GMStepper {
359+ @objc func handlePan(gesture: UIPanGestureRecognizer) {
360+ switch gesture.state {
361+ case .began:
362+ leftButton.isEnabled = false
363+ rightButton.isEnabled = false
364+ case .changed:
365+ let translation = gesture.translation(in: label)
366+ gesture.setTranslation(CGPoint.zero, in: label)
367+
368+ let slidingRight = gesture.velocity(in: label).x > 0
369+ let slidingLeft = gesture.velocity(in: label).x < 0
370+
371+ // Move the label with pan
372+ if slidingRight {
373+ label.center.x = min(labelMaximumCenterX, label.center.x + translation.x)
374+ } else if slidingLeft {
375+ label.center.x = max(labelMinimumCenterX, label.center.x + translation.x)
376+ }
377+
378+ // When the label hits the edges, increase/decrease value and change button backgrounds
379+ if label.center.x == labelMaximumCenterX {
380+ // If not hit the right edge before, increase the value and start the timer. If already hit the edge, do nothing. Timer will handle it.
381+ if panState != .HitRightEdge {
382+ stepperState = .ShouldIncrease
383+ panState = .HitRightEdge
384+ }
385+
386+ animateLimitHitIfNeeded()
387+ } else if label.center.x == labelMinimumCenterX {
388+ if panState != .HitLeftEdge {
389+ stepperState = .ShouldDecrease
390+ panState = .HitLeftEdge
391+ }
392+
393+ animateLimitHitIfNeeded()
394+ } else {
395+ panState = .Stable
396+ stepperState = .Stable
397+ resetTimer()
398+
399+ self.rightButton.backgroundColor = self.buttonsBackgroundColor
400+ self.leftButton.backgroundColor = self.buttonsBackgroundColor
401+ }
402+ case .ended, .cancelled, .failed:
403+ reset()
404+ default:
405+ break
406+ }
180407 }
181408
182− @objc private func leftButtonTapped(button: UIButton) {
409+ @objc func reset() {
410+ panState = .Stable
411+ stepperState = .Stable
412+ resetTimer()
413+
414+ leftButton.isEnabled = true
415+ rightButton.isEnabled = true
416+ label.isUserInteractionEnabled = true
417+
418+ UIView.animate(withDuration: self.labelSlideDuration, animations: {
419+ self.label.center = self.labelOriginalCenter
420+ self.rightButton.backgroundColor = self.buttonsBackgroundColor
421+ self.leftButton.backgroundColor = self.buttonsBackgroundColor
422+ })
423+ }
424+}
425+
426+// MARK: Button Events
427+extension GMStepper {
428+ @objc func leftButtonTouchDown(button: UIButton) {
429+ rightButton.isEnabled = false
430+ label.isUserInteractionEnabled = false
431+ resetTimer()
432+
183433 if value == minimumValue {
184− animateLimitHitForButton(leftButton)
434+ animateLimitHitIfNeeded()
185435 } else {
186− value -= 1
436+ stepperState = .ShouldDecrease
187437 animateSlideLeft()
188438 }
439+
189440 }
190441
191− @objc private func rightButtonTapped(button: UIButton) {
442+ @objc func rightButtonTouchDown(button: UIButton) {
443+ leftButton.isEnabled = false
444+ label.isUserInteractionEnabled = false
445+ resetTimer()
446+
192447 if value == maximumValue {
193− animateLimitHitForButton(rightButton)
448+ animateLimitHitIfNeeded()
194449 } else {
195− value += 1
450+ stepperState = .ShouldIncrease
196451 animateSlideRight()
197452 }
198453 }
199454
200− private func animateSlideLeft() {
201− UIView.animateWithDuration(labelSlideDuration, animations: {
455+ @objc func buttonTouchUp(button: UIButton) {
456+ reset()
457+ }
458+}
459+
460+// MARK: Animations
461+extension GMStepper {
462+
463+ func animateSlideLeft() {
464+ UIView.animate(withDuration: labelSlideDuration) {
202465 self.label.center.x -= self.labelSlideLength
203− }, completion: { _ in
204− UIView.animateWithDuration(self.labelSlideDuration, animations: {
205− self.label.center.x += self.labelSlideLength
206− })
207− })
466+ }
208467 }
209468
210− private func animateSlideRight() {
211− UIView.animateWithDuration(labelSlideDuration, animations: {
469+ func animateSlideRight() {
470+ UIView.animate(withDuration: labelSlideDuration) {
212471 self.label.center.x += self.labelSlideLength
213− }, completion: { _ in
214− UIView.animateWithDuration(self.labelSlideDuration, animations: {
215− self.label.center.x -= self.labelSlideLength
216− })
217− })
472+ }
473+ }
474+
475+ func animateToOriginalPosition() {
476+ if self.label.center != self.labelOriginalCenter {
477+ UIView.animate(withDuration: labelSlideDuration) {
478+ self.label.center = self.labelOriginalCenter
479+ }
480+ }
481+ }
482+
483+ func animateLimitHitIfNeeded() {
484+ if value == minimumValue {
485+ animateLimitHitForButton(button: leftButton)
486+ } else if value == maximumValue {
487+ animateLimitHitForButton(button: rightButton)
488+ }
218489 }
219490
220− private func animateLimitHitForButton(button: UIButton){
221− UIView.animateWithDuration(limitHitAnimationDuration, animations: {
491+ func animateLimitHitForButton(button: UIButton){
492+ UIView.animate(withDuration: limitHitAnimationDuration) {
222493 button.backgroundColor = self.limitHitAnimationColor
223− }, completion: { _ in
224− button.backgroundColor = self.buttonsBackgroundColor
225− })
494+ }
226495 }
227496}
497+
498+// MARK: Timer
499+extension GMStepper {
500+ @objc func handleTimerFire(timer: Timer) {
501+ timerFireCount += 1
502+
503+ if timerFireCount % timerFireCountModulo == 0 {
504+ updateValue()
505+ }
506+ }
507+
508+ func scheduleTimer() {
509+ timer = Timer.scheduledTimer(timeInterval: timerInterval, target: self, selector: #selector(GMStepper.handleTimerFire), userInfo: nil, repeats: true)
510+ }
511+
512+ func resetTimer() {
513+ if let timer = timer {
514+ timer.invalidate()
515+ self.timer = nil
516+ timerFireCount = 0
517+ }
518+ }
519+
520+
521+}