Flutter序列化控制器插件serializable_controllers的使用

Flutter序列化控制器插件serializable_controllers的使用

serializable_controllers 是一个简单的包，旨在处理表单中的值时减少一些样板代码。

概述

通过 SerializableControllersManager 类使用 makeController 方法创建控制器，并将它们分配给表单中所需的部件。每个控制器都实现了 ValueNotifier，因此可以轻松监听更改。

您可以随时通过 SerializableControllersManager 的 toJson 方法获取值的序列化。

请记住在使用完毕后调用 dispose 方法来避免内存泄漏！

提供的控制器

SerializableTextEditingController

为 TextEditingController 提供抽象。内部的 TextEditingController 可通过对象的 controller 属性访问。

示例：

final serializableTextEditingController = manager.makeController(
      () => SerializableTextEditingController(id: 'myId'),
    );

final textEditingController = serializableTextEditingController.controller;

您可以直接监听对象来代替无聊的监听器：

ValueListenableBuilder(
    valueListenable: nameController,
    builder: (_, value, __) => Text(value ?? ''),
),

SerializableChangeController

提供了一种通过小部件的 ValueChanged 回调轻松更新值的方法。

示例：

final checkboxController = manager.makeController(
      () => SerializableChangeController(
        id: 'radio',
        initialValue: false,
      ),
    );

使用方法如下：

// 在构建方法中
ValueListenableBuilder(
    valueListenable: checkboxController,
    builder: (context, value, _) =>
        CheckboxListTile(
        value: value,
        onChanged: checkboxController.valueChanged,
        title: Text('Boolean check'),
        )
),

如您所见，您可以轻松更新UI而无需太多麻烦。

自定义控制器

您可以通过扩展 SerializableController<T> 来创建自己的控制器！

打印值

假设您已经创建了 manager：

final manager = SerializableControllersManager();

只需调用：

print(jsonEncode(manager.toJson()));

查看示例以了解更多信息。

完整示例

以下是一个完整的示例，展示了如何使用 serializable_controllers 插件：

import 'dart:convert';

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

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

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

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Home(),
    );
  }
}

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

class _HomeState extends State<Home> {
  final manager = SerializableControllersManager();
  SerializableTextEditingController nameController;
  SerializableTextEditingController surnameController;
  SerializableChangeController checkboxController;

  [@override](/user/override)
  void initState() {
    nameController = manager.makeController(
      () => SerializableTextEditingController(id: 'nome', initialValue: 'Pippo'),
    );

    surnameController = manager.makeController(
      () => SerializableTextEditingController(id: 'cognome'),
    );

    checkboxController = manager.makeController(
      () => SerializableChangeController(
        id: 'radio',
        initialValue: false,
      ),
    );
    super.initState();
  }

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Serializable controllers'),
      ),
      body: Column(
        children: [
          TextFormField(
            controller: nameController.controller,
          ),
          ValueListenableBuilder(
            valueListenable: nameController,
            builder: (_, value, __) => Text(value ?? ''),
          ),
          TextFormField(
            controller: surnameController.controller,
          ),
          ValueListenableBuilder(
            valueListenable: checkboxController,
            builder: (context, value, _) => CheckboxListTile(
              value: value,
              onChanged: checkboxController.valueChanged,
              title: Text('Boolean check'),
            ),
          ),
          ElevatedButton(
            onPressed: () {
              final encoder = JsonEncoder.withIndent(' ');
              final encoded = encoder.convert(manager);
              return showDialog(
                context: context,
                builder: (_) => AlertDialog(
                  content: Text(encoded),
                ),
              );
            },
            child: Text('Submit'),
          )
        ],
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: manager.resetControllers,
        child: Icon(Icons.restore),
      ),
    );
  }
}