Flutter设备管理插件simple_managers的使用

Flutter设备管理插件simple_managers的使用

概览

simple_managers 是一个包含多个支持序列化的管理类的包。它目前包含以下管理类：

• FlagManager: 管理单个标志，如开关按钮。
• IndexManager: 管理单一索引值，例如下拉列表。
• TagSelectionManager: 管理单一字符串标签值。
• MultiFlagManager: 管理多标志，例如复选框。
• MultiIndexManager: 管理多索引集，例如分段按钮。
• MultiTagSelectionManager: 管理多字符串标签集。
• TextFieldManager: 文本编辑控制器和焦点管理器。
• ValueManager: 管理单一浮点数。
• StateManager: 包含所有管理类的管理类。当使用 SpWML 时特别有用。
• SingletonStateManager: 封装了 StateManager 的单例类，允许你轻松地保存和恢复整个应用的状态，前提是你的应用中不使用重复的键。

使用

这个包包含多个管理类，但我会解释一下 TextFieldManager，因为它有稍微特殊的用法。

TextFieldManager _tfm = TextFieldManager();

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

通过调用 getCtrl 或 getFocus 方法并传入名称，如果尚未创建，则会内部创建一个新的对象；如果已创建，则返回之前创建的对象。

TextField(
  focusNode: _tfm.getFocus("first"),
  controller: _tfm.getCtrl("first", initialText: "first"),
  onSubmitted: (String s) {
    _tfm.getFocus("second").requestFocus();
  }
)

序列化

调用 toDict 方法会将所有分配的数据序列化为一个 Map。此外，还可以从使用 fromDict 创建的 Map 中检索信息。换句话说，这个包中的管理类使得将输入数据保存到服务器并恢复变得容易。

setState(() {
  _tfm.getCtrl("sendTextSample").text = json.encode(
      _tfm.toDict(nonSaveKeys: ["sendTextSample"]));
});

支持

基本上没有支持。

如果您有任何问题，请提交一个问题。

此包优先级较低，但可能会被修复。

关于版本控制

在版本升级时，C部分可能会更改。

• 添加变量、结构变化等导致读取以前文件出现问题的情况。
  • C.X.X
• 添加方法等。
  • X.C.X
• 小修改和错误修复。
  • X.X.C

如果版本小于1，可能会有重大修正和更改，不受上述限制。

许可证

此软件根据MIT许可证发布，参见 LICENSE 文件。

版权声明

“Dart” 和 “Flutter” 名称是Google LLC的商标。 *此包的开发者不是Google LLC。

完整示例

import 'dart:convert';

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

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

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

class _MyHomePageState extends State<MyHomePage> {
  final TextFieldManager _tfm = TextFieldManager();

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Padding(
            padding: const EdgeInsets.symmetric(horizontal: 36),
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                TextField(
                  focusNode: _tfm.getFocus("first"),
                  controller: _tfm.getCtrl("first", initialText: "first"),
                  onSubmitted: (String s) {
                    _tfm.getFocus("second").requestFocus();
                  },
                ),
                TextField(
                  focusNode: _tfm.getFocus("second"),
                  controller: _tfm.getCtrl("second", initialText: "second"),
                  onSubmitted: (String s) {
                    _tfm.getFocus("third").requestFocus();
                  },
                ),
                TextField(
                  focusNode: _tfm.getFocus("third"),
                  controller: _tfm.getCtrl("third", initialText: "third"),
                  onSubmitted: (String s) {
                    _tfm.getFocus("first").requestFocus();
                  },
                ),
                Container(
                    margin: const EdgeInsets.fromLTRB(0, 12, 0, 12),
                    child: ElevatedButton(
                        onPressed: () {
                          setState(() {
                            _tfm.getCtrl("sendTextSample").text = json.encode(
                                _tfm.toDict(nonSaveKeys: ["sendTextSample"]));
                          });
                        },
                        child: const Text("Send text"))),
                TextField(
                  focusNode: _tfm.getFocus("sendTextSample"),
                  controller: _tfm.getCtrl("sendTextSample"),
                  maxLines: 8,
                  decoration:
                      const InputDecoration(hintText: "send text sample"),
                )
              ],
            )),
      ),
    );
  }
}