Awesome Open Source
Awesome Open Source

FormToolbar

Simple, movable and powerful toolbar for UITextField and UITextView.

GitHub release Language Carthage Compatible CocoaPods  Compatible

Sample GIF Capture
gif gif

Feature

  • Easy to use. (Just add inputs to toolbar).
  • available to use UITextField and UITextView. (mix ok!!)

Usage

Getting Started

  • ViewController has two text fields and one text view.
class ViewController: UIViewController {
    @IBOutlet private weak var emailTextField: UITextField!
    @IBOutlet private weak var passwordTextField: UITextField!
    @IBOutlet private weak var profileTextView: UITextView!
}
  • Create Toolbar (and attach toolbar to textfield's inputAccessoryView)
    self.toolbar = FormToolbar(inputs: [emailTextField, passwordTextField, profileTextView])
  • Call update() on UITextField's delegate method. (or UItextView's delegate method.)
func textFieldDidBeginEditing(_ textField: UITextField) {
    toolbar.updater()
}
  • "Is that all?" - Yeah, that is all. 👍

NOTE: There is demo project!!

Advanced

  • Back/Forward button type
toolbar.direction = .leftRight
toolbar.direction = .upDown

Left-Right
gif

Up-Down
gif

  • "Done" button's title
toolbar.doneButtonTitle = "👇"

gif

  • Change button color
toolbar.backButtonTintColor = .red
toolbar.forwardButtonTintColor = .green
toolbar.doneButtonTintColor = .purple

// or set all together
toolbar.setButtonsTintColor(.red)

gif

  • Get current/previous/next input
toolbar.currentInput
toolbar.previousInput
toolbar.nextInput

if let activeTextField = toolbar.currentInput as? UITextField {
    // ...
}
  • Update Inputs
let newInputs: [FormInput] = [emailTextField, passwordTextField]
toolbar.set(inputs: newInputs)
  • Go forward when UITextField's return key pressed
func textFieldShouldReturn(_ textField: UITextField) -> Bool {
    toolbar.goForward()
    return true
}

Requirements

  • iOS 9.0+
  • Xcode 8.2.1+
  • Swift 3.0+

Installation

Carthage

  • Add the following to your Cartfile:
github "sgr-ksmt/FormToolbar" ~> 1.0
  • Run carthage update
  • Add the framework as described.
    Details: Carthage Readme

CocoaPods

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

pod 'FormToolbar', '~> 1.0'

and run pod install

Manually Install

Download all *.swift files and put your project.

Change log

Change log is here.

Communication

  • If you found a bug, open an issue.
  • If you have a feature request, open an issue.
  • If you want to contribute, submit a pull request.💪

License

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


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Swift (95,446
Ios (19,263
Keyboard (1,598
Swift 3 (1,049
Easy To Use (856
Swift Library (406
Textview (261
Swift Framework (222
Toolbar (216
Textfield (146
Related Projects