Time widget
The Time Widget enables the rendering of time input fields, allowing users to select and display time values within your application for time-related functionality and interactions.
Properties
| Property | Type | Description |
|---|---|---|
| id | string | ID to be referenced later |
| maxWidth | integer | The max width of this Input widget (default 700) |
| label | string | Label for your widget |
| labelHint | string | Hint text on your label |
| hintText | string | Hint text explaining your widget |
| required | boolean | Whether the field is required |
| enabled | boolean | Enables or disables the interactivity and input functionality of the widget |
| icon | object | See properties |
| onChange | Call Ensemble's built-in functions or execute code when the input changes. Note for free-form text input, this event only dispatches if the text changes AND the focus is lost (e.g. clicking on button) | |
| styles | object | See properties |
| initialValue | string | The highlighted initial time in the time picker. Use format HH:MM |
| useIOSStyleTimePicker | boolean | Use iOS-style time picker on supported platforms (default: true for iOS & false for Android) |
| use24hFormat | boolean | Use 24-hour format for time display (default: false) |
icon
| Property | Type | Description |
|---|---|---|
| name | string | The name of the icon |
| library | string | Which icon library to use. |
| color | integer or string | The color specification for the text, which can be represented in different formats. It can be specified as a number, a predefined color name, or a hexadecimal value starting with '0x'. transparent black blue white red grey teal amber pink purple yellow green brown cyan indigo lime orange |
| size | integer | Defines the dimensions or magnitude of an element, allowing control over its overall size within the layout. |
styles
| Property | Type | Description |
|---|---|---|
| expanded | boolean | If the parent is a Row or Column, this flag will stretch this widget in the appropriate direction. (e.g stretch horizontally for parent of type Row) |
| iOSStyles | object | iOS specific styles |
| androidStyles | object | Android specific styles |
| variant | string | Select a pre-defined look and feel for this Input widget. This property can be defined in the theme to apply to all Input widgets. |
| contentPadding | integer or string | Padding around your input content with CSS-style notation e.g. margin: 5 20 5 |
| fillColor | integer or string | The fill color for this input fields. This property can be defined in the theme to apply to all Input widgets, starting with '0xFF' for full opacity. transparent black blue white red grey teal amber pink purple yellow green brown cyan indigo lime orange |
| borderRadius | integer | The border radius for this Input widget. This property can be defined in the theme to apply to all Input widgets. |
| borderWidth | integer | The border width for this Input widget. This property can be defined in the theme to apply to all Input widgets. |
| borderColor | integer or string | Sets the border color, starting with '0xFF' for full opacity. transparent black blue white red grey teal amber pink purple yellow green brown cyan indigo lime orange |
| errorBorderColor | integer or string | The border color when there are errors on this input field. This property can be defined in the theme to apply to all Input widgets, starting with '0xFF' for full opacity. transparent black blue white red grey teal amber pink purple yellow green brown cyan indigo lime orange |
| focusedBorderColor | integer or string | The border color when this input field is receiving focus. This property can be defined in the theme to apply to all Input widgets, starting with '0xFF' for full opacity. transparent black blue white red grey teal amber pink purple yellow green brown cyan indigo lime orange |
| focusedErrorBorderColor | integer or string | The border color of this input field when it is receiving focus in its error state. This property can be defined in the theme to apply to all Input widgets, starting with '0xFF' for full opacity. transparent black blue white red grey teal amber pink purple yellow green brown cyan indigo lime orange |
| disabledBorderColor | integer or string | The border color when this input field is disabled. This property can be defined in the theme to apply to all Input widgets, starting with '0xFF' for full opacity. transparent black blue white red grey teal amber pink purple yellow green brown cyan indigo lime orange |
| variant | string | Select a pre-defined look and feel for this Input widget. This property can be defined in the theme to apply to all Input widgets. see properties |
| visible | boolean | Toggle a widget visibility on/off. Note that an invisible widget will not occupy UI space, unless the visibilityTransitionDuration is specified. |
| visibilityTransitionDuration | number | Specify the duration in seconds when a widget animates between visible and not visible state. Note that setting this value will cause the widget to still occupy the UI space even when it is not visible. |
| stackPositionTop | integer | The distance of the child's top edge from the top of the stack. This is applicable only for Stack's children. |
| stackPositionBottom | integer | The distance that the child's bottom edge from the bottom of the stack. This is applicable only for Stack's children. |
| stackPositionLeft | integer | The distance that the child's left edge from the left of the stack. This is applicable only for Stack's children. |
| stackPositionRight | integer | The distance that the child's right edge from the right of the stack. This is applicable only for Stack's children. |
| alignment | string | The alignment of the widget relative to its parent. topLeft, topCenter, topRight, centerLeft, center, centerRight, bottomLeft, bottomCenter, bottomRight |
| elevation | integer | The z-coordinate at which to place this material relative to its parent. A non-zero value will show a shadow, with its size relative to the elevation value. Minimum value: 0, Maximum value: 24 |
| elevationShadowColor | integer or string | The shadow color for the elevation, which can be represented in different formats. It can be specified as a number, a predefined color name, or a hexadecimal value starting with '0x'. transparent black blue white red grey teal amber pink purple yellow green brown cyan indigo lime orange |
| elevationBorderRadius | string or integer | The border radius of the widget.This can be specified using CSS-like notation with 1 to 4 integers. Minimum value: 0. |
| captureWebPointer | boolean | Applicable for Web only. When overlaying widgets on top of certain HTML container (e.g. Maps), the mouse click is captured by the HTML container, causing issue interacting with the widget. Use this to capture and maintain the mouse pointer on your widget. |
iOSStyles
| Property | Type | Description |
|---|---|---|
| backgroundColor | string | Background color of the iOS-style picker |
| height | number | Height of the iOS-style picker |
| padding | object | Padding for the iOS-style picker |
androidStyles
| Property | Type | Description |
|---|---|---|
| initialEntryMode | string | Initial entry mode for the Android-style picker (default: "dial") |
| cancelText | string | Text for the cancel button in Android-style picker |
| confirmText | string | Text for the confirm button in Android-style picker |
| orientation | string | Orientation of the Android-style picker (default: "portrait") |
| backgroundColor | string | Background color of the Android-style picker |
| buttonStyle | object | Style for buttons in the Android-style picker |
| dialBackgroundColor | string | Background color of the dial in Android-style picker |
| dialHandColor | string | Color of the dial hand in Android-style picker |
| dialTextColor | string | Color of the dial text in Android-style picker |
| dialTextStyle | object | Style for the dial text in Android-style picker |
| elevation | number | Elevation of the Android-style picker |
| entryModeIconColor | string | Color of the entry mode icon in Android-style picker |
| helpTextStyle | object | Style for the help text in Android-style picker |
| hourMinuteBackgroundColor | string | Background color of the hour/minute section in Android-style picker |
| hourMinuteTextStyle | object | Style for the hour/minute text in Android-style picker |
| padding | object | Padding for the Android-style picker |