https://github.com/kbiakov/kbnumberpad
Custom iOS number pad with embedding as input view.
https://github.com/kbiakov/kbnumberpad
cocoapod cocoapods custom-view ios ios-lib ios-library ios-swift ios-ui number-pad swift swift-3 swift-library
Last synced: about 2 months ago
JSON representation
Custom iOS number pad with embedding as input view.
- Host: GitHub
- URL: https://github.com/kbiakov/kbnumberpad
- Owner: kbiakov
- License: apache-2.0
- Created: 2017-05-14T13:15:52.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-01-14T15:56:44.000Z (over 7 years ago)
- Last Synced: 2025-02-02T15:51:30.175Z (4 months ago)
- Topics: cocoapod, cocoapods, custom-view, ios, ios-lib, ios-library, ios-swift, ios-ui, number-pad, swift, swift-3, swift-library
- Language: Swift
- Homepage:
- Size: 90.8 KB
- Stars: 20
- Watchers: 3
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# KBNumberPad (iOS)
[](https://travis-ci.org/kbiakov/KBNumberPad)
[](http://cocoapods.org/pods/KBNumberPad)
[](http://cocoapods.org/pods/KBNumberPad)
[](http://cocoapods.org/pods/KBNumberPad)
KBNumberPad is a customizable number pad as replacement of default.
## Example
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## Requirements
- Xcode 8.0+
- iOS 9.0+
- Swift 3.0+
## Setup
### CocoaPods
KBNumberPad is available through [CocoaPods](http://cocoapods.org), dependency manager for Cocoa projects. To install it, run the command:
```bash
$ gem install cocoapods
```
To integrate KBNumberPad into your Xcode project using CocoaPods, specify it in your `Podfile`:
```ruby
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
use_frameworks!
target '' do
pod 'KBNumberPad', '~> 1.0.1'
end
```
Then, run the following command:
```bash
$ pod install
```
## Usage
1. Create input view (and customize, see section below):
```Swift
let numberPad = KBNumberPad()
```
2. Set as input view for your text field (or other):
```Swift
textField.inputView = numberPad
```
3. Set delegate:
```Swift
numberPad.delegate = self
```
4. Define behavior of 3 callbacks:
```Swift
func onNumberClicked(numberPad: KBNumberPad, number: Int) {}
func onDoneClicked(numberPad: KBNumberPad) {}
func onClearClicked(numberPad: KBNumberPad) {}
```
### Customization
You can customize base components of this number pad view as follows:
```Swift
numberPad.setDelimiterColor(UIColor.lightGray)
numberPad.setButtonsColor(UIColor.black)
numberPad.setButtonsBackgroundColor(UIColor.white)
```
This snippet shows that all buttons grouped, but there are methods to do setup separately like:
```Swift
numberPad.setNumberButtonsColor(UIColor.black)
numberPad.setClearButtonColor(UIColor.darkGray)
numberPad.setDoneButtonColor(UIColor.darkGray)
```
There is params to customize: it's __color__ of grouped or all buttons, __font__ & __background__.
Also you can change the __icon__ for clear button.
## Screenshots
[](https://postimg.org/image/7wcjn42rz/)
[](https://postimg.org/image/qwek3sq1v/)
[](https://postimg.org/image/jx6p7mo0p/)
## Author
### [Kirill Biakov](https://github.com/kbiakov)
## License
KBNumberPad is available under the [Apache License 2.0](https://github.com/kbiakov/KBNumberPad/blob/master/LICENSE) license.