Flutter用户反馈响应插件feedback_response的使用

feedback_response 是一个用于简化在应用程序中创建和管理反馈响应的 Flutter 包。它提供了一种简单的方式来创建具有预定义级别的反馈响应（信息、警告、成功、错误）以及UI类型（无、对话框、SnackBar、底部Sheet、通知）。该包简化了类之间的通信，并处理深层类层次结构中的错误。

特性

• 预定义的反馈级别和UI类型
• 支持自定义反馈级别和UI类型
• 轻松转换为其他数据类型
• 不可变的响应对象

feedback_response 包简化了所有类之间的通信。如果在类层次结构深处遇到问题，只需发送一个反馈响应。随着类通过这些响应进行通信，它们会识别错误并将错误传递到UI视图，从而向用户提供有关问题的精确信息。根据 feedbackType，UI智能地决定要显示的通知类型，并根据 feedbackLevel 调整严重性级别。

使用方法

基本用法

首先导入包：

import 'package:feedback_response/feedback_response.dart';

创建反馈响应：

// 成功反馈响应
FeedbackResponse response = FeedbackResponse.success(
  title: '成功',
  message: '您的请求已成功处理。',
  feedbackLevel: FeedbackLevel.success,
  feedbackType: FeedbackType.dialog,
);

// 错误反馈响应
FeedbackResponse response = FeedbackResponse.error(
  title: '错误',
  message: '您的请求失败了。',
  feedbackLevel: FeedbackLevel.error,
  feedbackType: FeedbackType.snackbar,
);

扩展用法

你可以通过继承 FeedbackResponseInterface 来创建自定义反馈级别和UI类型：

class CustomFeedbackResponse<T extends Object?> extends FeedbackResponseInterface<T, CustomFeedbackLevel, CustomFeedbackType> {
  // 自定义实现
}

然后使用你的自定义反馈响应类：

CustomFeedbackResponse response = CustomFeedbackResponse.customLevel(
  customFeedbackLevel: CustomFeedbackLevel.myLevel,
  customFeedbackType: CustomFeedbackType.myType,
  title: '我的标题',
  message: '我的消息',
);

访问响应属性

你可以访问反馈响应的属性，例如 title、message、result、feedbackLevel 和 feedbackType。你还可以使用 isSuccess 来检查响应是否成功：

print(response.title);
print(response.message);
print(response.result);
print(response.feedbackLevel);
print(response.feedbackType);
print(response.isSuccess);

类型转换

你可以轻松地将响应的结果转换为任何其他数据类型，使用 resultAsType() 方法：

MyClass myClass = response.resultAsType<MyClass>();

示例代码

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

import 'dart:math';

import 'package:example/services/feedback_response_handler.dart';
import 'package:feedback_response/feedback_response.dart';
import 'package:flutter/material.dart';
import 'package:veto/data/models/base_view_model.dart';

void main() {
  runApp(const HomeView());
}

class HomeView extends StatelessWidget {
  const HomeView({Key? key}) : super(key: key);
  static const String route = 'home-view';

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: Scaffold(
        body: ViewModelBuilder<HomeViewModel>(
          builder: (context, model) => Row(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Padding(
                padding: const EdgeInsets.only(top: 80),
                child: ElevatedButton(
                    onPressed: model.onPressed,
                    child: const Text('随机反馈')),
              ),
            ],
          ),
          viewModelBuilder: () => HomeViewModel.locate,
        ),
      ),
    );
  }
}

class HomeViewModel extends BaseViewModel {
  HomeViewModel({
    required this.feedbackResponseHandler,
  });

  final FeedbackResponseHandler feedbackResponseHandler;

  [@override](/user/override)
  Future<void> initialise({arguments}) async {
    super.initialise();
  }

  [@override](/user/override)
  void dispose() {
    super.dispose();
  }

  void onPressed() {
    feedbackResponseHandler.handleResponse(
      feedbackResponse: FeedbackResponse(
        feedbackLevel:
            FeedbackLevel.values[Random().nextInt(FeedbackLevel.values.length)],
        feedbackType:
            FeedbackType.values[Random().nextInt(FeedbackType.values.length)],
      ),
      context: context!,
    );
  }

  static HomeViewModel get locate => HomeViewModel(
        feedbackResponseHandler: FeedbackResponseHandler(),
      );
}