all_emojis #

A comprehensive Dart package that provides access to a complete collection of emojis with detailed metadata, search capabilities, and regex support.

Features #

• 5034+ emojis with detailed metadata
• Emoji regex pattern matching
• Emoji search by keywords
• Group-based emoji filtering
• Full Unicode emoji support

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  all_emojis: ^0.1.0

Usage #

Basic Usage #

import 'package:all_emojis/all_emojis.dart';

// Get total number of available emojis
print('Total emojis: ${allEmojis.length}'); // 5034 emojis

// Access specific emoji and its metadata
final heartEmoji = allEmojis['❤️']!;
print('Character: ${heartEmoji.char}');      // ❤️
print('Name: ${heartEmoji.name}');           // red heart
print('Keywords: ${heartEmoji.keywords}');    // [heart, love, ...]
print('Group: ${heartEmoji.group}');         // EmojiGroup.smileysAndEmotion
print('Version: ${heartEmoji.emojiVersion}'); // 1.0

Finding Emojis by Keywords #

// Get all food-related emojis
final foodEmojis = allEmojis.values
    .where((emoji) => emoji.keywords.contains('food'))
    .map((e) => e.char)
    .toList();

// Search for emojis with multiple keywords
final happyEmojis = allEmojis.values
    .where((emoji) => emoji.keywords.any((k) => 
        k.contains('happy') || k.contains('joy') || k.contains('smile')))
    .map((e) => e.char)
    .toList();

Working with Emoji Groups #

// Get animal emojis
final animalEmojis = allEmojis.values
    .where((emoji) => emoji.group == EmojiGroup.animalsNature)
    .map((e) => e.char)
    .take(5)
    .toList();

Emoji Pattern Matching #

// Find all emojis in a text
final text = 'Having lunch 🍕 with friends 👥 is fun! 🎉';
final matches = emojiRegex.allMatches(text);
final foundEmojis = matches.map((m) => m.group(0)).toList();

// Check if a string contains emojis
final hasEmojis = emojiRegex.hasMatch(text); // true

// Get emoji positions in text
final emojiPositions = emojiRegex.allMatches(text)
    .map((m) => m.start)
    .toList();

Emoji Properties #

Each emoji object contains the following properties:

• char: The emoji character
• name: The official emoji name
• keywords: List of related keywords
• slug: URL-friendly name
• group: Emoji category group
• emojiVersion: The emoji version

Emoji Groups #

Emojis are categorized into the following groups:

• smileysAndEmotion: 😊 😍 😎
• peopleAndBody: 👋 👨‍👩‍👧‍👦 🧑‍🤝‍🧑
• animalsNature: 🐶 🐱 🐭
• foodAndDrink: 🍎 🍕 🍺
• travelAndPlaces: ✈️ 🏖️ 🏰
• activities: ⚽️ 🎮 🎨
• objects: 💡 📱 💻
• symbols: ❤️ ⭐️ ⚡️
• flags: 🏁 🏳️ 🏳️‍🌈

Contributing #

Contributions are welcome! Please feel free to submit a Pull Request.

Note #

This library is generated with the latest available emoji dataset (v15) from Unicode, using a code generator based on https://github.com/alfalcon90/unicode-emoji-dart from https://github.com/alfalcon90. It uses the following libraries to compile the dataset:

• emojilib: provides a list of keywords for every emoji
• emoji.json: provides emoji data in JSON format
• emoji-regex: a regular expression to match all emoji symbols and sequences

Update the generated emojis to latest Unicode version #

1. cd generator
2. npm install
3. npm run generate
4. Publish it to "pub.dev"

License #

This project is licensed under the MIT License - see the LICENSE file for details.

Unicode License Agreement #

https://www.unicode.org/license.html