Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/isaced/ISEmojiView

Emoji Keyboard for iOS
https://github.com/isaced/ISEmojiView

emoji emoji-keyboard swift

Last synced: 3 months ago
JSON representation

Emoji Keyboard for iOS

Host: GitHub
URL: https://github.com/isaced/ISEmojiView
Owner: isaced
License: mit
Created: 2014-12-25T06:42:40.000Z (almost 10 years ago)
Default Branch: master
Last Pushed: 2024-07-04T17:15:49.000Z (4 months ago)
Last Synced: 2024-07-18T15:24:37.292Z (4 months ago)
Topics: emoji, emoji-keyboard, swift
Language: Swift
Size: 1 MB
Stars: 507
Watchers: 15
Forks: 116
Open Issues: 12
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

awesome-ios - ISEmojiView - Emoji Keyboard for iOS (UI / Keyboard)
awesome-swift - ISEmojiView - Emoji Keyboard for iOS (Libs / Keyboard)
awesome-ios-star - ISEmojiView - Emoji Keyboard for iOS (UI / Keyboard)
fucking-awesome-swift - ISEmojiView - Emoji Keyboard for iOS (Libs / Keyboard)

README

        ![ISEmojiView logo](/[email protected])

[![Version](https://img.shields.io/cocoapods/v/ISEmojiView.svg?style=flat)](http://cocoapods.org/pods/ISEmojiView)

[![License](https://img.shields.io/cocoapods/l/ISEmojiView.svg?style=flat)](http://cocoapods.org/pods/ISEmojiView)

[![Platform](https://img.shields.io/cocoapods/p/ISEmojiView.svg?style=flat)](http://cocoapods.org/pods/ISEmojiView)

[![Carthage Compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

[![SPM supported](https://img.shields.io/badge/SPM-supported-DE5C43.svg?style=flat")](https://swift.org/package-manager/)

English | [中文](/README_zh.md)

An easy to use Emoji keyboard for iOS.

Has been rewritten with swift, the old *Objective-C* version on branch [oc](https://github.com/isaced/ISEmojiView/tree/oc).

 

## Features

- [x] Written in Swift

- [x] Custom emojis

- [x] Multiple skin tone support (  🏻 🏼 🏽 🏾 🏿 )

- [x] Categories bottom bar (like iOS system emoji Keyboard)

- [x] Recently used emoji

- [x] Dark Mode ([#58](https://github.com/isaced/ISEmojiView/issues/58))

- [x] SwiftUI support.

## Example

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

## Requirements

- Swift 5

- iOS8+

- Xcode 10

## Useage

### Installation

#### Swift Package Manager

via [Swift Package Manager](https://swift.org/package-manager/) Install to your project，Add in Package.swift：

```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"

#### Cocoapods

```Ruby

# Swift

pod 'ISEmojiView'

# Objective-C (Deprecated)

pod 'ISEmojiView', '0.0.1'

```

#### Carthage

```Ruby

github "isaced/ISEmojiView"

```

### Import

```Swift

import ISEmojiView

```

### Initialization

```Swift

let keyboardSettings = KeyboardSettings(bottomType: .categories)

let emojiView = EmojiView(keyboardSettings: keyboardSettings)

emojiView.translatesAutoresizingMaskIntoConstraints = false

emojiView.delegate = self

textView.inputView = emojiView

```

### Delegate

Implement ``

```Swift

// 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.

### SwiftUI

Doesn't work on macOS SwiftUI natively.

```Swift

import ISEmojiView

EmojiView_SwiftUI()

    .frame(width: 300, height: 500)

    .padding()

```

`countOfRecentsEmojis`, `needToShowAbcButton`, `needToShowDeleteButton`, `updateRecentEmojiImmediately` can be passed to EmojiView_SwiftUI as parameters.

## Others

If you are looking for a React Native solution, take a look at this [brendan-rius/react-native-emoji-keyboard](https://github.com/brendan-rius/react-native-emoji-keyboard)

## License

MIT