Package org.zkoss.stateless.sul

Interface ITimepicker

All Superinterfaces:

IAnyGroup<ITimepicker>, IChildrenOfInputgroup<ITimepicker>, IComponent<ITimepicker>, IDateTimeFormatInputElement<ITimepicker>, IFormatInputElement<ITimepicker,java.util.Date>, IHtmlBasedComponent<ITimepicker>, IInputElement<ITimepicker,java.util.Date>, IReadonly<ITimepicker>, IXulElement<ITimepicker>

public interface ITimepicker
extends IDateTimeFormatInputElement<ITimepicker>, IAnyGroup<ITimepicker>

Immutable Timepicker component.

An input box for holding a time (a Date Object}, but only Hour, Minute, Second are used.

Constraint

You could specify what value to accept for input controls by use of the constraint attribute. It could be no empty.

Format

Use a to signify it is am or pm. The input string follows the formatting of the SimpleDateFormat.

Below is an example of using a within the format.

 
 ITimepicker.ofFormat("a hh:mm:ss");
 
 

In addition to specifying the format explicitly, you could specify the styling. There are four different types of styling: short, medium, long and full (representing the styling of DateFormat).

For example, you could specify the styling rather than the real format as follows.

 
 ITimepicker.ofFormat("short");
 ITimepicker.ofFormat("medium");
 
 

Author:

katherine

See Also:

Timepicker

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	ITimepicker.Builder	Builds instances of type ITimepicker.
static class	ITimepicker.Updater	Builds an updater of type ITimepicker for UiAgent.smartUpdate(Locator, SmartUpdater).

Field Summary

Fields

Modifier and Type	Field	Description
static ITimepicker	DEFAULT	Constant for default attributes of this immutable component.

Method Summary

Modifier and Type	Method	Description
default int	getCols()	Returns the cols which determines the visible width, in characters.
default int	getInterval()	Returns the interval time used to generate the options in Timepicker
java.util.Date	getMax()	Returns the maximum time used to generate the options in Timepicker, or null if the default maximum time is used.
java.util.Date	getMin()	Returns the minimum time used to generate the options in Timepicker, or null if the default minimum time is used.(00:00:00 AM)
default java.lang.String	getWidgetClass()	Returns the client widget class.
default boolean	isReadonly()	Returns whether it is readonly.
static ITimepicker	of(java.lang.String format, java.time.temporal.Temporal date)	Return the instance of the given format and date.
static ITimepicker	of(java.lang.String format, java.util.Date date)	Return the instance of the given format and date.
static ITimepicker	of(java.time.temporal.Temporal date)	Return the instance of the given date.
static ITimepicker	of(java.util.Date date)	Return the instance of the given date.
static ITimepicker	ofCols(int cols)	Returns the instance with the given cols.
static ITimepicker	ofConstraint(java.lang.String constraint)	Returns the instance with the given constraint.
static ITimepicker	ofFormat(java.lang.String format)	Returns the instance with the given format.
static ITimepicker	ofId(java.lang.String id)	Returns the instance with the given id.
static ITimepicker	ofLocale(java.lang.String locale)	Returns the instance with the given locale.
static ITimepicker	ofLocale(java.util.Locale locale)	Returns the instance with the given locale.
ITimepicker	withInterval(int interval)	Returns a copy of this immutable component with the specified interval.
default ITimepicker	withLocale(java.lang.String locale)	Returns a copy of this immutable component with the specified locale.
default ITimepicker	withMax(java.time.LocalTime max)	Returns a copy of this immutable component with the specified max.
ITimepicker	withMax(java.util.Date max)	Returns a copy of this immutable component with the specified max.
default ITimepicker	withMin(java.time.LocalTime min)	Returns a copy of this immutable component with the specified min.
ITimepicker	withMin(java.util.Date min)	Returns a copy of this immutable component with the specified min.

Methods inherited from interface org.zkoss.stateless.sul.IComponent

getAction, getActions, getClientAttributes, getId, getMold, getWidgetListeners, getWidgetOverrides, isVisible, withAction, withAction, withAction, withAction, withAction, withAction, withAction, withAction, withAction, withAction, withAction, withActions, withActions, withClientAttribute, withClientAttributes, withId, withMold, withVisible, withWidgetClass, withWidgetListener, withWidgetListeners, withWidgetOverride, withWidgetOverrides

Methods inherited from interface org.zkoss.stateless.sul.IDateTimeFormatInputElement

getLocale, getTimeZone, getValueInLocalDate, getValueInLocalDateTime, getValueInLocalTime, getValueInZonedDateTime, withLocale, withTimeZone, withTimeZone, withValue, withValueInLocalDate, withValueInLocalDateTime, withValueInLocalTime, withValueInZonedDateTime

Methods inherited from interface org.zkoss.stateless.sul.IFormatInputElement

getFormat, withFormat

Methods inherited from interface org.zkoss.stateless.sul.IHtmlBasedComponent

getClientAction, getDraggable, getDroppable, getHeight, getHflex, getLeft, getRenderdefer, getSclass, getStyle, getTabindex, getTooltiptext, getTop, getVflex, getWidth, getZclass, getZIndex, isFocus, withClientAction, withDraggable, withDroppable, withFocus, withHeight, withHflex, withLeft, withRenderdefer, withSclass, withStyle, withTabindex, withTabindex, withTooltiptext, withTop, withVflex, withWidth, withZclass, withZIndex

Methods inherited from interface org.zkoss.stateless.sul.IInputElement

getConstraint, getErrorboxIconSclass, getErrorboxSclass, getErrorMessage, getInputAttributes, getInstant, getMaxlength, getName, getPlaceholder, getValue, isDisabled, isInplace, withCols, withConstraint, withDisabled, withErrorboxIconSclass, withErrorboxSclass, withErrorMessage, withInplace, withInputAttributes, withInstant, withMaxlength, withName, withPlaceholder

Methods inherited from interface org.zkoss.stateless.sul.IReadonly

withReadonly

Methods inherited from interface org.zkoss.stateless.sul.IXulElement

getContext, getCtrlKeys, getPopup, getTooltip, withContext, withCtrlKeys, withPopup, withTooltip

Field Detail

DEFAULT

static final ITimepicker DEFAULT

Constant for default attributes of this immutable component.

Method Detail

getWidgetClass

default java.lang.String getWidgetClass()

Returns the client widget class.

Default: "zkmax.inp.Timepicker"

Specified by:

getWidgetClass in interface IComponent<ITimepicker>

getMin

@Nullable
java.util.Date getMin()

Returns the minimum time used to generate the options in Timepicker, or null if the default minimum time is used.(00:00:00 AM)

withMin

ITimepicker withMin(@Nullable
                    java.util.Date min)

Returns a copy of this immutable component with the specified min.

Sets the minimum time used to generate the options in Timepicker

Parameters:

min - The minimum time used to generate the options in Timepicker

Default: null.

Returns:

A modified copy of the this object

withMin

default ITimepicker withMin(@Nullable
                            java.time.LocalTime min)

Returns a copy of this immutable component with the specified min.

Sets the minimum time used to generate the options in Timepicker

Parameters:

min - The minimum time used to generate the options in Timepicker

Default: null.

Returns:

A modified copy of the this object

getMax

@Nullable
java.util.Date getMax()

Returns the maximum time used to generate the options in Timepicker, or null if the default maximum time is used.

withMax

ITimepicker withMax(@Nullable
                    java.util.Date max)

Returns a copy of this immutable component with the specified max.

Sets the maximum time used to generate the options in Timepicker

Parameters:

max - The maximum time used to generate the options in Timepicker

Default: null.

Returns:

A modified copy of the this object

withMax

default ITimepicker withMax(@Nullable
                            java.time.LocalTime max)

Returns a copy of this immutable component with the specified max.

Sets the maximum time used to generate the options in Timepicker

Parameters:

max - The maximum time used to generate the options in Timepicker

Default: null.

Returns:

A modified copy of the this object

getCols

default int getCols()

Returns the cols which determines the visible width, in characters.

Default: 5 (non-positive means the same as browser's default).

Specified by:

getCols in interface IInputElement<ITimepicker,java.util.Date>

getInterval

default int getInterval()

Returns the interval time used to generate the options in Timepicker

Unit: second

Default: 3600, i.e. 1hr

withInterval

ITimepicker withInterval(int interval)

Returns a copy of this immutable component with the specified interval. Sets the interval time used to generate the options in Timepicker

Unit: 1 second

Parameters:

interval - The time used to generate the options

Returns:

A modified copy of the this object

isReadonly

default boolean isReadonly()

Returns whether it is readonly.

Default: true.

Specified by:

isReadonly in interface IReadonly<ITimepicker>

withLocale

default ITimepicker withLocale(java.lang.String locale)

Description copied from interface: IDateTimeFormatInputElement

Returns a copy of this immutable component with the specified locale.

Sets the locale used to identify the symbols of this number input component.

Specified by:

withLocale in interface IDateTimeFormatInputElement<ITimepicker>

Parameters:

locale - The preferred locale

Default: null, if Locales.getCurrent() is preferred.

Returns:

A modified copy of the this object

of

static ITimepicker of(java.util.Date date)

Return the instance of the given date.

Parameters:

date - The date to indicate the time for the timepicker.

of

static ITimepicker of(java.time.temporal.Temporal date)

Return the instance of the given date.

Parameters:

date - The date to indicate the time for the timepicker.

of

static ITimepicker of(java.lang.String format,
                      java.util.Date date)

Return the instance of the given format and date.

Parameters:

format - The format of the timepicker

date - The date to indicate the value for timepicker.

of

static ITimepicker of(java.lang.String format,
                      java.time.temporal.Temporal date)

Return the instance of the given format and date.

Parameters:

format - The format of the timepicker

date - The date to indicate the value for timepicker.

ofCols

static ITimepicker ofCols(int cols)

Returns the instance with the given cols.

Parameters:

cols - The cols which determines the visible width

ofConstraint

static ITimepicker ofConstraint(java.lang.String constraint)

Returns the instance with the given constraint.

Parameters:

constraint - The timepicker constraint

ofFormat

static ITimepicker ofFormat(java.lang.String format)

Returns the instance with the given format.

Parameters:

format - The timepicker format

ofLocale

static ITimepicker ofLocale(java.lang.String locale)

Returns the instance with the given locale.

Parameters:

locale - The timepicker locale

ofLocale

static ITimepicker ofLocale(java.util.Locale locale)

Returns the instance with the given locale.

Parameters:

locale - The timepicker locale

ofId

static ITimepicker ofId(java.lang.String id)

Returns the instance with the given id.

Parameters:

id - The id to identify this component