TDateTimeTextField<T extends String?> class

A text field specifically for Date, Time, or DateTime input with automatic formatting.

TDateTimeTextField provides:

  • Masked input (e.g., DD/MM/YYYY)
  • Automatic insertion of separators (slashes, colons, spaces)
  • Digit-only filtering
  • Dynamic placeholder based on format
  • Integrated icons based on type

Basic Usage

TDateTimeTextField(
  label: 'Birth Date',
  formatType: TDateTimeFormatType.date,
  onValueChanged: (value) => print('Date: $value'),
)

Time Input

TDateTimeTextField(
  label: 'Start Time',
  formatType: TDateTimeFormatType.time,
)
Inheritance
Mixed-in types
Available extensions

Constructors

TDateTimeTextField({Key? key, String? label, String? tag, String? helperText, String? placeholder, String? info, bool isRequired = false, bool disabled = false, bool autoFocus = false, bool readOnly = false, bool clearable = false, TTextFieldTheme? theme, VoidCallback? onTap, FocusNode? focusNode, TextEditingController? textController, T? value, ValueNotifier<T?>? valueNotifier, ValueChanged<T?>? onValueChanged, List<String? Function(T?)>? rules, Duration? validationDebounce, TDateTimeFormatType formatType = TDateTimeFormatType.date})
Creates a formatted date/time text field.
const

Properties

autoFocus bool
Whether the field should autofocus.
final
clearable bool
Whether the field shows a clear button when it has a value.
final
disabled bool
Whether the field is disabled.
final
focusNode FocusNode?
Custom focus node.
final
formatType TDateTimeFormatType
The format type (date, time, or dateTime).
final
hashCode int
The hash code for this object.
no setterinherited
helperText String?
The helper text.
final
info String?
The info text (optional).
final
isRequired bool
Whether the field is required.
final
key Key?
Controls how one widget replaces another widget in the tree.
finalinherited
label String?
The label text.
final
onTap VoidCallback?
Callback for tap events.
final
onValueChanged ValueChanged<T?>?
Callback fired when the value changes.
final
placeholder String?
Placeholder text.
final
readOnly bool
Whether the field is read-only.
final
rules List<String? Function(T?)>?
List of validation rules.
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
tag String?
The tag text (optional).
final
textController TextEditingController?
Custom text controller.
final
theme TTextFieldTheme?
Custom theme.
final
validationDebounce Duration?
Debounce duration for validation trigger.
final
value → T?
The initial value.
final
valueNotifier ValueNotifier<T?>?
A ValueNotifier for two-way binding.
final

Methods

box({double minW = 0.0, double minH = 0.0, double maxW = double.infinity, double maxH = double.infinity}) Widget

Available on Widget, provided by the WidgetX extension

Wraps this widget in a ConstrainedBox to apply layout constraints.
center({bool when = true}) Widget

Available on Widget, provided by the WidgetX extension

Wraps this widget in a Center widget.
createElement() StatefulElement
Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() State<TDateTimeTextField<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
expanded({int flex = 1}) Widget

Available on Widget, provided by the WidgetX extension

Wraps this widget in an Expanded widget.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
padding([double left = 0.0, double top = 0.0, double right = 0.0, double bottom = 0.0]) Widget

Available on Widget, provided by the WidgetX extension

Wraps this widget in a Padding with flexible edge control.
paddingSymmetric({double h = 0.0, double v = 0.0}) Widget

Available on Widget, provided by the WidgetX extension

Wraps this widget in a Padding with symmetric horizontal and vertical spacing.
size({double? w, double? h}) Widget

Available on Widget, provided by the WidgetX extension

Wraps this widget in a SizedBox to apply fixed width and/or height.
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
validateValue(T? value) List<String>
Validates the given value against the rules.
inherited
visible(bool visible, {bool maintainState = false}) Widget

Available on Widget, provided by the WidgetX extension

Wraps this widget in a Visibility widget.
when(bool condition) Widget

Available on Widget, provided by the WidgetX extension

Returns this widget if condition is true, otherwise returns SizedBox.shrink(). Usage: Text('Hello').when(isVisible)

Operators

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