TextFieldCell class

An interactive table cell that allows users to input text directly into the report grid.

Features built-in visual cues managed by the ReportController engine:

  • Default: Light grey background indicating editability.
  • Soft Correction (Yellow): Amber tint with an info icon when a value is auto-corrected.
  • Hard Error (Red): Red tint with an error icon when validation explicitly fails.
Inheritance

Constructors

TextFieldCell({Key? key, TextEditingController? controller, String initialValue = '', ValueChanged<String>? onChanged, double? cellWidth, double? cellHeight, double? textSize, AlignmentGeometry? textAlignment = Alignment.center, Color? backgroundColor, Color? textColor = Colors.black, Color? borderColor, bool isBold = false, InputDecoration? decoration, TextInputType? keyboardType, List<TextInputFormatter>? inputFormatters, String? errorText, bool isOverridden = false, String? overrideMessage, String? hintText, TextStyle? textStyle})
Creates a TextFieldCell.

Properties

backgroundColor → Color?
The base background color of the cell.
final
borderColor → Color?
The base color of the cell borders.
final
cellHeight → double?
The target height of the cell.
final
cellWidth → double?
The target width of the cell.
final
controller → TextEditingController
The controller that manages the text being edited.
final
decoration → InputDecoration?
Custom decoration for the internal TextFormField.
final
errorText → String?
System flag: Error message set by ReportController causing a Red UI state.
final
exportAlignment → AlignmentGeometry?
The alignment metadata used to format the cell during data export.
no setteroverride
exportBackgroundColor → Color?
The background color metadata used to style the cell during data export.
no setteroverride
exportIsBold → bool
A flag indicating if the text should be formatted as bold in exported documents.
no setteroverride
exportTextColor → Color?
The text color metadata used to style the text during data export.
no setteroverride
exportValue → String
The raw string representation of the cell's data.
no setteroverride
hashCode → int
The hash code for this object.
no setterinherited
hintText → String?
Placeholder text (hint) to display when the input field is empty.
final
inputFormatters → List<TextInputFormatter>?
A list of formatters that restrict or format text as the user types.
final
isBold → bool
Whether the input text should be rendered as bold.
final
isOverridden → bool
System flag: Indicates if the engine automatically altered the user's input.
final
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
keyboardType → TextInputType?
The type of digital keyboard to display on mobile devices.
final
onChanged → ValueChanged<String>?
A callback triggered whenever the text in the field changes.
final
overrideMessage → String?
System flag: The tooltip message displayed during a Yellow UI state.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
textAlignment → AlignmentGeometry?
How the text should be aligned within the input field.
final
textColor → Color?
The base color of the input text.
final
textSize → double?
The font size of the input text.
final
textStyle → TextStyle?
An optional custom TextStyle that overrides or merges with the default styling.
final

Methods

build(BuildContext context) → Widget
Describes the part of the user interface represented by this widget.
override
copyWith({double? cellWidth, double? cellHeight, double? textSize, String? errorText, bool? isOverridden, String? overrideMessage, String? hintText, ValueChanged<String>? onChanged}) → TextFieldCell
Creates a new instance of the ReportCell with updated dimensions.
override
createElement() → StatelessElement
Creates a StatelessElement to manage this widget's location in the tree.
inherited
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