ruddfawcett / rfkeyboardtoolbar

[iOS] Add customized buttons and toolbars to your UITextInputs.

RFKeyboardToolbar

This is a flexible UIView and UIButton subclass to add customized buttons and toolbars to your UITextFields/UITextViews. This project was inspired by the toolbar seen in iOctocat.

Installation

Installation with CocoaPods

CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries like RFKeyboardToolbar in your projects.

Podfile

platform :ios, '7.0'
pod "RFKeyboardToolbar", "~> 1.3"

Installation without CocoaPods

Just drag the RFKeyboardToolbar folder into your project and import it.

#import 'RFKeyboardToolbar.h'

Use

RFKeyboardToolbar is pretty easy to use with your UITextFields or UITextViews. After you've imported RFKeyboardToolbar, you can add a toolbar to anything that has an inputAccessoryView.

I've commented on the initialization below, to help you get a better understanding of it.

// Create a new RFToolbarButton
RFToolbarButton *exampleButton = [RFToolbarButton buttonWithTitle:@"Example"];

// Add a button target to the exampleButton
[exampleButton addEventHandler:^{
    // Do anything in this block here
    [_textView insertText:@"You pressed a button!"];
} forControlEvents:UIControlEventTouchUpInside];

// Create an RFKeyboardToolbar, adding all of your buttons, and set it as your inputAcessoryView
_textView.inputAccessoryView = [RFKeyboardToolbar toolbarWithButtons:@[exampleButton]];

// Add the UITextView/UITextField
[self.view addSubview:_textView];

Hope you enjoy it! Please Fork and send Pull Requests!

Screenshots

Contributors

• [Rudd Fawcett (@ruddfawcett)] (https://github.com/ruddfawcett) - Creator
• [Brandon Butler (@Hackmodford)] (https://github.com/Hackmodford)
• [Jesús A. Álvarez (@zydeco)] (https://github.com/zydeco)

License

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

rfkeyboardtoolbar's Issues

Update Podspec and Release Tag

Podspec should be updated to 1.3, and tag should be released for v1.3.

move toolbar one button left

It's not an issue but a question.

is it possible to move toolbar one button left so the second one appear first.
if user swipe to right the first one appear.

Thank you.

Filter

Hi
is it possible to filter the toolbar button based on what use type in the field? (contains caracter)

Thanks

The user has to tap on the spacing between the buttons to scroll.

I have many buttons on my toolbar, when I try to scroll it, I found that I cannot scroll it unless I start my touch on the the little spaces between the buttons, otherwise the button that I touched will be pressed.

Can this somehow be handled? If the gesture is a pan, can the button not be triggered and instead the toolbar will scroll?

Use an image as the button?

I want to use a picture of a slanted "I" as a button on the toolbar, like this:

I can't find any constructors that accept an image, so i tried this:

let italicButton = RFToolbarButton(title: "", andEventHandler: { 
  // function
}, for: .touchUpInside)!
italicButton.setImage(UIImage(named: "italic"), for: .normal)
italicButton.setImage(UIImage(named: "ialic"), for: .highlighted)
textView.inputAccessoryView = RFKeyboardToolbar(buttons: [italicButton])

But the button did not appear on the toolbar.

Content Inset not working on left side

This may just be my issue, but it appears that the contentInset is not being set initially when adding a lot of buttons, or possible one button (untested).

See this demo screenshot:

You are able to scroll, and when scrolling back, you get the proper contentInset, however, not initially.

Small Issues

Hello and thanks for the excellent library.
There is a small issue in the example when in the viewdidload method
you are calling a non existing method:
this:

[RFKeyboardToolbar addToolbarTo:_textView withButtons:@[exampleButton]];

should be:

[RFKeyboardToolbar addToTextView:_textView withButtons:@[exampleButton]];

also on the RFExampleToolbarButton the

[[RFToolbarButton textInput] insertText:@"Example text."];

seems to be an unknown selector

maybe what you wanted to have there is:

 [[RFToolbarButton textView] insertText:@"Example text."];

thanks
Konstantinos

Make the buttons center-aligned

Is there a way to make the buttons center aligned? Right now, all the buttons are on the left (left aligned). People have to move their hands a lot to tap on them on a really wide screen.

Spacing of items in toolbar

Is it possible to hardcode the position of the items in the toolbar?

I'm thinking of something like this:

Dynamic_string_button............................................Bold...Italic...
The Dynamic_string_button is used as a sort of pseudo autocorrect based on a prepopulated list of words (appears based on what the user types). Bold and Italic button are used to modify the textView.

If the Dynamic_string_button doesn't match any keywords, then only Bold/Italic is shown, but they are still aligned to the right, so something like:

.....................................................Bold....Italic