Flutter综合工具插件 comprehensive_utils 的使用

特性

Widgets

• FluentListView: 提供流畅的列表视图。

Tools

• IndexingCollection<T>: 索引集合工具。
• ObservableTimer: 可观察的定时器。
• CacheManager: 缓存管理工具。

Streams

• DistinctSubject: 一个特殊的主题，只在值发生变化时发出新值。
• DistinctValueStream: 一个特殊的流，确保连续相同的值不会重复发送。
• DistinctConnectableStream: 连接多个流并确保只有不同的值会被转发。

Extensions

Stream 扩展

• publishDistinctValue
• publishDistinctValueSeeded
• shareDistinctValue
• shareDistinctValueSeeded
• mapDistinctValue<T>
• takeUntilFuture

Iterable 扩展

• parseList<T>
• parseIterable<T>

Function 扩展

• apply

快速开始

首先，在您的项目中添加包依赖，并导入包：

import 'package:comprehensive_utils/comprehensive_utils.dart';

使用示例

以下是如何使用 DistinctSubject 来监控用户名变化的例子。这个例子展示了如何创建一个只在值变化时才会更新的流。

final DistinctSubject<String> _userNameSubject = DistinctSubject<String>();

// 获取用户名称流
DistinctValueStream<String> get userNameStream => _userNameSubject.stream;

void changeUserName(String userName) {
  // 如果新值与前一个值不同，则将新值添加到流中
  _userNameSubject.add(userName);
}

// 监听用户名的变化
@override
void initState() {
  super.initState();
  // 订阅用户名流
  userNameStream.listen((newUserName) {
    print('User name changed to: $newUserName');
  });
}

完整示例 Demo

下面是一个完整的Flutter应用示例，演示了如何结合使用 comprehensive_utils 中的不同组件来构建一个简单的用户名变更通知系统。

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

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

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

class UserNameChangePage extends StatefulWidget {
  @override
  _UserNameChangePageState createState() => _UserNameChangePageState();
}

class _UserNameChangePageState extends State<UserNameChangePage> {
  final DistinctSubject<String> _userNameSubject = DistinctSubject<String>();
  String currentUserName = "Guest";

  @override
  void initState() {
    super.initState();
    // 订阅用户名流
    _userNameSubject.stream.listen((newUserName) {
      setState(() {
        currentUserName = newUserName;
      });
    });
  }

  void _changeUserName(String newName) {
    if (_userNameSubject.value != newName) {
      _userNameSubject.add(newName);
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("User Name Change"),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text('Current User Name: $currentUserName'),
            Padding(
              padding: const EdgeInsets.all(16.0),
              child: TextField(
                onSubmitted: _changeUserName,
                decoration: InputDecoration(labelText: 'Enter new user name'),
              ),
            ),
          ],
        ),
      ),
    );
  }
}

此代码片段展示了如何通过输入新的用户名来触发状态更新，并且只有当新用户名不同于当前用户名时，才会触发UI更新。这利用了DistinctSubject的独特功能，以避免不必要的UI刷新。