NumberField 0.4.2

NumberField 0.4.2

×

TestsTested ✗
LangLanguage SwiftSwift
License MIT
ReleasedLast Release Oct 2018
SPMSupports SPM ✗

Maintained by Kenneth Tsang.

NumberField 0.4.2

  • By
  • Kenneth Tsang

NumberField

Version License Platform Language

Requirements

iOS 9.0 or above

Installation

CocoaPods

NumberField is available through CocoaPods. To install it, simply add the following line to your Podfile:

Swift 4.2

pod 'NumberField', '0.4.2'

Swift 4.0

pod 'NumberField', '0.4.0'

Usage

Programmatically

// Create NumberField instance
let numberField = NumberField()
numberField.maxValue = 99999.99
numberField.decimalPlace = 2
numberField.prefixLabel.text = "LENGTH"
numberField.suffixLabel.text = "cm"
addSubview(numberField)

// Set value
numberField.value = 123.45

// Get value
let sellingPrice = numberField.value

Storyboard

  1. Drag an UIView into Storyboard.
  2. Set class to NumberField.

NumberField Properties

Parameter Type Description Default
value Double Current value. 0
maxValue Double Maximum value. 0 means no limit. 0
decimalPlace Int Number of decimal places. 0 means integer. 0
valueLabel UILabel UILabel showing the value text. -
prefixLabel UILabel UILabel on the left side of value text. -
suffixLabel UILabel UILabel on the right side of value text. -
textAlignment NumberFieldAlignment Value text alignment. (.left / .right) .right
isPrefndSuffixStickToSides Bool True - Prefix and suffix will stick to left and right side.
False - Prefix and suffix will stick to the value text and will move as the value text size change.		 true

Basic Components

NumberField is constructed with 3 UILabel. You can customize them as you like:

LabelGuide

// Customize value label
numberField.valueLabel.font = UIFont.systemFont(ofSize: 20)

// customize prefix label
numberField.prefixLabel.text = "LENGTH"
numberField1.prefixLabel.font = UIFont.boldSystemFont(ofSize: 16)
numberField1.prefixLabel.textColor = UIColor.gray

// customize suffix label
numberField.suffixLabel.text = "cm"
numberField1.suffixLabel.font = UIFont.boldSystemFont(ofSize: 16)
numberField1.suffixLabel.textColor = UIColor.gray

Keyboard Customization

Parameter Type Description Default
keyboardHeight CGFloat Keyboard Height. 260
keyboardBorderColor UIColor Border line color between keyboard buttons. -
keyboardTextColor UIColor Text color of keyboard buttons. -
keyboardBackgroundColor UIColor Background color of keyboard buttons. -
keyboardDecimalPlaceColor UIColor Background color of decimal place button. -
keyboardBackspaceColor UIColor Background color of backspace button. -

Events

Listen to 4 UIControlEvents: editingDidBegin, editingDidEnd, editingChanged or editingRejected.

//Listen to editing begin:
numberField.addTarget(self, action: #selector(numberFieldEditingDidBegin), for: .editingDidBegin)

//Listen editing end:
numberField.addTarget(self, action: #selector(numberFieldEditingDidEnd), for: .editingDidEnd)

//Listen to value changed on edit.
numberField.addTarget(self, action: #selector(numberFieldEditingChanged), for: .editingChanged)

//Listen to value rejected on edit. i.e. Value exceeded maximum value.
numberField.addTarget(self, action: #selector(numberFieldEditingRejected), for: .editingRejected)

//Your functions:
func numberFieldEditingDidBegin(numberField: NumberField) { ... }
func numberFieldEditingDidEnd(numberField: NumberField) { ... }
func numberFieldEditingChanged(numberField: NumberField) { ... }
func numberFieldEditingRejected(numberField: NumberField) { ... }

Author

Kenneth Tsang, [email protected]

License

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