Flutter用户反馈插件complaints的使用

Flutter用户反馈插件complaints的使用

特性

• 投诉页面：该插件包含多个页面，如complaints_type.dart、complaints_location.dart、complaints_details.dart等，这些页面为提交投诉提供了用户界面。

• 投诉BLoCs：它提供了各种BLoCs，如ComplaintsInboxBloc、ComplaintsRegistrationBloc，用于使用BLoC模式进行状态管理。这些BLoCs处理提交投诉的业务逻辑。

• 投诉模型：它定义了各种数据模型，如PgrAddressModel、PgrComplaintModel、PgrServiceModel等，用于投诉管理过程。

• 投诉仓库：该插件提供了抽象类的数据仓库，如PgrServiceLocalRepository、PgrServiceRemoteRepository，可以扩展以创建不同投诉模型的仓库。

开始使用

要使用此插件，在你的pubspec.yaml文件中添加以下依赖项：

dependencies:
  complaints: ^any

使用示例

要导航到插件中的任何屏幕：

首先在主应用路由中添加complaint_router：

然后使用以下代码导航到所需的屏幕：

context.router.push(ComplaintsInboxWrapperRoute()),

complaints包需要从主应用传递以下数据：

String? tenantId;
String? loggedInUserUuid;
String? userMobileNumber;
String? loggedInUserName;
List<String>? complaintTypes;
String? userName;

完整示例代码

以下是一个完整的示例代码，展示了如何在Flutter应用中集成并使用complaints插件：

import 'dart:convert';

import 'package:complaints/blocs/localization/app_localization.dart';
import 'package:complaints/complaints.dart';
import 'package:digit_ui_components/digit_components.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

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

class Language {
  late String label;
  late String value;

  Language(this.label, this.value);
}

class Localization {
  late String code;
  late String message;
  late String module;
  late String locale;
}

Future<dynamic> loadLocalizedStrings() async {
  final String jsonString = await rootBundle.loadString('lib/localization_strings.json');
  final decode = json.decode(jsonString);

  List<Localization> localizationList;
  localizationList = decode.map((e) {
    final data = e;
    return Localization()
      ..code = data['code']
      ..locale = data['locale']
      ..module = data['module']
      ..message = data['message'];
  }).toList();

  return Future.value(localizationList);
}

class MyApp extends StatelessWidget {
  late Future<dynamic> localizedStrings = loadLocalizedStrings();
  MyApp({super.key});

  // 这个小部件是你的应用的根组件。
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: MyHomePage(title: "Complaints Package Demo"),
      locale: Locale('en', 'MZ'),
      supportedLocales: [const Locale('en', 'MZ')],
      localizationsDelegates: [
        ComplaintsLocalization.getDelegate(loadLocalizedStrings(), [Language("English", "en_MZ")]),
        // 添加其他本地化委托（如果需要）
      ],
    );
  }
}

class MyHomePage extends StatefulWidget {
  final String title;
  MyHomePage({super.key, required this.title});

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

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  void initState() {
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    final theme = Theme.of(context);
    return Scaffold(
        appBar: AppBar(
          title: Text("PGR-Complaints 示例"),
        ),
        body: Center(
          child: DigitButton(
            onPressed: () {
              Navigator.of(context).push(
                MaterialPageRoute(
                  builder: (BuildContext context) => ComplaintsAcknowledgementPage(),
                ),
              );
            },
            label: "演示确认",
            type: DigitButtonType.secondary,
            size: DigitButtonSize.large,
          ),
        ));
  }
}