[]()
# InputBarAccessoryView
### Features
- [x] Autocomplete text with @mention, #hashtag or any other prefix
- [x] A self-sizing `UITextView` with an optional fixed height (can be replaced with any other view)
- [x] Image paste support
- [x] Autocomplete attributed text highlighting
- [x] Reactive components that respond to given events
- [x] Top/Bottom/Left/Right `InputStackView`s that act as toolbars to place buttons
- [x] `RxSwift`/`RxCocoa` Support with `RxExtensions` Cocoapod subspec
- [x] Drop in attachment view for file/photo management
- [x] Plugin support for your own `InputPlugin`s
- [x] Compatible with all iPhones and iPads
- [x] RTL Support
### Installation via CocoaPods
```ruby
# Swift 5.0
pod 'InputBarAccessoryView'
# Swift 4.2
pod 'InputBarAccessoryView', '4.2.2'
```
### Installation via Carthage
```ruby
# Swift 5.0
github "nathantannar4/InputBarAccessoryView"
# Swift 4.2
github "nathantannar4/InputBarAccessoryView" "4.2.2"
```
### Requirements
iOS 9.0+
Swift 5.0
> The latest Swift 4.2 release is v4.2.2
### Documentation
[Getting Started](./GETTING_STARTED.md)
> See the Example project to see how you can make the iMessage, Slack, Facebook and GitHawk input bars!
### Example Usage
### Featured In
Add your app to the list of apps using this library and make a pull request.
- [MessageKit](https://github.com/MessageKit/MessageKit) *(renamed to MessageInputBar)*
- [MessageViewController](https://github.com/GitHawkApp/MessageViewController) *(Autocomplete Highlighting Algorithm)*
### See Also
iMessage style [TypingIndicator](https://github.com/nathantannar4/TypingIndicator) for chat apps
## Latest Releases
- 4.3.1
- Add `RxSwift`/`RxCocoa` support through extensions and delegate proxies, requires Cocoapods installation of `InputBarAccessoryView/RxExtensions`
- 4.3.0
- Swift 5 support
- 4.2.2
- Fixed image paste orientation issue in `InputTextView`
- 4.2.1
- Fixed autocompletes of completions that contain spaces
- Depricated `isCaseSensitive` in favor of a function asignment to pre-process autocompletions
- 4.2.0
- Added new API for overriding the main middle view, normally the `InputTextView` so it can be replaced with views such as a "Join" button", `setMiddleContentView(_ view: UIView?, animated: Bool)`
- 4.1.2
- Add `InputBarViewController` which contains an `InputBarAccessoryView` as the `inputAccessoryView` by default with a convenient `isInputBarHidden: Bool` property to show/hide it
- 4.1.1
- Add `frameInsets: HorizontalEdgePadding` property to `InputBarAccessoryView` to inset the view to be compatible with `UISplitViewController` or other custom containers where the view should not be the full width
- 4.1.0
- Fix issue where setting long strings in `viewDidLoad` broke inital layout, Issue #41
- Add `deleteCompletionByParts: Bool` flag to `AutocompleteManager` to allow for partial deletions of autocompletes rather than just the entire substring.
- Add `InputBarSendButton` to use as the `sendButton` in `InputBarAccessoryView`. This subclass of `InputBarButtonItem` has a `UIActivityIndicatorView` to show a spinner when making HTTP requests
### [CHANGELOG](./CHANGELOG.md)
**Find a bug? Open an issue!**
## Layout
The layout of the `InputBarAccessoryView` is made of of 4 `InputStackView`'s and an `InputTextView`. The padding of the subviews can be easily adjusted by changing the `padding` and `textViewPadding` properties. The constraints will automatically be updated.
It is important to note that each of the `InputStackView `'s to the left and right of the `InputTextView` are anchored by a width constraint. This way the `InputTextView` will always fill the space inbetween in addition to providing methods that can easily be called to hide all buttons to the right or left of the `InputTextView` by setting the width constraint constant to 0. The bottom and top stack views are not height constraint and rely on their `intrinsicContentSize`
```swift
func setLeftStackViewWidthConstant(to newValue: CGFloat, animated: Bool)
func setRightStackViewWidthConstant(to newValue: CGFloat, animated: Bool)
```
### Reactive Hooks
Each `InputBarButtonItem` has properties that can hold actions that will be executed during various hooks such as the button being touched, the `UITextView `text changing and more! Thanks to these easy hooks with a few lines of code the items can be easily resized and animated similar to that of the Facebook messenger app.
```swift
// MARK: - Hooks
public typealias InputBarButtonItemAction = ((InputBarButtonItem) -> Void)
private var onTouchUpInsideAction: InputBarButtonItemAction?
private var onKeyboardEditingBeginsAction: InputBarButtonItemAction?
private var onKeyboardEditingEndsAction: InputBarButtonItemAction?
private var onKeyboardSwipeGestureAction: ((InputBarButtonItem, UISwipeGestureRecognizer) -> Void)?
private var onTextViewDidChangeAction: ((InputBarButtonItem, InputTextView) -> Void)?
private var onSelectedAction: InputBarButtonItemAction?
private var onDeselectedAction: InputBarButtonItemAction?
private var onEnabledAction: InputBarButtonItemAction?
private var onDisabledAction: InputBarButtonItemAction?
```
## Author
**Nathan Tannar** - [https://nathantannar.me](https://nathantannar.me)
## License
Distributed under the MIT license. See ``LICENSE`` for more information.