TItemsFormBuilder<T extends TFormBase> class

A dynamic form builder for managing lists of sub-forms.

TItemsFormBuilder provides dynamic list management with:

  • Add/remove items dynamically
  • Each item is a complete form (TFormBase)
  • Configurable add button position
  • Automatic value synchronization

Usage Example

class AddressForm extends TFormBase {
  final street = TFieldProp<String>('');
  final city = TFieldProp<String>('');

  @override
  List<TFormField> get fields => [
    TFormField.text(street, 'Street'),
    TFormField.text(city, 'City'),
  ];
}

final addresses = TFieldProp<List<AddressForm>>([]);

TFormField.items(
  addresses,
  () => AddressForm(),
  label: 'Addresses',
  buttonLabel: 'Add Address',
)

Type parameter:

  • T: The form type (must extend TFormBase)

See also:

Inheritance
Mixed-in types

Constructors

TItemsFormBuilder({Key? key, List<T>? value, ValueChanged<List<T>?>? onValueChanged, ValueNotifier<List<T>?>? valueNotifier, required T onNewItem(), String? label, String buttonLabel = 'Add New', TItemAddPosition itemAddPosition = TItemAddPosition.first})
Creates an items form builder.
const

Properties

buttonLabel → String
Label for the add button.
final
hashCode → int
The hash code for this object.
no setterinherited
itemAddPosition → TItemAddPosition
Where to add new items (first or last).
final
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
label → String?
Optional label for the form list.
final
onNewItem → T Function()
Factory function to create new items.
final
onValueChanged → ValueChanged<List<T>?>?
Callback fired when the value changes.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
value → List<T>?
The initial value.
final
valueNotifier → ValueNotifier<List<T>?>?
A ValueNotifier for two-way binding.
final

Methods

createElement() → StatefulElement
Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() → State<TItemsFormBuilder<T>>
Creates the mutable state for this widget at a given location in the tree.
override
debugDescribeChildren() → List<DiagnosticsNode>
Returns a list of DiagnosticsNode objects describing this node's children.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.
inherited
toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) → String
A string representation of this object.
inherited
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) → String
Returns a string representation of this node and its descendants.
inherited
toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String
Returns a one-line detailed description of the object.
inherited
toStringShort() → String
A short, textual description of this widget.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited