# Time

## Basic #### Default Value Enter the default time to be displayed when the widget is loaded. This can also be retrieved from the backend using query or loaded using low-code.

## Validation #### Required Field Refers to the field that must be completed by the user, which means the field must be entered with a valid value before submitting the information. #### Minimum Time The value set here will be the minimum time value the users can enter or pick on the widget. Any time before this value will not be accepted. #### Maximum Time The value set here will be the maximum time the users can enter or pick on the widget. Any time after this value will not be accepted. #### Custom Rule Apart from validating the entry using the regex rule, users can also use this property to write low-code and check other aspects. For example - check if the city selected in the previous field matches the desired value, throw a custom message to the user even before capturing the entry on this field. ## Interaction #### Event Handlers | Event | Description | | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **`Change`** |

The "Change" event is activated when the value of the widget is changed. When this event triggers, the associated action gets executed.

| | **`Focus`** |

This event is triggered when the widget receives focus, meaning it becomes the active element that can accept user input.

| | **`Blur`** |

This event occurs when the user shifts the focus out of the widget. This can happen in different scenarios, such as when a user clicks outside an input widget they were typing in or when the user tabs to another field.

| #### Disabled Disables the user interaction with the element on the page. It visually indicates that the element is inactive and prevents users from interacting with it when applied. Shows a red-crossed warning symbol and can be customized to disable the widget according to certain conditions using low-code.

#### Hide This sets whether the widget has to be displayed on the screen when the program is loaded. This shows/hides the widget both on desktop and mobile devices.

## Label Represents the caption for the widget in the user interface. It is recommended to keep the label string short and convey the usage of the widget in the UI #### Position | Property | Description | | :------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Left` |

Shows the label on the left side of the widget entry

| | `Top` |

Shows the label on top of the widget entry

| #### Alignment | Property | Description | | :------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Left` |

Align the text on the left corner of the label area

| | `Right` |

Align the text on the right corner of the label area near the tree view

| #### Width Enter a number value to set the width of the widget. It can be set in terms of pixels and percentage.

## Layout #### Format Input the format string in this field and parse the widget value to the required time format. Refer to the following link for more details - [Day.js](https://day.js.org/docs/en/display/format) #### Placeholder Specifies a hint that describes the expected value. The placeholder shows the hint text in the widget when nothing is selected or entered. This text disappears as soon as a value is entered in the control.

#### Widget Tooltip This tooltip pops up when the user moves the mouse over the input area of the widget. It is commonly used to hint at the type of input the user needs to provide. The tooltip will be immediately shown when the user's mouse hovers over the widget, and immediately hides when the user's mouse leaves. This information will be contextual, useful, and informative.

## Advanced | Property | Description | | ----------- | ----------------------------------------------------------------------------------- | | Hour Step | Enter the minimum and maximum numbers for the hour limit. It can be from 1 to 24. | | Minute Step | Enter the minimum and maximum numbers for the minute limit. It can be from 1 to 60. | | Second Step | Enter the minimum and maximum numbers for the second limit. It can be from 1 to 60. | #### Use 12-Hour Format The format for the time section of the widget will be parsed using the 'AM/PM' format instead of '24 hour' format. #### Prefix Icon Choose one from the set of icons that will be displayed as a prefix logo, just before the content.

#### Suffix Icon Choose one from the set of icons that will be displayed as a suffix logo, just after the content.

## Style

Property	Description
Label	Set the colour for the label text. Recommended to set in contrast with the background.
Label Text Size	Set the size of the text in px value - 12px
Background	Users can change the colour of the text background using this property. It has all the RGB colour ranges to pick from. It is recommended to use a corresponding background colour that shows the font clearly.
Border Color	Set the colour to the border lines. The border lines will be shown only if that is enabled.
Border Radius	This sets the radius of the widget's corners, enabling rounded corners on the widget. This value is defined in "px" terms.
Border Width	Set the thickness of the border of the widget using this value. It is defined using "px" terms.
Text	Set the colour of the text. Recommended to set in contrast with the background.
Margin	This value is set in terms of "px" number which creates the space between the border and the content of the widget.
Padding	This value is set in terms of "px" number which creates the space between the border and outer elements.
Prefix Icon Color	Choose a specific color for the icon that appears before the actual widget content.
Suffix Icon Color	Choose a specific color for the icon that appears after the actual widget content.
Prefix Icon Size	Set the size of the prefix icon in px value - 12px
Suffix Icon Size	Set the size of the suffix icon in px value - 12px
Accent	An accent is a typically bright colour that contrasts with the more utilitarian background and foreground colours within a colour scheme. These are present in the visual style of many platforms (though not all). On the web, an accent is sometimes used in input elements for the active portion of the control, for instance, the background of a checked checkbox. MSDN web docs
Validation Message	Set the colour of the validation text message. Recommended to set in contrast with the background, usually Red.