Flutter表单输入字段插件ffr_form_input_field的使用

ffr_form_input_field 是一个基于 Flutter 开发的表单输入字段插件。该插件的源代码完全由 Dart 编写，并且所有必要的文件都位于 /lib 文件夹中。

安装

在 pubspec.yaml 文件的 dependencies: 部分添加以下行：

ffr_form_input_field: <latest_version>

然后在项目中导入该插件：

import 'package:ffr_form_input_field/ffr_form_input_field.dart';

基本用法

以下是一个完整的示例，展示了如何使用 ffr_form_input_field 插件来创建一个表单输入字段。

示例代码

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

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

class _MyHomePageState extends State<MyHomePage> {
  final GlobalKey<ScaffoldState> _scaffoldKey = GlobalKey<ScaffoldState>();
  final _formKey = GlobalKey<FormState>();
  final _testKey = GlobalKey<FormFieldState<String>>();
  final FocusNode _testNode = FocusNode();
  bool isError = false;
  String text = '';

  // 提交表单的方法
  void _saveForm() {
    if (_formKey.currentState.validate()) {
      if (isError == false) {
        setState(() {
          text = _testKey.currentState.value;
        });
        _testKey.currentState.reset();
      } else {
        _scaffoldKey.currentState.showSnackBar(
          SnackBar(content: Text('A value must be entered')),
        );
      }
    }
  }

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      key: _scaffoldKey,
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            // 表单组件
            Form(
              key: _formKey,
              child: Column(
                children: [
                  // 输入字段
                  Padding(
                    padding: const EdgeInsets.only(bottom: 30),
                    child: FFRFromInputField(
                      // 自动聚焦
                      autofocus: true,
                      focusNode: _testNode,
                      // 字段提交时隐藏键盘
                      onFieldSubmitted: (term) {
                        _testNode.unfocus();
                      },
                      // 提示文本
                      hintText: 'I am a Text input field',
                      // 背景色
                      backgroundColor: Colors.lightGreen,
                      // 图标
                      icon: Icon(Icons.check_box),
                      // 字段的 Key
                      fieldKey: _testKey,
                      // 是否显示错误状态
                      isError: isError,
                      // 输入类型
                      textInputType: TextInputType.text,
                      // 验证逻辑
                      validate: (String newValue) {
                        if (newValue.isEmpty) {
                          setState(() {
                            isError = true;
                          });
                        } else {
                          setState(() {
                            isError = false;
                          });
                        }
                      },
                      // 文本样式
                      textStyle: TextStyle(color: Colors.black, fontSize: 20),
                      // 错误颜色
                      errorColor: Colors.red,
                    ),
                  ),
                  // 提交按钮
                  ElevatedButton(
                    onPressed: _saveForm,
                    child: Text('Press me'),
                  ),
                ],
              ),
            ),
            SizedBox(height: 30),
            // 显示输入结果
            text == '' ? Container() : Text(text),
          ],
        ),
      ),
    );
  }
}