Flutter交互管理插件interaction_manager的使用

interaction_manager

interaction_manager 是一个用于管理 Flutter 应用程序中各种交互对话框的插件。它允许开发者轻松地注册和调用不同类型的对话框，例如自定义对话框、消息对话框、查询对话框等。

Getting Started（开始使用）

此项目是一个 Dart 包项目的起点，可以作为一个库模块，包含可以在多个 Flutter 或 Dart 项目中轻松共享的代码。

对于如何开始使用 Flutter，您可以查看我们的在线文档，其中包含教程、示例、移动开发指南以及完整的 API 参考。

使用示例

以下是一个完整的示例，展示如何在 Flutter 应用程序中使用 interaction_manager 插件。

示例代码

import 'package:example/dialog_builders.dart'; // 自定义对话框构建器
import 'package:flutter/material.dart';
import 'package:get_it/get_it.dart';
import 'package:interaction_manager/interaction_manager.dart'; // 引入 interaction_manager

void main() => runApp(MyApp()); // 应用程序入口

// 主应用程序类
class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(primarySwatch: Colors.blue),
      home: InteractionConnector( // 使用 InteractionConnector 来连接交互管理器
        dialogsInitFunction: registerDialogs, // 注册对话框
        child: MyHomePage(), // 主页面
      ),
    );
  }
}

// 主页面类
class MyHomePage extends StatefulWidget {
  MyHomePage({Key? key}) : super(key: key);

  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('InteractionManager')), // 设置应用栏标题
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            // 自定义对话框按钮
            MaterialButton(
              onPressed: () async {
                await GetIt.I<InteractionManager>() // 获取 InteractionManager 实例
                    .showRegisteredDialog<Map<String, String>, void>(
                  dialogName: 'TestDialog', // 对话框名称
                  data: { // 传递数据
                    'title': 'This is the Title',
                    'message': 'Registered Dialog',
                    'buttonText': 'OK',
                  },
                );
              },
              child: const Text('Registered CustomDialog:'), // 按钮文本
            ),
            // 消息对话框按钮
            MaterialButton(
              onPressed: () async {
                await GetIt.I<InteractionManager>().showMessageDialog(
                    'This is a message!', // 消息内容
                    title: 'Message Dialog', // 对话框标题
                    closeButtonText: 'OK'); // 关闭按钮文本
              },
              child: const Text('Message Dialog:'), // 按钮文本
            ),
            // 查询对话框按钮
            MaterialButton(
              onPressed: () async {
                MessageDialogResults result = await GetIt.I<InteractionManager>().showQueryDialog(
                  'This is a query dialog!', // 消息内容
                  title: 'Query Dialog', // 对话框标题
                );
                print(result); // 打印结果
              },
              child: const Text('Query Dialog:'), // 按钮文本
            ),
            // 网络配置对话框按钮
            MaterialButton(
              onPressed: () async {
                await GetIt.I<InteractionManager>().showNetworkConfigurationDialog(
                  title: 'Network Dialog', // 对话框标题
                  message: 'This is a message!', // 消息内容
                  okButtonText: 'OK', // 确定按钮文本
                );
              },
              child: const Text('Network Dialog:'), // 按钮文本
            ),
            // 登录对话框按钮
            MaterialButton(
              onPressed: () async {
                await GetIt.I<InteractionManager>().showLoginDialog(
                    okButtonText: 'OK', // 确定按钮文本
                    usernameValidator: (s) { // 验证用户名
                      return s.isEmpty ? 'You have to provide a name' : null;
                    });
              },
              child: const Text('Login Dialog:'), // 按钮文本
            ),
          ],
        ),
      ),
    );
  }
}