moform 0.1.4

Reactive, model-driven, and type-safe forms for Flutter without the overhead of managing a TextEditingController. A light wrapper around Flutter's TextFormField.

Moform

Reactive, model-driven, and type-safe forms for Flutter without the overhead of managing a TextEditingController.

Getting Started

➤ Installation

Add the following to your pubspec.yaml:

dependencies:
  moform: <version>

➤ Usage

In this example, we are using a StringField to manage the value of an email field.

Using a StatefulWidget:

class EmailField extends StatefulWidget {
  @override
  State<EmailField> createState() => _EmailFieldState();
}

class _EmailFieldState extends State<EmailField> {
  String _email = '';

  @override
  Widget build(BuildContext context) {
    return StringField(
      value: _email,
      onChanged: (value) {
        setState(() => _email = value);
      },
    );
  }
}

Using Riverpod:

final emailProvider = StateProvider<String>((ref) => '');

class EmailField extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final email = ref.watch(emailProvider);

    return StringField(
      value: email,
      onChanged: (value) {
        ref.read(emailProvider.notifier).state = value;
      },
    );
  }
}

Features

➤ Typed Fields

String

StringField(
  value: email,
  onChanged: (value) {
    setState(() => email = value);
  },
);

Int

IntField(
  value: age,
  onChanged: (value) {
    setState(() => age = value);
  },
);

Double

DoubleField(
  value: weight,
  onChanged: (value) {
    setState(() => weight = value);
  },
);

DateTime

DateTimeField(
  value: date,
  onChanged: (value) {
    setState(() => date = value);
  },
);

DateTime (Date only)

DateField(
  value: date,
  onChanged: (value) {
    setState(() => date = value);
  },
);

TimeOfDay

TimeField(
  value: time,
  onChanged: (value) {
    setState(() => time = value);
  },
);

➤ Nullable Fields

There are nullable versions of the fields above:

OptionalStringField, OptionalIntField, OptionalDoubleField.

These fields have onChanged callbacks that receive String?, int?, and double? respectively.

OptionalStringField(
  value: email,
  onChanged: (String? value) { // <-- null, when the field is empty
    setState(() => email = value);
  },
);

➤ Custom Styles

Provide a custom widget with the builder parameter.

Be aware that parameters like label are ignored when using a custom widget.

StringField(
  value: email,
  onChanged: (value) {
    setState(() {
      email = value;
    });
  },
  builder: (context, controller) {
    return TextField(
      controller: controller,
      decoration: const InputDecoration(
        labelText: 'Custom Field',
      ),
    );
  },
);

➤ Custom NumberFormat

Available in IntField, DoubleField, and their nullable versions.

IntField(
  value: age,
  numberFormat: NumberFormat.decimalPattern(),
  onChanged: (value) {
    setState(() => age = value);
  },
);