Emoji Keyboard for iOS
Clone or download
Latest commit 75dbf0e Oct 25, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Example Xcode 10 & Swift 4.2 Oct 22, 2018
ISEmojiView.xcodeproj bump v0.1.0 Aug 4, 2018
ISEmojiView bump v0.1.0 Aug 4, 2018
Source Merge pull request #33 from liyu-wang/master Oct 22, 2018
.gitignore create project Nov 8, 2016
CHANGELOG.md Add CHANGELOG.md Mar 27, 2017
ISEmojiView.podspec bump v0.1.2 Oct 25, 2018
LICENSE Initial commit Nov 8, 2016
README.md bump v0.1.2 Oct 25, 2018
logo@2x.jpg [ImgBot] optimizes images Aug 4, 2018
screenshot1.png Updated README.md Aug 4, 2018
screenshot2.png Updated README.md Aug 4, 2018

README.md

logo Version Carthage Compatible License Platform Swift

An easy to use Emoji keyboard for iOS.

Has been rewritten with swift, the old Objective-C version on branch oc.

Features

  • Written in Swift
  • Custom emojis
  • Multiple skin tone support (🏻🏼🏽🏾🏿)
  • Categories bottom bar (like iOS system emoji Keyboard)
  • Recently used emoji

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

  • Swift 4.2
  • iOS8+
  • Xcode 10

Useage

Installation

Cocoapods

# Swift
pod 'ISEmojiView'

# Objective-C
pod 'ISEmojiView', '0.0.1'

Carthage

github "isaced/ISEmojiView"

Import

import ISEmojiView

Initialization

let keyboardSettings = KeyboardSettings(bottomType: .categories)
let emojiView = EmojiView(keyboardSettings: keyboardSettings)
emojiView.translatesAutoresizingMaskIntoConstraints = false
emojiView.delegate = self
textView.inputView = emojiView

Delegate

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()
}

Customize

KeyboardSettings

This is a class to desribe keyboard settings. Available properties:

  • bottomType - type of bottom view. Available variants: .pageControl, .categories. See BottomType enum. Default .pageControl.
  • customEmojis - array of custom emojis. To describe emojis you have to use EmojiCategory 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 in Categories bottom view.

Others

If you are looking for a React Native solution, take a look at this brendan-rius/react-native-emoji-keyboard

License

MIT