emoji_extension 0.3.0 | Dart package

Emojis for Dart Unicode 15.1
+
One, yet powerful emojis String extension

Features #

Contains over 5,000 emojis from Unicode 15.1 💪
Supports:
- shorcodes: Discord, Github, Slack 🫡
- skin tone variations: 👍 👍🏻 👍🏼 👍🏽 👍🏾 👍🏿
- hair style variations: 🦰 🦱 🦳 🦲
- multi-person: 👨‍👩‍👧‍👦
Provides Emojis() class that has all the info about each emoji:
- value: 😀
- unicode: 1F600
- name: Grinning Face
- apple name: Grinning Face
- also known as: Happy Face, Smiley Face
- group: Smileys & Emotion
- subgroup: face-smiling
- version: 8.0
- status: fully-qualified
- shortcodes:
  - Discord: grinning
  - Github: grinning
  - Slack: grinning
Provides emojis extension to manipulate emojis on any text. Quick overview of just a few possibilities:

'text😀text🤦🏾‍♀️text'.emojis 
                         .contains // true
                         .only // false
                         .onlyOne // false
                         .count // 2
                         .split // [text, text, text]
                         .remove // texttexttext
                         .replace('-') // text-text-text
                         .extract // [😀, 🤦🏾‍♀️]
                         .get
                             .unicodes // [1F600, 1F926 1F3FE 200D 2640 FE0F]
                             .names // [Grinning Face, Woman Facepalming: Medium-Dark Skin Tone]
                             .slackShortcodes // [:grinning:, :woman-facepalming::skin-tone-5:]
                         ... // and many more
                          


// from Discord shortcodes:
':grinning: text :woman-facepalming::skin-tone-5:'.emojis.fromShortcodes(); // 😀 text 🤦🏾‍♀️

Usage #

Import import 'package:emoji_extension/emoji_extension.dart'; and you've got 2 benefits:

1️⃣ Emojis repository

______________________________________________

values
unicodes
names
appleNames
alsoKnownAs
shortcodes

groups
subgroups
groupsWithSubgroups
shortcodePlatforms
versions
statuses
getOne()
getOneOrNull()
byGroup()
bySubgroup()
byVersion()
byStatus()

2️⃣ Emojis extension

______________________________________________

contains
only
onlyOne
count
remove
split
extract
get

unicodes
names
appleNames
alsoKnownAs
groups
subgroups
shortcodes

anyOf()
everyOf()
splitMapJoin()
replace()
replaceWith()
replaceWhere()
toShortcodes()
fromShortcodes()

`Emojis()` repository #

Full Emojis() repository with unicodes, names, apple names, "also known as", groups, subgroups, shortcodes:

Emojis() // .get .groups .subgroups .groupsWithSubgroups .shortcodePlatforms   and many more...

Emojis().get #

Emojis().get; /* [
                  Emoji(
                   value: 😀,
                   unicode: 1F600,
                   name: Grinning Face,
                   appleName: Grinning Face,
                   alsoKnownAs: [Happy Face, Smiley Face],
                   group: Smileys & Emotion,
                   subgroup: face-smiling,
                   version: 8.0,
                   status: fully-qualified,
                   shortcodes: [
                            Shortcode(
                            platform: Default,
                            values: [grinning_face]
                          ),
                            Shortcode(
                            platform: CLDR,
                            values: [grinning_face]
                          ),
                            Shortcode(
                            platform: Discord,
                            values: [grinning]
                          ),
                            Shortcode(
                            platform: Github,
                            values: [grinning]
                          ),
                            Shortcode(
                            platform: Slack,
                            values: [grinning]
                          )]
                  ), 
                  Emoji(
                   value: 😃,
                   unicode: 1F603,
                   name: Grinning Face with Big Eyes,
                   appleName: Grinning Face with Big Eyes,
                   alsoKnownAs: [Grinning Face, Happy Face, Happy, Smiley Face]
                   group: Smileys & Emotion,
                   subgroup: face-smiling,
                   version: 6.0,
                   status: fully-qualified
                   shortcodes: [...]
                  )
                 ...
                 ] */

Emojis().get.values

Emojis().get.values; // [😀, 😃, 😄, 😁, 😆, 😅, 🤣, 😂, 🙂, 🙃, 🫠, 😉, 😊, 😇, 🥰, 😍, ...]

Emojis().get.unicodes

Emojis().get.unicodes; // [1F600, 1F603, 1F604, 1F601, 1F606, 1F605, 1F923, 1F602, 1F642, ...]

Emojis().get.names

Emojis().get.names; // [Grinning Face, Grinning Face with Big Eyes, ...]

Emojis().get.appleNames

Emojis().get.appleNames; // [Grinning Face, Grinning Face with Big Eyes, ...]

Emojis().get.alsoKnownAs

Emojis().get.alsoKnownAs; // [Happy Face, Smiley Face, Grinning Face, ...]

Emojis().get.shortcodes

// Default (emoji name in snake_case)
Emojis().get.shortcodes; // [:grinning_face:, :grinning_face_with_big_eyes:, ...]

// CLDR
Emojis().get.cldrShortcodes; // [:grinning_face:, :grinning_face_with_big_eyes:, ...]

// Discord
Emojis().get.discordShortcodes; // [:grinning:, :smiley:, :smile:, :grin:, :laughing:, ...]

// Github (no skin-tone shortcodes)
Emojis().get.githubShortcodes; // [:grinning:, :smiley:, :smile:, :grin:, :laughing:, ...]

// Slack
Emojis().get.slackShortcodes; // [:grinning:, :smiley:, :smile:, :grin:, :laughing:, ...]

Emojis().groups #

Emojis().groups; // [Group.smileysAndEmotion, Group.peopleAndBody, Group.component, ...]
Emojis().groups.values; // [Smileys & Emotion, People & Body, Component, Animals & Nature, ...]

Emojis().subgroups #

Emojis().subgroups; // [Subgroup.faceSmiling, Subgroup.faceAffection, Subgroup.faceTongue, ...]
Emojis().subgroups.values; // [face-smiling, face-affection, face-tongue, face-hand, ...]

Emojis().groupsWithSubgroups #

Emojis().groupsWithSubgroups; // {Group.smileysAndEmotion: [Subgroup.faceSmiling, ...], ...}
Emojis().groupsWithSubgroupsValues; // {Smileys & Emotion: [face-smiling, ...], ...}

Emojis().shortcodePlatforms #

Emojis().shortcodePlatforms; // [Default, CLDR, Discord, Github, Slack]

Emojis().versions #

Emojis().versions; // [Version.v6_0, Version.v7_0, Version.v8_0, Version.v9_0, ...]
Emojis().versions.values; // [6.0, 7.0, 8.0, 9.0, 10.0, 11.0, 12.0, 12.1, 13.0, ...]

Emojis().statuses #

Emojis().statuses; // [Version.v6_0, Version.v7_0, Version.v8_0, Version.v9_0, ...]
Emojis().statuses.values; // [6.0, 7.0, 8.0, 9.0, 10.0, 11.0, 12.0, 12.1, 13.0, ...]

Emojis().getOne() #

// By value
Emojis().getOne('😀'); // or

// By unicode
Emojis().getOne('1F600'); // or

// By name or apple name (ignore-case)
Emojis().getOne('Grinning Face'); // or
Emojis().getOne('grinning face'); // or

// By also known as (ignore-case)
Emojis().getOne('Happy Face'); // or
Emojis().getOne('happy face'); // or
Emojis().getOne('Smiley Face'); // or
Emojis().getOne('smiley face'); // or

// By shortcode (ignore-colons)
Emojis().getOne(':grinning:'); // or
Emojis().getOne('grinning'); // or
Emojis().getOne('grinning_face'); /* [Emoji(
                                         value: 😀,
                                         unicode: 1F600,
                                         name: Grinning Face,
                                         appleName: Grinning Face,
                                         alsoKnownAs: [Happy Face, Smiley Face],
                                         group: Smileys & Emotion,
                                         subgroup: face-smiling,
                                         version: 8.0,
                                         status: fully-qualified,
                                         shortcodes: [
                                                Shortcode(
                                                platform: Default,
                                                values: [grinning_face]
                                              ),
                                                Shortcode(
                                                platform: CLDR,
                                                values: [grinning_face]
                                              ),
                                                Shortcode(
                                                platform: Discord,
                                                values: [grinning]
                                              ),
                                                Shortcode(
                                                platform: Github,
                                                values: [grinning]
                                              ),
                                                Shortcode(
                                                platform: Slack,
                                                values: [grinning]
                                              )]
                                       )] */

Emojis().getOneOrNull() #

Equivalent of getOne() with null safety:

Emojis().getOneOrNull('😀')?.name; // Grinning face
Emojis().getOneOrNull('some unknown value')?.name; // null

Emojis().byGroup() #

Emojis().byGroup(Group.smileysAndEmotion); // [Emoji(value: 😀, ...), Emoji(value: 😃, ...), ...]

//or use convenient getters:
Emojis().smileysAndEmotion; // [Emoji(value: 😀, ...), Emoji(value: 😃, ...), ...]

Emojis().bySubgroup() #

Emojis().bySubgroup(Subgroup.faceSmiling); // [Emoji(value: 😀, ...), Emoji(value: 😃, ...), ...]

//or use convenient getters:
Emojis().faceSmiling; // [Emoji(value: 😀, ...), Emoji(value: 😃, ...), ...]

Emojis().byVersion() #

Emojis().byVersion(Version.v6_0); // [Emoji(value: 😃, ...), Emoji(value: 😄, ...), ...]

//or use convenient getters:
Emojis().v6_0; // [Emoji(value: 😃, ...), Emoji(value: 😄, ...), ...]

Emojis().byStatus() #

Emojis().byStatus(Status.fullyQualified); // [Emoji(value: 😃, ...), Emoji(value: 😄, ...), ...]

//or use convenient getters:
Emojis().fullyQualified; // [Emoji(value: 😃, ...), Emoji(value: 😄, ...), ...]

`emojis` extension #

Simple emojis extension that you can use to manipulate emojis on any text:

'text😀text🤦🏾‍♀️text'.emojis 
                         .contains // true
                         .only // false
                         .onlyOne // false
                         .count // 2
                         .split // [text, text, text]
                         .remove // texttexttext
                         .extract // [😀, 🤦🏾‍♀️]
                                 .first // 😀
                                 .second // 🤦🏾‍♀️
                                 .penultimate // 😀
                                 .last // 🤦🏾‍♀️
                         .anyOf(['👍', '😀']) // true
                         .everyOf(['👍', '😀']) // false
                         .replace('---') // text---text---text
                         .replaceWith({'😀':'ABC' , '🤦🏾‍♀️':'123'}) // textABCtext123text
                         .replaceWhere((e) => e.value == '🤦🏾‍♀️' ? '__' : null); // text😀text__text
                         .splitMapJoin(
                                       onMatch: (_) => '_emoji_',
                                       onNonMatch: (s) => s.toUpperCase(),
                                      ) // TEXT_emoji_TEXT_emoji_TEXT
                         .get
                             .unicodes // [1F600, 1F926 1F3FE 200D 2640 FE0F]
                             .names // [Grinning Face, Woman Facepalming: Medium-Dark Skin Tone]
                             .appleNames // [Grinning Face]
                             .alsoKnownAs // [Happy Face, Smiley Face]
                             .groups // [Group.smileysAndEmotion, Group.peopleAndBody]
                                    .values // [Smileys & Emotion, People & Body]
                             .subgroups // [Subgroup.faceSmiling, Subgroup.personGesture]
                                    .values // [face-smiling, person-gesture]
                             .shortcodes // [:grinning_face:, :woman_facepalming_medium_dark_skin_tone:]
                             .cldrShortcodes // [:grinning_face:, :woman_facepalming_tone4:]
                             .discordShortcodes // [:grinning:, :woman_facepalming_tone4:]
                             .githubShortcodes // [:grinning:]
                             .slackShortcodes // [:grinning:, :woman-facepalming::skin-tone-5:]

emojis.contains #

'😀text😀'.emojis.contains; // true
'text'.emojis.contains; // false

emojis.only #

'😀'.emojis.only; // true
'😀 😀 😀'.emojis.only; // true
'text 😀 😀 😀 text'.emojis.only; // false
'text'.emojis.only; // false

emojis.onlyOne #

'😀'.emojis.onlyOne; // true
'😀 😀 😀'.emojis.onlyOne; // false
'text 😀 😀 😀 text'.emojis.onlyOne; // false
'text'.emojis.onlyOne; // false

emojis.count #

'text 😀 😀 😀 text'.emojis.count; // 3

emojis.remove #

'text😀 te😀xt 😀text'.emojis.remove; // text text text

emojis.split #

'text😀text'.emojis.split; // [text, text]

emojis.extract #

'👍️te👍🏻xt👍🏼te👍🏽xt👍🏾te👍🏿xt'.emojis.extract // [👍, 👍🏻, 👍🏼, 👍🏽, 👍🏾, 👍🏿]
                                         .first // 👍
                                         .second // 👍🏻
                                         .third // 👍🏼
                                         .fourth // 👍🏽
                                         .fifth // 👍🏾
                                         .sixth // 👍🏿
                                         .penultimate // 👍🏾
                                         .last // 👍🏿

emojis.get #

'😀text'.emojis.get; /* [Emoji(
                          value: 😀,
                          unicode: 1F600,
                          name: Grinning Face,
                          appleName: Grinning Face,
                          alsoKnownAs: [Happy Face, Smiley Face],
                          group: Smileys & Emotion,
                          subgroup: face-smiling,
                          version: 8.0,
                          status: fully-qualified,
                          shortcodes: [
                                Shortcode(
                                platform: Default,
                                values: [grinning_face]
                              ),
                                Shortcode(
                                platform: CLDR,
                                values: [grinning_face]
                              ),
                                Shortcode(
                                platform: Discord,
                                values: [grinning]
                              ),
                                Shortcode(
                                platform: Github,
                                values: [grinning]
                              ),
                                Shortcode(
                                platform: Slack,
                                values: [grinning]
                              )]
                        )] */

emojis.get.unicodes

'😀text'.emojis.get.unicodes; // [1F600]

emojis.get.names

'😀text'.emojis.get.names; // [Grinning Face]

emojis.get.appleNames

'😀text'.emojis.get.appleNames; // [Grinning Face]

emojis.get.alsoKnownAs

'😀text'.emojis.get.alsoKnownAs; // [Happy Face, Smiley Face]

emojis.get.groups

'😀text'.emojis.get.groups; // [Group.smileysAndEmotion]
'😀text'.emojis.get.groups.values; // [Smileys & Emotion]

emojis.get.subgroups

'😀text'.emojis.get.subgroups; // [Subgroup.faceSmiling]
'😀text'.emojis.get.subgroups.values; // [face-smiling]

emojis.get.shortcodes

// Default (emoji name in snake_case)
'😀text🤦🏾‍♀️'.emojis.get.shortcodes; // [:grinning_face:, :woman_facepalming_medium_dark_skin_tone:]

// CLDR
'😀text🤦🏾‍♀️'.emojis.get.cldrShortcodes; // [:grinning_face:, :woman_facepalming_tone4:]

// Discord
'😀text🤦🏾‍♀️'.emojis.get.discordShortcodes; // [:grinning:, :woman_facepalming_tone4:]

// Github (no skin-tone shortcodes)
'😀text🤦🏾‍♀️'.emojis.get.githubShortcodes; // [:grinning:]

// Slack
'😀text🤦🏾‍♀️'.emojis.get.slackShortcodes; // [:grinning:, :woman-facepalming::skin-tone-5:]

emojis.anyOf() #

'👍️text'.emojis.anyOf(['👍']); // true
'😀text'.emojis.anyOf(['👍', '😀']); // true
'👍️te👍🏻xt👍🏼te👍🏽xt👍🏾te👍🏿xt'.emojis.anyOf(['😀']); // false

emojis.everyOf() #

'👍️text'.emojis.everyOf(['👍']); // true
'😀text👍'.emojis.everyOf(['👍', '😀']); // true
'😀text'.emojis.everyOf(['👍', '😀']); // false

emojis.splitMapJoin() #

'text😀text'.emojis.splitMapJoin(
onMatch: (_) => '_emoji_',
onNonMatch: (s) => s.toUpperCase(),
); // TEXT_emoji_TEXT

emojis.replace() #

'😀text👍'.emojis.replace('_'); // _️text_

emojis.replaceWith() #

'😀text👍🏻text😀'.emojis.replaceWith({'😀':'ABC', '👍🏻':'123'}); // ABCtext123textABC

emojis.replaceWhere() #

'😀text👍🏻text😀'.emojis.replaceWhere((e) => e.value == '👍🏻' ? '_OK_' : null); // 😀text_OK_text😀 

'😀text👍🏻text😀'.emojis.replaceWhere((e) => {'😀':'ABC', '👍🏻':'123'}[e.value]); // ABCtext123textABC

emojis.toShortcodes() #

// Default (emoji name in snake_case)
'😀text🤦🏾‍♀️'.emojis.toShortcodes(); // :grinning_face:text:woman_facepalming_medium_dark_skin_tone:

// CLDR
'😀text🤦🏾‍♀️'.emojis.toCLDRShortcodes(); // :grinning_face:text:woman_facepalming_tone4:

// Discord
'😀text🤦🏾‍♀️'.emojis.toDiscordShortcodes(); // :grinning:text:woman_facepalming_tone4:

// Github (no skin-tone shortcodes)
'😀text🤦🏾‍♀️'.emojis.toGithubShortcodes(); // :grinning:text🤦🏾‍♀️

// Slack
'😀text🤦🏾‍♀️'.emojis.toSlackShortcodes(); // :grinning:text:woman-facepalming::skin-tone-5:

emojis.fromShortcodes() #

// Default 
'text:woman_facepalming_medium_dark_skin_tone:text'.emojis.fromShortcodes(); // text🤦🏾‍♀️text

// CLDR or Discord
'text:woman_facepalming_tone4:text'.emojis.fromShortcodes(); // text🤦🏾‍♀️text

// Slack
'text:woman-facepalming::skin-tone-5:text'.emojis.fromShortcodes(); // text🤦🏾‍♀️text

emoji_extension 0.3.0 emoji_extension: ^0.3.0 copied to clipboard

Metadata

Emojis for Dart Unicode 15.1 + One, yet powerful emojis String extension