TimePicker Overview
The TimePicker component is a useful tool that enables users to select time values either from a time selector popup or by entering new values directly. It is a crucial interface tool for applications that require precise time settings, such as appointment booking, event planning, or task scheduling. With the TimePicker, users can choose hours and minutes available in AM/PM or 24-hour formats. It offers incremental adjustments for detailed control, ensuring accurate and efficient time selection.
Live Demo
Appearance
The TimePicker component provides built-in styling options that grant visually appealing and flexible rendering experience.
Apart from the default vision of the Telerik and Kendo UI TimePicker, the component supports alternative styling options that enable you to configure the individual aspects of its appearance.
States
Depending on the action you want to imply through its appearance, the Telerik and Kendo UI TimePicker can acquire various states which you can set by using the following classes:
- A TimePicker in its normal state is fully active, but the user is not interacting with it. This is the default state of the component. It can contain an explanatory placeholder text or an already prefilled text.
k-hover
—The hover state of a TimePicker is applied when the user hovers over the component but does not click it. The mouse pointer changes to indicate that you can type into the component.k-focus
—The focus state of the TimePicker is triggered when the user navigates to the component by keyboard, voice, or mouse click. This state highlights the DatePicker so that it covers all accessibility requirements.k-invalid
—The invalid state of the TimePicker indicates that the input validation requirements are not met. The user is notified that the entered data is incorrect and must be revised so that the input operation can complete.k-invalid k-focus
—The invalid focus state is a result of spotlighting a TimePicker whose value or input type does not pass the validation requirements.k-disabled
—The disabled state of the TimePicker indicates that the user cannot interact with the component. When disabled, the component has no interactive behavior, it is faded out and slightly out of focus, which helps the user to distinguish it from the active elements on the page.
Anatomy
The anatomy of the TimePicker summarizes the elements of the component.
The next image shows the anatomy of a TimePicker and includes the following elements:
- Input field
- Icon button
- Label (optional when used in the Form component)
- Hint text (optional when used in the Form component)
- Placeholder or preselected value
- Clear icon
- Popup with time selector and footer
- Header with time and flat button
- Column title
- Column with list items
- Highlight
- Action buttons
Size
The TimePicker provides the size
configuration option that enables you to control how big or small the rendered TimePickers will be. Options for size customization are also at your disposal.
size
provides the following available options:
small
—Renders small TimePickers, which are suitable for compact components, such as Toolbars, where the available space is limited.medium
(default)—Renders medium TimePickers.large
—Renders large TimePickers, which are suitable for adaptive designs.none
—Does not set asize
and allows you to add your own, custom value.
- Small
- Medium (default)
- Large
Fill Mode
The TimePicker provides the fillMode
configuration option that enables you to visually achieve a certain atmosphere in your app. TimePicker also provides options for fill-mode customization. By default, the TimePicker is rendered in solid colors.
fillMode
provides the following available options:
solid
(default)—The solid fill mode focuses on the layout and emphasizes the text field. It can be wrapped in a container with a different background color making the TimePicker stand out.outline
—The outline fill mode focuses less on the text field. The outlined TimePicker does not have a background fill and can blend with the surrounding UI environment.flat
—The flat fill mode emphasizes less the text field and more the data input. Also, the flat fill mode reduces additional visual noise and focuses on the content.none
—Does not set afillMode
and allows you to add your own, custom value.
- Solid (default)
- Outline
- Flat
Border Radius
The TimePicker provides the rounded
option that enables you to control the border radius of the rendered input field. The defined value for the border-radius significantly affects the look-and-feel of the UI. The TimePicker also provides options for border-radius customization.
rounded
provides the following available options:
small
—Renders a border radius of 2 px.medium
(default)—Renders a border radius of 4 px.large
—Renders a border radius of 6 px.full
—Renders a border radius of 9999 px.none
—Does not set arounded
value and allows you to add your own, custom value.
- Small
- Medium (default)
- Large
- Full
Framework-Specific Documentation
For specific information about the component, refer to its official product documentation: