Flutter词典查询插件 dictionaryx 的使用

dictionaryx 是一个基于 Wordnet 的英语词典插件，包含大约 120,000 条词条。本文将介绍如何在 Flutter 和 Dart 中使用该插件。

Dictionaries

该插件提供了四种优化的字典版本，每种版本都有不同的功能和内存占用：

• DictionaryMSAFlutter: 包含约 120,000 条词条，提供含义、同义词和反义词。仅适用于 Flutter。
• DictionaryMSAJson: 包含约 120,000 条词条，提供含义、同义词和反义词。仅适用于 Dart。
• DictionaryMSA: 包含约 120,000 条词条，提供含义、同义词和反义词。仅适用于 Dart。
• DictionarySA: 包含约 120,000 条词条，仅提供同义词和反义词。仅适用于 Dart。
• DictionaryReducedMSA: 包含约 3700 条词条，提供含义、同义词和反义词。仅适用于 Dart。
• DictionaryReducedSA: 包含约 3700 条词条，仅提供同义词和反义词。仅适用于 Dart。

安装

在你的 pubspec.yaml 文件中添加以下依赖：

dependencies:
  dictionaryx: ^0.3.5

如何使用

Flutter - 使用 JSON 文件中的完整字典

以下是一个完整的 Flutter 示例，展示了如何访问字典并查找单词的含义、同义词和反义词。

示例代码

import 'package:flutter/material.dart';
import 'package:dictionaryx/dictionary_msa_flutter.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'DictionaryX Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key}) : super(key: key);

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final TextEditingController _controller = TextEditingController();
  final DictionaryMSAFlutter _dictionary = DictionaryMSAFlutter();
  DictEntry _entry = DictEntry('', [], [], []);

  // 查找单词的方法
  void _lookupWord() async {
    final String word = _controller.text.trim();
    if (await _dictionary.hasEntry(word)) {
      final DictEntry? entry = await _dictionary.getEntry(word);
      setState(() {
        if (entry != null) {
          _entry = entry;
        } else {
          _entry = DictEntry('', [], [], []);
        }
      });
    } else {
      setState(() {
        _entry = DictEntry('', [], [], []);
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('DictionaryX Example'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: <Widget>[
            TextField(
              controller: _controller,
              decoration: InputDecoration(
                labelText: 'Enter a word',
                border: OutlineInputBorder(),
              ),
            ),
            SizedBox(height: 16.0),
            ElevatedButton(
              onPressed: _lookupWord,
              child: Text('Lookup Word'),
            ),
            SizedBox(height: 16.0),
            Expanded(
              child: _buildResult(),
            ),
          ],
        ),
      ),
    );
  }

  Widget _buildResult() {
    if (_entry.word.isEmpty) {
      return Center(child: Text('No result'));
    }

    return ListView(
      children: [
        ListTile(title: Text('Word: ${_entry.word}')),
        ListTile(title: Text('Synonyms: ${_entry.synonyms.join(', ')}')),
        ListTile(title: Text('Antonyms: ${_entry.antonyms.join(', ')}')),
        if (_entry.meanings.isNotEmpty)
          ListTile(
            title: Text('Meanings:'),
            subtitle: Column(
              crossAxisAlignment: CrossAxisAlignment.start,
              children: _entry.meanings.map((meaning) {
                return Column(
                  crossAxisAlignment: CrossAxisAlignment.start,
                  children: [
                    Text('POS: ${meaning.pos}'),
                    Text('Description: ${meaning.description}'),
                    if (meaning.meanings.isNotEmpty)
                      Text('Contextual Meanings: ${meaning.meanings.join(', ')}'),
                    if (meaning.examples.isNotEmpty)
                      Text('Examples: ${meaning.examples.join(', ')}'),
                  ],
                );
              }).toList(),
            ),
          ),
      ],
    );
  }
}

运行示例

1. 克隆仓库或下载插件示例代码。
2. 导航到 example/flutter_example/ 目录。
3. 运行以下命令安装依赖并启动应用：

cd example/flutter_example/
flutter pub get
flutter run

Dart - 使用 JSON 文件中的完整字典

以下是 Dart 中使用完整字典的示例：

import 'package:dictionaryx/dictionary_msa_json.dart';

void main() {
  var dMSAJson = DictionaryMSAJson();

  var entry = dMSAJson.getEntry('meeting');

  print(entry.word); // meeting
  print(entry.synonyms); // [Assemble, Contact, Adjoin, Forgather, See]
  print(entry.antonyms); // [diverge]

  print(entry.meanings.first.pos); // POS.NOUN
  print(entry.meanings.first.description); // a formally arranged gathering

  print(entry.meanings.first.hasMeanings()); // true
  print(entry.meanings.first.hasExamples()); // true

  print(entry.meanings.first.meanings.first); // Gathering
  print(entry.meanings.first.examples.first); // "next year the meeting (...)
}

Dart - 使用精简字典作为数据字面量

以下是 Dart 中使用精简字典的示例：

import 'package:dictionaryx/dictionary_reduced_sa.dart';
import 'package:dictionaryx/dictionary_reduced_msa.dart';

void main() {
  var dReducedSA = DictionaryReducedSA();
  print(dReducedSA.hasEntry('assafef')); // false
  print(dReducedSA.hasEntry('meeting')); // true

  var entry = dReducedSA.getEntry('meeting');
  print(entry.word); // meeting
  print(entry.synonyms); // [Assemble, Contact, Adjoin, Forgather, See]
  print(entry.antonyms); // [diverge]

  var dReducedMSA = DictionaryReducedMSA();
  entry = dReducedMSA.getEntry('meeting');
  print(entry.word); // meeting
  print(entry.synonyms); // [Assemble, Contact, Adjoin, Forgather, See]
  print(entry.antonyms); // [diverge]

  print(entry.meanings.first.pos); // POS.NOUN
  print(entry.meanings.first.description); // a formally arranged gathering

  print(entry.meanings.first.hasMeanings()); // true
  print(entry.meanings.first.hasExamples()); // true

  print(entry.meanings.first.meanings.first); // Gathering
  print(entry.meanings.first.examples.first); // "next year the meeting (...)
}