English | 中文
An easy to use Emoji keyboard for iOS.
Has been rewritten with swift, the old Objective-C version on branch oc.
- Written in Swift
- Custom emojis
- Multiple skin tone support ( 🏻 🏼 🏽 🏾 🏿 )
- Categories bottom bar (like iOS system emoji Keyboard)
- Recently used emoji
- Dark Mode (#58)
- SwiftUI support.
To run the example project, clone the repo, and run pod install
from the Example directory first.
- Swift 5
- iOS8+
- Xcode 10
via Swift Package Manager Install to your project,Add in Package.swift:
.package(name: "ISEmojiView", url: "https://github.com/isaced/ISEmojiView.git", .upToNextMinor(from: "0.3.0")),
In Xcode:
- File > Swift Packages > Add Package Dependency
- Add https://github.com/isaced/ISEmojiView.git
- Select "Up to Next Major" with "0.3.0"
# Swift
pod 'ISEmojiView'
# Objective-C (Deprecated)
pod 'ISEmojiView', '0.0.1'
github "isaced/ISEmojiView"
import ISEmojiView
let keyboardSettings = KeyboardSettings(bottomType: .categories)
let emojiView = EmojiView(keyboardSettings: keyboardSettings)
emojiView.translatesAutoresizingMaskIntoConstraints = false
emojiView.delegate = self
textView.inputView = emojiView
Implement <EmojiViewDelegate>
// callback when tap a emoji on keyboard
func emojiViewDidSelectEmoji(_ emoji: String, emojiView: EmojiView) {
textView.insertText(emoji)
}
// callback when tap change keyboard button on keyboard
func emojiViewDidPressChangeKeyboardButton(_ emojiView: EmojiView) {
textView.inputView = nil
textView.keyboardType = .default
textView.reloadInputViews()
}
// callback when tap delete button on keyboard
func emojiViewDidPressDeleteBackwardButton(_ emojiView: EmojiView) {
textView.deleteBackward()
}
// callback when tap dismiss button on keyboard
func emojiViewDidPressDismissKeyboardButton(_ emojiView: EmojiView) {
textView.resignFirstResponder()
}
This is a class to desribe keyboard settings. Available properties:
bottomType
- type of bottom view. Available variants:.pageControl
,.categories
. SeeBottomType
enum. Default.pageControl
.customEmojis
- array of custom emojis. To describe emojis you have to useEmojiCategory
class.isShowPopPreview
- long press to pop preview effect like iOS10 system emoji keyboard. Default is true.countOfRecentsEmojis
- the max number of recent emojis, if set 0, nothing will be shown. Default is 50.needToShowAbcButton
- need to show change keyboard button. This button is located inCategories
bottom view.
Doesn't work on macOS SwiftUI natively.
import ISEmojiView
EmojiView_SwiftUI()
.frame(width: 300, height: 500)
.padding()
countOfRecentsEmojis
, needToShowAbcButton
, needToShowDeleteButton
, updateRecentEmojiImmediately
can be passed to EmojiView_SwiftUI as parameters.
If you are looking for a React Native solution, take a look at this brendan-rius/react-native-emoji-keyboard
MIT