Flutter表情符号管理插件flutter_emoji的使用

简介

flutter_emoji 是一个轻量级的表情符号包，适用于Flutter和基于Dart的应用程序。它包含了所有最新的表情符号，并且是用100%的咖啡因（代码）和爱心制作的！该包受到了 node-emoji 包的启发。

更新：从v2.3.4版本开始，支持Unicode 13.0中的所有表情符号。

请注意，我最初创建这个包是为了支持我的Flutter应用程序。然而，随着Dart在更多平台上得到支持，从v2.4.0版本开始，这个包将适用于所有类型的基于Dart的应用程序。

工作进展

我正在开发包的新版本，可能会引入破坏性更改，但我将尽量保持API的兼容性。以下是v3版本的一些更新：

• 支持Unicode 15.1+表情符号。
• 表情符号肤色选项。
• 表情符号分类（类别）。
• 表情符号版本。
• 处理/操作表情符号的一些新方法。

安装

在 pubspec.yaml 文件中添加以下内容：

dependencies:
  flutter_emoji: ">= 2.0.0"

API 使用

首先，导入包：

import 'package:flutter_emoji/flutter_emoji.dart';

主要有两个类用于处理表情符号文本：Emoji 和 EmojiParser。基本上，你需要初始化一个 EmojiParser 的实例并调用其方法。

示例代码

下面是一个完整的示例demo，展示了如何使用 flutter_emoji 插件来处理表情符号。

import 'package:flutter/material.dart';
import 'package:flutter_emoji/flutter_emoji.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Flutter Emoji Example')),
        body: Center(
          child: EmojiExample(),
        ),
      ),
    );
  }
}

class EmojiExample extends StatefulWidget {
  @override
  _EmojiExampleState createState() => _EmojiExampleState();
}

class _EmojiExampleState extends State<EmojiExample> {
  final parser = EmojiParser();
  String inputText = 'I :heart: :coffee:';
  String outputText = '';

  void _convertText() {
    setState(() {
      outputText = parser.emojify(inputText);
    });
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      mainAxisAlignment: MainAxisAlignment.center,
      children: <Widget>[
        Padding(
          padding: const EdgeInsets.all(8.0),
          child: TextField(
            controller: TextEditingController(text: inputText),
            onChanged: (value) => inputText = value,
            decoration: InputDecoration(hintText: 'Enter text with emoji codes'),
          ),
        ),
        ElevatedButton(
          onPressed: _convertText,
          child: Text('Convert to Emojis'),
        ),
        Padding(
          padding: const EdgeInsets.all(8.0),
          child: Text(
            outputText.isEmpty ? 'Output will appear here' : outputText,
            style: TextStyle(fontSize: 24),
          ),
        ),
      ],
    );
  }
}

在这个示例中，我们创建了一个简单的Flutter应用程序，用户可以在文本框中输入包含表情符号代码的文本，然后点击按钮将其转换为实际的表情符号。EmojiParser 类的 emojify 方法用于执行此转换。

初始化 EmojiParser 数据

有两种可用的数据集可以用于初始化 EmojiParser：本地数据集和服务器数据集。

• 加载本地数据集：

  var localParser1 = EmojiParser();
  var localParser2 = EmojiParser(init: false);
  localParser2.initLocalData();
  

• 加载服务器数据集（需要网络权限）：

  var serverParser = EmojiParser(init: false);
  await serverParser.initServerData(); // 确保在异步函数/方法中调用
  

  注意：确保在Android上添加互联网权限。

  <!-- Required to fetch data from the internet. -->
  <uses-permission android:name="android.permission.INTERNET" />
  

如果本地数据集中没有最新表情符号，请加载服务器数据集。如果仍然无法工作，请在仓库中创建问题或拉取请求。

待办事项

以下功能即将添加到此包中：

• ✅ 获取表情符号详细信息。
• ✅ 重构以简化使用。
• ✅ 验证无效输入。
• ✅ 从给定文本中查找可用表情符号列表。
• ✅ 用另一个表情符号替换特定表情符号。
• ✅ 回调以对找到的表情符号进行额外格式化。
• ✅ 获取最新表情符号列表的能力。
• ❌ 创建可扩展的表情符号匹配器。

许可证

MIT许可证，详情请参阅 LICENSE.md。