Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/adboco/keyboard
Keyboard makes easy to use inputAccessoryView in UIViewController, UITextView, UITextField and UISearchBar.
https://github.com/adboco/keyboard
cocoapods ios ios-app keyboard-layout mit-license pods swift swift-4 swift-library swift4 xcode xcode9
Last synced: 3 months ago
JSON representation
Keyboard makes easy to use inputAccessoryView in UIViewController, UITextView, UITextField and UISearchBar.
- Host: GitHub
- URL: https://github.com/adboco/keyboard
- Owner: adboco
- License: mit
- Created: 2018-05-14T10:44:31.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-11-14T16:00:04.000Z (about 3 years ago)
- Last Synced: 2024-10-12T15:01:41.288Z (3 months ago)
- Topics: cocoapods, ios, ios-app, keyboard-layout, mit-license, pods, swift, swift-4, swift-library, swift4, xcode, xcode9
- Language: Swift
- Size: 43 KB
- Stars: 4
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Keyboard
[](https://cocoapods.org/pods/KeyboardSwift)
[](https://cocoapods.org/pods/KeyboardSwift)
[](https://cocoapods.org/pods/KeyboardSwift)
[](https://cocoapods.org/pods/KeyboardSwift)
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fadboco%2FKeyboard?ref=badge_shield)
## Example
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## Requirements
* Xcode 9.0+
* iOS 8.0+
## Installation
Keyboard is available through [CocoaPods](https://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'KeyboardSwift'
```
## Usage
```swift
import KeyboardSwift
```
You can use Keyboard in ``UIViewController`` or any ``UIView`` with ``inputAccessoryView`` (``UITextField``, ``UISearchBar``, ``UITextView``). Simply call ``keyboard`` and configure it with the items you want. An example:
```swift
let cancelItem = KeyboardItem.barButton(title: "Cancel", style: .plain) { item in
// Called when cancel item is tapped
self.textView.endEditing(true)
}
let countLabel = UILabel()
countLabel.text = "0"
let labelItem = KeyboardItem.custom(view: countLabel)
let doneItem = KeyboardItem.barButton(title: "Done", style: .done) { item in
// Called when done item is tapped
self.textView.endEditing(true)
}
textView.keyboard.with(items: cancelItem, .flexibleSpace, labelItem, .flexibleSpace, doneItem)
```
### KeyboardItem
```swift
/// Default bar button item
case barButton(title: String, style: UIBarButtonItemStyle, action: UIBarButtonItemTargetClosure?)
/// System bar button item
case systemBarButton(system: UIBarButtonSystemItem, action: UIBarButtonItemTargetClosure?)
/// Flexible space
case flexibleSpace
/// Fixed space
case fixedSpace(width: CGFloat)
/// Custom view
case custom(view: UIView)
```
### Customize
You can customize the ``accessoryView`` calling ``customize`` method:
```swift
textView.keyboard.customize { (toolbar, items) in
toolbar.isTranslucent = false
toolbar.tintColor = .purple
}
```
### Keyboard Events
Only available in ``UIViewController`` or subclass:
```swift
case willShow
case willHide
case didShow
case didHide
```
Example:
```swift
override func viewDidLoad() {
super.viewDidLoad()
// Subscribe
self.keyboard.subscribe(to: .willShow) { sender in
// TODO: something to do when keyboard will be shown
}
// ...
// Unsubscribe
self.keyboard.unsubscribe()
}
```
## Author
[email protected], Adrián Bouza Correa
## License
Keyboard is available under the MIT license. See the LICENSE file for more info.
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fadboco%2FKeyboard?ref=badge_large)