Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/githawkapp/messageviewcontroller
A SlackTextViewController replacement written in Swift for the iPhone X.
https://github.com/githawkapp/messageviewcontroller
githawk ios swift uikit uitextview
Last synced: 5 days ago
JSON representation
A SlackTextViewController replacement written in Swift for the iPhone X.
- Host: GitHub
- URL: https://github.com/githawkapp/messageviewcontroller
- Owner: GitHawkApp
- License: mit
- Created: 2018-01-03T03:11:50.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2019-09-25T20:40:15.000Z (over 5 years ago)
- Last Synced: 2024-12-21T02:05:39.148Z (5 days ago)
- Topics: githawk, ios, swift, uikit, uitextview
- Language: Swift
- Homepage: http://githawk.com
- Size: 479 KB
- Stars: 1,676
- Watchers: 31
- Forks: 93
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
## Installation
Just add `MessageViewController` to your Podfile and install. Done!
```ruby
pod 'MessageViewController'
```
## Setup
You must subclass `MessageViewController`.
```swift
import MessageViewController
class ViewController: MessageViewController {
// ...
}
```
Finish setup using a `UIScrollView`. Remember this can also be a `UITableView` or `UICollectionView`.
```swift
func viewDidLoad() {
super.viewDidLoad()
setup(scrollView: scrollView)
}
```
## Customizations
You can customize any part of the UI that you want!
```swift
// Border between the text view and the scroll view
borderColor = .lightGray
// Change the appearance of the text view and its content
messageView.inset = UIEdgeInsets(top: 8, left: 16, bottom: 8, right: 16)
messageView.textView.placeholderText = "New message..."
messageView.textView.placeholderTextColor = .lightGray
messageView.font = .systemFont(ofSize: 17)
// Setup the button using text or an icon
messageView.set(buttonTitle: "Send", for: .normal)
messageView.addButton(target: self, action: #selector(onButton))
messageView.buttonTint = .blue
// Set custom attributes for an autocompleted string
let tintColor = .blue
messageAutocompleteController.autocompleteTextAttributes = ["@": [.font: UIFont.preferredFont(forTextStyle: .body), .foregroundColor: tintColor, .backgroundColor: tintColor.withAlphaComponent(0.1)]]
```
## Autocomplete
The base view controller uses a `MessageAutocompleteController` control to handle text autocompletion.
This control uses a plain `UITableView` to display its autocomplete. Add a `dataSource` and `delegate` to display and handle interactions.
```swift
let tableView = messageAutocompleteController.tableView
tableView.register(UITableViewCell.self, forCellReuseIdentifier: "cell")
tableView.dataSource = self
tableView.delegate = self
```
Then register for autocomplete prefixes you want to respond to and set a `delegate` to handle when a prefix is found.
```swift
messageAutocompleteController.register(prefix: "@")
messageAutocompleteController.delegate = self
```
Your delegate needs to implement just one method.
```swift
func didFind(controller: MessageAutocompleteController, prefix: String, word: String) {
// filter your data
controller.show(true)
}
```
> **Note:** You can perform asyncronous autocomplete searches. Just be sure to call `messageAutocompleteController.show()` when finished.
## Acknowledgements
- Heavy inspiration from [SlackTextViewController](https://github.com/slackhq/SlackTextViewController)
- Created with ❤️ by [Ryan Nystrom](https://twitter.com/_ryannystrom)