Flutter文本表单插件simple_text_form_field的使用

simple_text_form_field 是一个用于创建简单文本表单字段的插件，适用于iOS、Android、Windows和Web平台。此包包含多个自定义小部件，例如：

1. <code>SimpleTextFormField</code>：用于创建简单的文本输入框。
2. <code>SimpleTextFormFieldDate</code>：用于创建日期选择器或时间选择器。
3. <code>SimpleTextFormFieldDropDown</code>：用于创建通用的下拉菜单。

使用示例

要使用此插件，只需在 pubspec.yaml 文件中添加依赖项 <code>simple_text_form_field</code> 即可。

示例代码

以下是一个完整的示例代码，展示如何使用 simple_text_form_field 插件来创建文本输入框、日期选择器、时间选择器以及下拉菜单，并获取其值。

import 'package:flutter/material.dart';
import 'package:simple_text_form_field/simple_text_form_field.dart';
import 'package:simple_text_form_field/simple_text_form_field_date.dart';
import 'package:simple_text_form_field/simple_text_form_field_dropdown.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

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

class MyHomePage extends StatefulWidget {
  const MyHomePage({
    Key? key,
  }) : super(key: key);

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

class _MyHomePageState extends State<MyHomePage> {
  // 定义控制器
  SimpleTextFormFieldController controller = SimpleTextFormFieldController();
  SimpleTextFormFieldDateController controllerDate =
      SimpleTextFormFieldDateController();
  SimpleTextFormFieldDateController controllerTime =
      SimpleTextFormFieldDateController();
  SimpleTextFormFieldDropDownController<ItemModel> controllerDropdown =
      SimpleTextFormFieldDropDownController();

  String? text = "";
  String? date = "";
  String? time = "";
  String? objectSelected;

  List<ItemModel> lists = [];

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

  void _populateList() {
    setState(() {
      lists.add(ItemModel(mainTitle: "First Title", dateTime: DateTime.now(), desc: "This is the first description of title"));
      lists.add(ItemModel(mainTitle: "Second Title", dateTime: DateTime.now(), desc: "This is the second description of title"));
      lists.add(ItemModel(mainTitle: "Third Title", dateTime: DateTime.now(), desc: "This is the third description of title"));
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text("Simple Usage"),
      ),
      body: Padding(
        padding: const EdgeInsets.all(10),
        child: Column(
          children: [
            // 文本输入框
            SimpleTextFormField(
              controller: controller,
              isRequired: true,
              errorTextSize: 8,
              maxLength: 12,
              label: "Name",
              placeHolder: "Input your name",
            ),
            const Padding(padding: EdgeInsets.all(10)),

            // 日期选择器
            SimpleTextFormFieldDate(
              isRequired: true,
              fillColor: Colors.transparent,
              controller: controllerDate,
              firstDate: DateTime.now(),
              label: "Your Date",
            ),
            const Padding(padding: EdgeInsets.all(10)),

            // 时间选择器
            SimpleTextFormFieldDate(
              isRequired: true,
              fillColor: Colors.transparent,
              controller: controllerTime,
              type: InputDatetimeType.time,
              label: "Your Time",
            ),
            const Padding(padding: EdgeInsets.all(10)),

            // 下拉菜单
            SimpleTextFormFieldDropDown<ItemModel>(
              controller: controllerDropdown,
              required: true,
              label: "Select one",
              valueItem: (e) => e.mainTitle!,
              listItem: lists,
            ),
            Padding(
              padding: const EdgeInsets.all(8.0),
              child: InkWell(
                onTap: () {
                  // 验证并获取值
                  if (controller.isValid &&
                      controllerDate.isValid &&
                      controllerTime.isValid &&
                      controllerDropdown.isValid) {
                    setState(() {
                      text = controller.value;
                      date = SimpleConstants.dateToString(controllerDate.value, format: "dd/MM/yyyy");
                      time = controllerTime.value.format(context);
                      objectSelected = controllerDropdown.value?.mainTitle;
                    });
                  }
                },
                child: const Padding(
                  padding: EdgeInsets.all(8.0),
                  child: Text(
                    "Save",
                    style: TextStyle(color: Colors.blue),
                  ),
                ),
              ),
            ),
            Padding(
              padding: const EdgeInsets.all(10),
              child: Text(
                "Text : $text, \nDate : $date, \nTime : $time, \nDropdown : ${objectSelected ?? ""}",
              ),
            )
          ],
        ),
      ),
    );
  }
}

// 自定义数据模型
class ItemModel {
  final String mainTitle;
  final DateTime dateTime;
  final String desc;

  ItemModel({required this.mainTitle, required this.dateTime, required this.desc});
}