英文 | 中文
一款易于使用的 iOS 表情键盘。
使用 Swift 重新编写,旧的 Objective-C 版本在分支 oc 上。
特性
- Swift 编写
- 自定义表情
- 支持多种肤色(🏻 🏼 🏽 🏾 🏿)
- 类别底部栏(类似 iOS 系统表情键盘)
- 最近使用表情
- 暗黑模式(《#58》)
- 支持 SwiftUI。
示例
要运行示例项目,请克隆仓库,并首先从 Example 目录运行 pod install
。
要求
- Swift 5
- iOS 8+
- Xcode 10
用法
安装
Swift 包管理器
通过 Swift 包管理器 引入到您的项目中,添加到 Package.swift:
.package(name: "ISEmojiView", url: "https://github.com/isaced/ISEmojiView.git", .upToNextMinor(from: "0.3.0")),
在 Xcode 中:
- 文件 > Swift 包 > 添加包依赖
- 添加 https://github.com/isaced/ISEmojiView.git
- 选择 "升级到下一个主版本" 并将 "0.3.0" 作为版本
CocoaPods
# Swift
pod 'ISEmojiView'
# Objective-C (Deprecated)
pod 'ISEmojiView', '0.0.1'
Carthage
github "isaced/ISEmojiView"
导入
import ISEmojiView
初始化
let keyboardSettings = KeyboardSettings(bottomType: .categories)
let emojiView = EmojiView(keyboardSettings: keyboardSettings)
emojiView.translatesAutoresizingMaskIntoConstraints = false
emojiView.delegate = self
textView.inputView = emojiView
委托
实现 <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()
}
自定义
键盘设置
这是一个描述键盘设置的类。可用的属性
bottomType
- 底部视图的类型。可用的变体:.pageControl
、.categories
。查看BottomType
枚举。默认.pageControl
。customEmojis
- 自定义表情符号数组。要描述表情符号,您必须使用EmojiCategory
类。isShowPopPreview
- 长按弹出预览效果,类似于 iOS10 系统表情符号键盘。默认为 true。countOfRecentsEmojis
- 最近表情符号的最大数量,如果设置为 0,则不显示任何内容。默认为 50。needToShowAbcButton
- 显示更改键盘按钮。此按钮位于Categories
底部视图。
其他
如果您正在寻找 React Native 解决方案,请查看此 brendan-rius/react-native-emoji-keyboard
许可
MIT