PersianInputDatePickerFormField class

A TextFormField configured to accept and validate a date entered by a user.

When the field is saved or submitted, the text will be parsed into a Jalali according to the ambient locale's compact date format. If the input text doesn't parse into a date, the errorFormatText message will be displayed under the field.

firstDate, lastDate, and selectableDayPredicate provide constraints on what days are valid. If the input date isn't in the date range or doesn't pass the given predicate, then the errorInvalidText message will be displayed under the field.

See also:

• showDatePicker, which shows a dialog that contains a Material Design date picker which includes support for text entry of dates.
• MaterialLocalizations.parseCompactDate, which is used to parse the text input into a Jalali.

Inheritance

• Object
• DiagnosticableTree
• Widget
• StatefulWidget
• PersianInputDatePickerFormField

Constructors

PersianInputDatePickerFormField({Key? key, Jalali? initialDate, required Jalali firstDate, required Jalali lastDate, ValueChanged<Jalali>? onDateSubmitted, ValueChanged<Jalali>? onDateSaved, PersianSelectableDayPredicate? selectableDayPredicate, String? errorFormatText, String? errorInvalidText, String? fieldHintText, String? fieldLabelText, TextInputType? keyboardType, bool autofocus = false, bool acceptEmptyDate = false, FocusNode? focusNode})

Creates a TextFormField configured to accept and validate a date.

Properties

acceptEmptyDate → bool

Determines if an empty date would show errorFormatText or not.

final

autofocus → bool

Whether this text field should focus itself if nothing else is already focused.

final

errorFormatText → String?

The error text displayed if the entered date is not in the correct format.

final

errorInvalidText → String?

The error text displayed if the date is not valid.

final

fieldHintText → String?

The hint text displayed in the TextField.

final

fieldLabelText → String?

The label text displayed in the TextField.

final

firstDate → Jalali

The earliest allowable Jalali that the user can input.

final

focusNode → FocusNode?

An optional focus node to use as the focus node for this widget.

final

hashCode → int

The hash code for this object.

no setter, inherited

initialDate → Jalali?

If provided, it will be used as the default value of the field.

final

key → Key?

Controls how one widget replaces another widget in the tree.

final, inherited

keyboardType → TextInputType?

The keyboard type of the TextField.

final

lastDate → Jalali

The latest allowable Jalali that the user can input.

final

onDateSaved → ValueChanged<Jalali>?

An optional method to call with the final date when the form is saved via FormState.save. Will only be called if the input represents a valid Jalali.

final

onDateSubmitted → ValueChanged<Jalali>?

An optional method to call when the user indicates they are done editing the text in the field. Will only be called if the input represents a valid Jalali.

final

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

selectableDayPredicate → PersianSelectableDayPredicate?

Function to provide full control over which Jalali can be selected.

final

Methods

createElement() → StatefulElement

Creates a StatefulElement to manage this widget's location in the tree.

inherited

createState() → State<PersianInputDatePickerFormField>

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