EmojiText - GitLite

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #go #rust #deep-learning #nodejs #macos #kubernetes #awesome-list #ios #mcp #open-source

EmojiText

(★ 89)

😃 Render Custom Emoji in Text

File Explorer

Download Latest Version (.zip)

- - CADisplayLinkPublisher.swift
  - EmojiLabel.swift
  - EmojiLoader.swift
  - EmojiText.swift
  - EmojiTextField.swift
  - EmojiTextPresenter.swift
  - EmojiTextSource.swift
  - EmojiTextView.swift
  - Lock.swift
  - Logger.swift
  - Typealiases.swift
- - AnimatedEmojiView.swift
  - ChangingRemoteEmojiView.swift
  - ContentView.swift
  - EmojiLabelWrapper.swift
  - EmojiTestView.swift
  - EmojiTextFieldWrapper.swift
  - EmojiTextViewWrapper.swift
  - LocalEmojiView.swift
  - RemoteEmojiView.swift
  - SFSymbolEmojiView.swift
  - Test.entitlements
  - TestApp.swift
- - project.pbxproj
- - Emojis.swift
  - EmojiTextTests.swift
  - SnapshotTests.xctestplan
  - TestEmojiProvider.swift
.gitignore
.spi.yml
.swiftlint.yml
LICENSE
Package.swift
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# EmojiText

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fdivadretlaw%2FEmojiText%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/divadretlaw/EmojiText)
[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fdivadretlaw%2FEmojiText%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/divadretlaw/EmojiText)

Render Custom Emoji in

- SwiftUI with `EmojiText`
- UIKit with `EmojiLabel` or `EmojiTextView`
- AppKit with `EmojiTextField` or `EmojiTextView`

Supports local and remote emojis.

## Usage

Remote emoji

```swift
EmojiText(
    verbatim: "Hello :my_emoji:",
    emojis: [RemoteEmoji(shortcode: "my_emoji", url: /* URL to emoji */)]
)
```

Local emoji

```swift
EmojiText(
    verbatim: "Hello :my_emoji:",
    emojis: [LocalEmoji(shortcode: "my_emoji", image: /* some UIImage or NSImage */)]
)
```

SF Symbol

```swift
EmojiText(
    verbatim: "Hello Moon & Starts :moon.stars:",
    emojis: [SFSymbolEmoji(shortcode: "moon.stars")]
)
```

### Markdown

Also supports Markdown

```swift
EmojiText(
    markdown: "**Hello** *World* :my_emoji:",
    emojis: [RemoteEmoji(shortcode: "my_emoji", url: /* URL to emoji */)]
)
```

### Animated Emoji

> [!WARNING]
> This feature is in beta and therefore is opt-in only. Performance may vary.

Currently only UIKit platforms support animated emoji.

Enable animation by setting adding the `.animated()` modifier to `EmojiText`.

```swift
EmojiText(
    verbatim: "GIF :my_gif:",
    emojis: [RemoteEmoji(shortcode: "my_gif", url: /* URL to gif */)]
)
.animated()
```

Supported formats:

- APNG
- GIF
- WebP

> [!INFO]
> The animation will automatically pause when using low-power mode. To always play animations, even in low-power mode set the animation mode to `AnimatedEmojiMode.always`
> 
> ```swift
> EmojiText(
>     verbatim: "GIF :my_gif:",
>     emojis: [RemoteEmoji(shortcode: "my_gif", url:  /* URL to gif */)]
> )
> .animated()
> .environment(\.emojiText.AnimatedMode, .always)
> ```

## Configuration

Remote emojis are replaced by a placeholder image when loading. Default is the SF Symbol `square.dashed` but you can overide the placeholder image with

```swift
.emojiText.placeholder(systemName: /* SF Symbol */)
```

or

```swift
.emojiText.placeholder(image: /* some UIImage or NSImage */)
```

Remote emojis use `URLSession.shared` to load them, but you can provide a custom `URLSession`

```swift
.environment(\.emojiText.asyncEmojiProvider, DefaultAsyncEmojiProvider(session: myUrlSession))
```

You can also replace the remote image loading and caching entirely. For example with [Nuke](https://github.com/kean/Nuke)

```swift
.environment(\.emojiText.asyncEmojiProvider, NukeEmojiProvider())
```

See [`NukeEmojiProvider`](Test/App/Provider/NukeEmojiProvider.swift) in the Test-App for a reference implementation of a `AsyncEmojiProvider` using Nuke.

## License

See [LICENSE](LICENSE)