TTimePicker class
A time picker input with clock interface.
TTimePicker provides time selection with:
- Clock-style time picker
- Custom time format
- Validation support
- ValueNotifier integration
Basic Usage
TTimePicker(
label: 'Meeting Time',
placeholder: 'Select time',
onValueChanged: (time) => print('Selected: \$time'),
)
With Custom Format
TTimePicker(
label: 'Start Time',
format: DateFormat('HH:mm'), // 24-hour format
)
See also:
- TDatePicker for date selection
- TDateTimePicker for combined date-time selection
- Inheritance
-
- Object
- DiagnosticableTree
- Widget
- StatefulWidget
- TTimePicker
- Mixed-in types
- Available extensions
Constructors
-
TTimePicker({Key? key, String? label, String? tag, String? helperText, String? placeholder, String? info, bool isRequired = false, bool disabled = false, bool autoFocus = false, bool readOnly = true, bool clearable = false, TTextFieldTheme? theme, VoidCallback? onTap, FocusNode? focusNode, TextEditingController? textController, TimeOfDay? value, ValueNotifier<
TimeOfDay?> ? valueNotifier, ValueChanged<TimeOfDay?> ? onValueChanged, List<String? Function(TimeOfDay?)> ? rules, Duration? validationDebounce, VoidCallback? onShow, VoidCallback? onHide, DateFormat? format}) -
Creates a time picker.
const
Properties
- alignment → TPopupAlignment
-
Preferred alignment of the popup.
no setterinherited
- 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
- format → DateFormat?
-
Custom time format for display.
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
- offset → double
-
Offset from the target widget.
no setterinherited
- onHide → VoidCallback?
-
Callback when popup hides.
final
- onShow → VoidCallback?
-
Callback when popup shows.
final
- onTap → VoidCallback?
-
Callback for tap events.
final
-
onValueChanged
→ ValueChanged<
TimeOfDay?> ? -
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(TimeOfDay?)> ? -
List of validation rules.
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- showCloseButton → bool
-
Whether to show a close button in the popup.
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 → TimeOfDay?
-
The initial value.
final
-
valueNotifier
→ ValueNotifier<
TimeOfDay?> ? -
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< TTimePicker> -
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(
TimeOfDay? 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 ifconditionis true, otherwise returns SizedBox.shrink(). Usage: Text('Hello').when(isVisible)
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited