iOS 9.0 or above
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'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.valueStoryboard
- Drag an UIView into Storyboard.
- Set class to NumberField.
| 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 |
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| 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. | - |
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) { ... }Kenneth Tsang, kenneth.tsang@me.com
NumberField is available under the MIT license. See the LICENSE file for more info.