结构良好

结构良好的 Widget 字段 — Well-Formed 是一个表单字段包,旨在通过提供开箱即用的字段掩码、验证、智能修剪等功能,为开发者免去大量与表单相关的编码工作。

此外,该包旨在

  • 通过提供具有“语义化”名称的表单字段来提高源代码的可读性——这些名称一眼就能传达其用途——例如“EmailField”、“DigitFields”、“Ipv4Field”等。
  • 根据字段的用途选择键盘类型。
  • 不成为另一个有 bug 的 Flutter 表单包!.

为了成为一个可靠的包,每个类都有完善的文档记录,并通过具有严格质量门限的 CI/CD 管道进行全面的单元测试。

入门

此包中的大多数表单字段都建立在 TextFormField Widget 之上,因此它们与 Form Widget 完全兼容。这一点非常重要,可以避免诸如当父表单重置时字段未重置等 bug 行为。

演示应用程序

演示应用程序提供了一个功能齐全的示例,重点演示了三个 Widget 的实际应用——WellFormedBasicTextFieldDigitField。您可以采用此演示中的代码进行实验。

运行演示应用程序

git clone https://github.com/dartoos-dev/well_formed.git
cd well_formed/example/
flutter run -d chrome

这应该会在 Chrome 浏览器中以调试模式启动演示应用程序。

GitHub

https://github.com/dartoos-dev/well_formed