Flutter文字过滤插件filter_word的使用

在Flutter开发中，有时我们需要对输入的文字进行过滤，例如屏蔽敏感词或特定字符。为了实现这一功能，可以使用filter_word插件。以下是如何在Flutter项目中使用该插件的详细步骤及示例代码。

插件安装

首先，在pubspec.yaml文件中添加filter_word依赖：

dependencies:
  filter_word: ^1.0.0

然后运行flutter pub get命令以安装插件。

使用示例

初始化FilterWord实例

在使用插件之前，需要初始化一个FilterWord实例，并加载敏感词库。

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: FilterWordExample(),
    );
  }
}

加载敏感词库

我们可以从本地文件加载敏感词库，或者直接设置敏感词列表。

方法1：从文件加载敏感词库

class FilterWordExample extends StatefulWidget {
  [@override](/user/override)
  _FilterWordExampleState createState() => _FilterWordExampleState();
}

class _FilterWordExampleState extends State<FilterWordExample> {
  late FilterWord _filterWord;

  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化FilterWord并加载敏感词库
    _filterWord = FilterWord();
    _filterWord.loadFromFile('assets/word_filter.txt');
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Filter Word Example'),
      ),
      body: Center(
        child: Text(_filterWord.filter('这是一个测试文本，包含一些敏感词')),
      ),
    );
  }
}

方法2：直接设置敏感词列表

class FilterWordExample extends StatefulWidget {
  [@override](/user/override)
  _FilterWordExampleState createState() => _FilterWordExampleState();
}

class _FilterWordExampleState extends State<FilterWordExample> {
  late FilterWord _filterWord;

  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化FilterWord并设置敏感词列表
    _filterWord = FilterWord();
    _filterWord.setWords(['敏感词1', '敏感词2']);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Filter Word Example'),
      ),
      body: Center(
        child: Text(_filterWord.filter('这是一个测试文本，包含一些敏感词')),
      ),
    );
  }
}

敏感词替换规则

默认情况下，filter_word插件会将匹配到的敏感词替换为指定的占位符（默认为***）。我们可以通过设置自定义占位符来改变替换规则。

class FilterWordExample extends StatefulWidget {
  [@override](/user/override)
  _FilterWordExampleState createState() => _FilterWordExampleState();
}

class _FilterWordExampleState extends State<FilterWordExample> {
  late FilterWord _filterWord;

  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化FilterWord并设置自定义占位符
    _filterWord = FilterWord();
    _filterWord.setWords(['敏感词1', '敏感词2']);
    _filterWord.placeholder = 'XXX';
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Filter Word Example'),
      ),
      body: Center(
        child: Text(_filterWord.filter('这是一个测试文本，包含一些敏感词')),
      ),
    );
  }
}