com.vaadin.flow.component.timepicker

Class TimePicker

java.lang.Object

com.vaadin.flow.component.Component

com.vaadin.flow.component.AbstractField<C,T>

com.vaadin.flow.component.AbstractSinglePropertyField<R,T>

com.vaadin.flow.component.timepicker.GeneratedVaadinTimePicker<TimePicker,LocalTime>

com.vaadin.flow.component.timepicker.TimePicker

All Implemented Interfaces:

AttachNotifier, BlurNotifier<TimePicker>, DetachNotifier, Focusable<TimePicker>, FocusNotifier<TimePicker>, HasElement, HasEnabled, HasSize, HasStyle, HasValidation, HasValue<AbstractField.ComponentValueChangeEvent<TimePicker,LocalTime>,LocalTime>, HasValueAndElement<AbstractField.ComponentValueChangeEvent<TimePicker,LocalTime>,LocalTime>, Serializable

@JavaScript(value="frontend://timepickerConnector.js")
public class TimePicker
extends GeneratedVaadinTimePicker<TimePicker,LocalTime>
implements HasSize, HasValidation, HasEnabled

An input component for selecting time of day, based on vaadin-time-picker web component.

Author:

Vaadin Ltd

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.vaadin.flow.component.timepicker.GeneratedVaadinTimePicker

GeneratedVaadinTimePicker.InvalidChangeEvent<R extends GeneratedVaadinTimePicker<R,?>>

Nested classes/interfaces inherited from class com.vaadin.flow.component.AbstractField

AbstractField.ComponentValueChangeEvent<C extends Component,V>

Nested classes/interfaces inherited from interface com.vaadin.flow.component.BlurNotifier

BlurNotifier.BlurEvent<C extends Component>

Nested classes/interfaces inherited from interface com.vaadin.flow.component.FocusNotifier

FocusNotifier.FocusEvent<C extends Component>

Nested classes/interfaces inherited from interface com.vaadin.flow.component.HasValue

HasValue.ValueChangeEvent<V>, HasValue.ValueChangeListener<E extends HasValue.ValueChangeEvent<?>>

Constructor Summary

Constructors

Constructor and Description
TimePicker() Default constructor.
TimePicker(HasValue.ValueChangeListener<AbstractField.ComponentValueChangeEvent<TimePicker,LocalTime>> listener) Convenience constructor to create a time picker with a ValueChangeListener.
TimePicker(LocalTime time) Convenience constructor to create a time picker with a pre-selected time.
TimePicker(String label) Convenience constructor to create a time picker with a label.
TimePicker(String label, LocalTime time) Convenience constructor to create a time picker with a pre-selected time and a label.

Method Summary

Modifier and Type	Method and Description
Registration	addInvalidChangeListener(ComponentEventListener<GeneratedVaadinTimePicker.InvalidChangeEvent<TimePicker>> listener) Adds a listener for invalid-changed events fired by the webcomponent.
String	getErrorMessage() Gets the current error message from the time picker.
String	getLabel() Gets the label of the time picker.
Locale	getLocale() Gets the Locale for this time picker.
String	getPlaceholder() Gets the placeholder of the time picker.
Duration	getStep() Gets the step of the time picker.
static Stream<Locale>	getSupportedAvailableLocales() Returns a stream of all the available locales that are supported by the time picker component.
boolean	isInvalid() Gets the validity of the time picker output.
boolean	isRequired() Determines whether the time picker is marked as input required.
protected void	onAttach(AttachEvent attachEvent) Called when the component is attached to a UI.
void	setErrorMessage(String errorMessage) Description copied from corresponding location in WebComponent:
void	setInvalid(boolean invalid) Description copied from corresponding location in WebComponent:
void	setLabel(String label) Description copied from corresponding location in WebComponent:
void	setLocale(Locale locale) Set the Locale for the Time Picker.
void	setMax(String max) Set the minimum values for the date picker.
void	setMin(String min) Set the minimum values for the date picker.
void	setPlaceholder(String placeholder) Description copied from corresponding location in WebComponent:
void	setRequired(boolean required) Description copied from corresponding location in WebComponent:
void	setStep(Duration step) Sets the step property of the time picker using duration.
void	setValue(LocalTime value) Sets the value of this object.

Methods inherited from class com.vaadin.flow.component.timepicker.GeneratedVaadinTimePicker

checkValidity, getErrorMessageString, getI18nJsonObject, getLabelString, getNameString, getPatternString, getPlaceholderString, getStepDouble, isAutofocusBoolean, isDisabledBoolean, isInvalidBoolean, isPreventInvalidInputBoolean, isReadonlyBoolean, isRequiredBoolean, setAutofocus, setDisabled, setI18n, setName, setPattern, setPreventInvalidInput, setReadonly, setStep, validate

Methods inherited from class com.vaadin.flow.component.AbstractSinglePropertyField

hasValidValue, setPresentationValue, setSynchronizedEvent

Methods inherited from class com.vaadin.flow.component.AbstractField

addValueChangeListener, getEmptyValue, getValue, isEmpty, setModelValue, valueEquals

Methods inherited from class com.vaadin.flow.component.Component

addListener, fireEvent, from, get, getChildren, getElement, getEventBus, getId, getParent, getTranslation, getTranslation, getUI, hasListener, isTemplateMapped, isVisible, onDetach, onEnabledStateChanged, set, setElement, setId, setVisible

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.vaadin.flow.component.HasSize

getHeight, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getWidth, setHeight, setHeightFull, setMaxHeight, setMaxWidth, setMinHeight, setMinWidth, setSizeFull, setSizeUndefined, setWidth, setWidthFull

Methods inherited from interface com.vaadin.flow.component.HasEnabled

isEnabled, setEnabled

Methods inherited from interface com.vaadin.flow.component.HasElement

getElement

Methods inherited from interface com.vaadin.flow.component.HasStyle

addClassName, addClassNames, getClassName, getClassNames, getStyle, hasClassName, removeClassName, removeClassNames, setClassName, setClassName

Methods inherited from interface com.vaadin.flow.component.Focusable

addFocusShortcut, blur, focus, getTabIndex, setTabIndex

Methods inherited from interface com.vaadin.flow.component.BlurNotifier

addBlurListener

Methods inherited from interface com.vaadin.flow.component.FocusNotifier

addFocusListener

Methods inherited from interface com.vaadin.flow.component.HasValueAndElement

isReadOnly, isRequiredIndicatorVisible, setReadOnly, setRequiredIndicatorVisible

Methods inherited from interface com.vaadin.flow.component.HasValue

clear, getOptionalValue

Methods inherited from interface com.vaadin.flow.component.AttachNotifier

addAttachListener

Methods inherited from interface com.vaadin.flow.component.DetachNotifier

addDetachListener

Constructor Detail

TimePicker

public TimePicker()

Default constructor.

TimePicker

public TimePicker(LocalTime time)

Convenience constructor to create a time picker with a pre-selected time.

Parameters:

time - the pre-selected time in the picker

TimePicker

public TimePicker(String label)

Convenience constructor to create a time picker with a label.

Parameters:

label - the label describing the time picker

See Also:

setLabel(String)

TimePicker

public TimePicker(String label,
                  LocalTime time)

Convenience constructor to create a time picker with a pre-selected time and a label.

Parameters:

label - the label describing the time picker

time - the pre-selected time in the picker

TimePicker

public TimePicker(HasValue.ValueChangeListener<AbstractField.ComponentValueChangeEvent<TimePicker,LocalTime>> listener)

Convenience constructor to create a time picker with a ValueChangeListener.

Parameters:

listener - the listener to receive value change events

See Also:

AbstractField.addValueChangeListener(HasValue.ValueChangeListener)

Method Detail

setLabel

public void setLabel(String label)

Description copied from class: GeneratedVaadinTimePicker

Description copied from corresponding location in WebComponent:

The label for this element.

Overrides:

setLabel in class GeneratedVaadinTimePicker<TimePicker,LocalTime>

Parameters:

label - the String value to set

setValue

public void setValue(LocalTime value)

Description copied from interface: HasValue

Sets the value of this object. If the new value is not equal to getValue(), fires a value change event. May throw IllegalArgumentException if the value is not acceptable.

Implementation note: the implementing class should document whether null values are accepted or not, and override HasValue.getEmptyValue() if the empty value is not null.

Specified by:

setValue in interface HasValue<AbstractField.ComponentValueChangeEvent<TimePicker,LocalTime>,LocalTime>

Overrides:

setValue in class AbstractField<TimePicker,LocalTime>

Parameters:

value - the new value

getLabel

public String getLabel()

Gets the label of the time picker.

Returns:

the label property of the time picker

setErrorMessage

public void setErrorMessage(String errorMessage)

Description copied from class: GeneratedVaadinTimePicker

Description copied from corresponding location in WebComponent:

The error message to display when the input is invalid.

Specified by:

setErrorMessage in interface HasValidation

Overrides:

setErrorMessage in class GeneratedVaadinTimePicker<TimePicker,LocalTime>

Parameters:

errorMessage - the String value to set

getErrorMessage

public String getErrorMessage()

Gets the current error message from the time picker.

Specified by:

getErrorMessage in interface HasValidation

Returns:

the current error message

setInvalid

public void setInvalid(boolean invalid)

Description copied from class: GeneratedVaadinTimePicker

Description copied from corresponding location in WebComponent:

Set to true if the value is invalid.

Specified by:

setInvalid in interface HasValidation

Overrides:

setInvalid in class GeneratedVaadinTimePicker<TimePicker,LocalTime>

Parameters:

invalid - the boolean value to set

isInvalid

public boolean isInvalid()

Gets the validity of the time picker output.

return true, if the value is invalid.

Specified by:

isInvalid in interface HasValidation

Returns:

the validity property from the time picker

setPlaceholder

public void setPlaceholder(String placeholder)

Description copied from class: GeneratedVaadinTimePicker

Description copied from corresponding location in WebComponent:

A placeholder string in addition to the label.

Overrides:

setPlaceholder in class GeneratedVaadinTimePicker<TimePicker,LocalTime>

Parameters:

placeholder - the String value to set

getPlaceholder

public String getPlaceholder()

Gets the placeholder of the time picker.

This property is not synchronized automatically from the client side, so the returned value may not be the same as in client side.

Returns:

the placeholder property of the time picker

setRequired

public void setRequired(boolean required)

Description copied from class: GeneratedVaadinTimePicker

Description copied from corresponding location in WebComponent:

Set to true to mark the input as required.

Overrides:

setRequired in class GeneratedVaadinTimePicker<TimePicker,LocalTime>

Parameters:

required - the boolean value to set

isRequired

public boolean isRequired()

Determines whether the time picker is marked as input required.

This property is not synchronized automatically from the client side, so the returned value may not be the same as in client side.

Returns:

true if the input is required, false otherwise

setStep

public void setStep(Duration step)

Sets the step property of the time picker using duration. It specifies the intervals for the displayed items in the time picker dropdown and also the displayed time format.

The set step needs to evenly divide a day or an hour and has to be larger than 0 milliseconds. By default, the format is hh:mm (same as * Duration.ofHours(1)

If the step is less than 60 seconds, the format will be changed to hh:mm:ss and it can be in hh:mm:ss.fff format, when the step is less than 1 second.

NOTE: If the step is less than 900 seconds, the dropdown is hidden.

NOTE: changing the step to a larger duration can cause a new HasValue.ValueChangeEvent to be fired if some parts (eg. seconds) is discarded from the value.

Parameters:

step - the step to set, not null and should divide a day or an hour evenly

getStep

public Duration getStep()

Gets the step of the time picker.

This property is not synchronized automatically from the client side, so the returned value may not be the same as in client side.

Returns:

the step property from the picker, unit seconds

addInvalidChangeListener

public Registration addInvalidChangeListener(ComponentEventListener<GeneratedVaadinTimePicker.InvalidChangeEvent<TimePicker>> listener)

Description copied from class: GeneratedVaadinTimePicker

Adds a listener for invalid-changed events fired by the webcomponent.

Overrides:

addInvalidChangeListener in class GeneratedVaadinTimePicker<TimePicker,LocalTime>

Parameters:

listener - the listener

Returns:

a Registration for removing the event listener

onAttach

protected void onAttach(AttachEvent attachEvent)

Description copied from class: Component

Called when the component is attached to a UI.

The default implementation does nothing.

This method is invoked before the AttachEvent is fired for the component.

Overrides:

onAttach in class Component

Parameters:

attachEvent - the attach event

setLocale

public void setLocale(Locale locale)

Set the Locale for the Time Picker. The displayed time will be formatted by the browser using the given locale.

By default, the locale is null until the component is attached to an UI, and then locale is set to UI.getLocale(), unless a locale has been explicitly set before that.

The time formatting is done in the browser using the Date.toLocaleTimeString() function.

If for some reason the browser doesn't support the given locale, the en-US locale is used.

NOTE: only the language + country/region codes are used. This means that the script and variant information is not used and supported. NOTE: timezone related data is not supported. NOTE: changing the locale does not cause a new HasValue.ValueChangeEvent to be fired.

Parameters:

locale - the locale set to the time picker, cannot be [@code null}

getLocale

public Locale getLocale()

Gets the Locale for this time picker.

By default, the locale is null until the component is attached to an UI, and then locale is set to UI.getLocale(), unless setLocale(Locale) has been explicitly called before that.

Overrides:

getLocale in class Component

Returns:

the locale used for this time picker

setMin

public void setMin(String min)

Set the minimum values for the date picker.

Overrides:

setMin in class GeneratedVaadinTimePicker<TimePicker,LocalTime>

Parameters:

min - the String value to set

setMax

public void setMax(String max)

Set the minimum values for the date picker.

Overrides:

setMax in class GeneratedVaadinTimePicker<TimePicker,LocalTime>

Parameters:

max - the String value to set

getSupportedAvailableLocales

public static Stream<Locale> getSupportedAvailableLocales()

Returns a stream of all the available locales that are supported by the time picker component.

This is a shorthand for Locale.getAvailableLocales() where all locales without the Locale.getLanguage() have been filtered out, as the browser cannot localize the time for those.

Returns:

a stream of the available locales that are supported by the time picker component

See Also:

setLocale(Locale), Locale.getAvailableLocales(), Locale.getLanguage()