NumberField

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
letnumberField=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
letsellingPrice= 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:

// 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, kenneth.tsang@me.com

License

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