Time Input
- Web Components
- Flutter
Demo
zeta-web v0.6.6
Web Components
Text input component with icon, affix, label and hint text.
To change the width of the input field, either wrap it in a div with a fixed width, or you can apply display: block to the input field, and then provide a width.
Storybook
https://design.zebra.com/web/storybook/?path=/docs/components-text-input--docs
Attributes
| Name | Description | Type | Default |
|---|---|---|---|
| error | Whether text field is in error state. | boolean | false |
| leadingIcon | Leading icon name. | ZetaIconName | undefined | undefined |
| trailingIcon | Trailing icon name. | ZetaIconName | undefined | undefined |
| prefix | Prefix text. | string | "" |
| suffix | Suffix text. | string | undefined | undefined |
| label | Label shown above text field. | string | "" |
| hintText | Hint text shown below text field.if error, then errorText is shown instead. | string | undefined | undefined |
| errorText | Error hint textShown if error, replaces hintText. | string | undefined | undefined |
| type | Type of field | "text" | "textarea" | "password" | "time" | "date" | "number" | "text" |
Inherited Attributes
| Name | Description | Type | Default | Inherited From |
|---|---|---|---|---|
| autoCapitalize | Whether inputted text is automatically capitalized and how. Only takes effect on non-keyboard entry | "none" | "off" | "sentences" | "on" | "words" | "characters" | undefined | undefined | FormField |
| autoComplete | AutoFill | undefined | undefined | FormField | |
| name | The name of the form control. | string | "" | FormField |
| id | The id of the form control. | string | "" | FormField |
| required | Indicates whether the form control is required to be filled out before submitting the form. | boolean | false | FormField |
| value | The value of the Form Control that is submitted when part of a form. | string | null | null | FormField |
| checked | The state of the Switch or Checkbox that is submitted when part of a form. | boolean | undefined | FormField |
| indeterminate | The state of the Switch or Checkbox defined by a mixed or unknown state. | boolean | false | FormField |
| placeholder | Placeholder text shown when value is empty. | string | undefined | undefined | FormField |
| min | The minimum value for number inputs | number | undefined | undefined | FormField |
| max | The maximum value for number inputs | number | undefined | undefined | FormField |
| readOnly | Placeholder text shown when value is empty. | boolean | undefined | undefined | FormField |
| spellCheck | Whether to spellcheck the input | boolean | "default" | undefined | undefined | FormField |
| disabled | Boolean for if component is disabled.This will apply disabled styles. | boolean | false | Interactive |
| size | Size of component | "small" | "medium" | "large" | "medium" | Size |
| rounded | Whether the component is rounded or sharp.When true, rounded will set the border radius of the first child, and any children with class 'contourable-target' to --radius-minimal.Otherwise, this value will be --radius-none. | boolean | undefined | true | Contourable |
| tabIndex | The tab index of the component, used to determine the order in which elements receive focus when the user navigates through the document by pressing the Tab key. | number | 0 | Interactive |
Demo
A form field used to input time.
Widgetbook
Inheritance
Object > DiagnosticableTree > Widget > StatefulWidget > FormField<TimeOfDay> > ZetaFormField<TimeOfDay>
Constructors
Creates a new ZetaTimeInput
ZetaTimeInput.new({Key? key, bool disabled = false, TimeOfDay? initialValue, ValueChanged<TimeOfDay?>? onChange, ZetaFormFieldRequirement? requirementLevel = ZetaFormFieldRequirement.none, FormFieldValidator<TimeOfDay>? validator, bool use24HourFormat = true, String? label, String? hintText, String? errorText, ZetaWidgetSize size = ZetaWidgetSize.medium, TimePickerEntryMode? pickerInitialEntryMode, String? clearSemanticLabel, String? timePickerSemanticLabel, AutovalidateMode? autovalidateMode, ValueChanged<TimeOfDay?>? onFieldSubmitted, FormFieldSetter<TimeOfDay>? onSaved, bool? rounded})
Properties
| Name | Description | Type | Features |
|---|---|---|---|
| autovalidateMode | Used to enable/disable this form field auto validation and update its | AutovalidateMode | final inherited |
| builder | Function that returns the widget representing this form field. | FormFieldBuilder<TimeOfDay> | final inherited |
| clearSemanticLabel | Semantic label for the clear button. | String? | final |
| enabled | Whether the form is able to receive user input. | bool | final inherited |
| errorBuilder | Function that returns the widget representing the error to display. | FormFieldErrorBuilder? | final inherited |
| errorText | The error displayed below the input. | String? | final |
| forceErrorText | An optional property that forces the FormFieldState into an error state | String? | final inherited |
| hashCode | The hash code for this object. | int | no setter inherited |
| hintText | The hint displayed below the input. | String? | final |
| initialValue | An optional value to initialize the form field to, or null otherwise. | TimeOfDay? | final inherited |
| key | Controls how one widget replaces another widget in the tree. | Key? | final inherited |
| label | The label for the input. | String? | final |
| onChange | Called whenever the form field changes. | ValueChanged<TimeOfDay?>? | final inherited |
| onFieldSubmitted | Called whenever the form field is submitted. | ValueChanged<TimeOfDay?>? | final inherited |
| onSaved | An optional method to call with the final value when the form is saved via | FormFieldSetter<TimeOfDay>? | final inherited |
| pickerInitialEntryMode | The initial entry mode of the time picker. | TimePickerEntryMode? | final |
| requirementLevel | The requirement level of the form field. | ZetaFormFieldRequirement? | final inherited |
| restorationId | Restoration ID to save and restore the state of the form field. | String? | final inherited |
| runtimeType | A representation of the runtime type of the object. | Type | no setter inherited |
| size | The size of the input. | ZetaWidgetSize | final |
| timePickerSemanticLabel | Semantic label for the time picker button. | String? | final |
| use24HourFormat | Changes the time input to 12 hour time. | bool | final |
| validator | An optional method that validates an input. Returns an error string to | FormFieldValidator<TimeOfDay>? | final inherited |
Methods
| Name | Description | Type | Features |
|---|---|---|---|
| createElement() | Creates a StatefulElement to manage this widget's location in the tree. | StatefulElement | inherited |
| createState() | Creates the mutable state for this widget at a given location in the tree. | FormFieldState<TimeOfDay> | override |
| debugDescribeChildren() | Returns a list of DiagnosticsNode objects describing this node's children. | List<DiagnosticsNode> | inherited |
| debugFillProperties(DiagnosticPropertiesBuilder properties) | Add additional properties associated with the node. | void | override |
| noSuchMethod(Invocation invocation) | Invoked when a nonexistent method or property is accessed. | dynamic | inherited |
| paddingAll(double space) | Available on Widget, provided by the SpacingWidget extension | Widget | undefined |
| paddingBottom(double space) | Available on Widget, provided by the SpacingWidget extension | Widget | undefined |
| paddingEnd(double space) | Available on Widget, provided by the SpacingWidget extension | Widget | undefined |
| paddingHorizontal(double space) | Available on Widget, provided by the SpacingWidget extension | Widget | undefined |
| paddingStart(double space) | Available on Widget, provided by the SpacingWidget extension | Widget | undefined |
| paddingTop(double space) | Available on Widget, provided by the SpacingWidget extension | Widget | undefined |
| paddingVertical(double space) | Available on Widget, provided by the SpacingWidget extension | Widget | undefined |
| toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) | Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep. | DiagnosticsNode | inherited |
| toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) | A string representation of this object. | String | inherited |
| toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) | Returns a string representation of this node and its descendants. | String | inherited |
| toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) | Returns a one-line detailed description of the object. | String | inherited |
| toStringShort() | A short, textual description of this widget. | String | inherited |
Figma