gwt.material.design.client.ui

Class MaterialDatePicker

java.lang.Object

com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.Widget

com.google.gwt.user.client.ui.Panel

com.google.gwt.user.client.ui.ComplexPanel

gwt.material.design.client.base.MaterialWidget

gwt.material.design.client.ui.MaterialDatePicker

All Implemented Interfaces:

com.google.gwt.editor.client.Editor<Date>, com.google.gwt.editor.client.HasEditorErrors<Date>, com.google.gwt.event.dom.client.HasBlurHandlers, com.google.gwt.event.logical.shared.HasAttachHandlers, com.google.gwt.event.logical.shared.HasCloseHandlers<MaterialDatePicker>, com.google.gwt.event.logical.shared.HasOpenHandlers<MaterialDatePicker>, com.google.gwt.event.logical.shared.HasValueChangeHandlers<Date>, com.google.gwt.event.shared.HasHandlers, com.google.gwt.user.client.EventListener, com.google.gwt.user.client.TakesValue<Date>, com.google.gwt.user.client.ui.Focusable, com.google.gwt.user.client.ui.HasEnabled, com.google.gwt.user.client.ui.HasValue<Date>, com.google.gwt.user.client.ui.HasVisibility, com.google.gwt.user.client.ui.HasWidgets, com.google.gwt.user.client.ui.HasWidgets.ForIsWidget, com.google.gwt.user.client.ui.IndexedPanel, com.google.gwt.user.client.ui.IndexedPanel.ForIsWidget, com.google.gwt.user.client.ui.IsWidget, HasErrorHandler, HasCenterOn, HasCircle, HasColors, HasDataAttributes, HasDepth, HasError, HasFlexbox, HasFloat, HasFontSize, HasFontWeight, HasGrid, HasHideOn, HasHoverable, HasIcon, HasId, HasInitialClasses, HasInlineStyle, HasOpacity, HasOrientation, HasPlaceholder, HasScrollspy, HasSeparator, HasShadow, HasShowOn, HasTextAlign, HasTooltip, HasWaves, HasBlankValidator, HasValidators<Date>, ValidationChangedEvent.HasValidationChangedHandlers, Iterable<com.google.gwt.user.client.ui.Widget>

public class MaterialDatePicker
extends MaterialWidget
implements HasGrid, HasError, HasOrientation, HasPlaceholder, com.google.gwt.user.client.ui.HasValue<Date>, com.google.gwt.event.logical.shared.HasOpenHandlers<MaterialDatePicker>, com.google.gwt.event.logical.shared.HasCloseHandlers<MaterialDatePicker>, com.google.gwt.editor.client.HasEditorErrors<Date>, HasErrorHandler, HasValidators<Date>, HasBlankValidator, com.google.gwt.event.dom.client.HasBlurHandlers, HasIcon

Material Date Picker will provide a visual calendar to your apps.

UiBinder Usage:

<m:MaterialDatePicker ui:field="datePicker">

Java Usage:

datePicker.setDate(new Date());

Author:

kevzlou7979, Ben Dol

See Also:

Material Date Picker

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MaterialDatePicker.MaterialDatePickerType Enum for identifying various selection types for the picker.

Nested classes/interfaces inherited from class gwt.material.design.client.base.MaterialWidget

MaterialWidget.Feature

Nested classes/interfaces inherited from class com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.UIObject.DebugIdImpl, com.google.gwt.user.client.ui.UIObject.DebugIdImplEnabled

Nested classes/interfaces inherited from interface com.google.gwt.editor.client.Editor

com.google.gwt.editor.client.Editor.Ignore, com.google.gwt.editor.client.Editor.Path

Nested classes/interfaces inherited from interface com.google.gwt.user.client.ui.IndexedPanel

com.google.gwt.user.client.ui.IndexedPanel.ForIsWidget

Nested classes/interfaces inherited from interface com.google.gwt.user.client.ui.HasWidgets

com.google.gwt.user.client.ui.HasWidgets.ForIsWidget

Field Summary

Fields inherited from class com.google.gwt.user.client.ui.UIObject

DEBUG_ID_PREFIX

Constructor Summary

Constructors

Constructor and Description
MaterialDatePicker()

Method Summary

Modifier and Type	Method and Description
com.google.gwt.event.shared.HandlerRegistration	addBlurHandler(com.google.gwt.event.dom.client.BlurHandler handler)
com.google.gwt.event.shared.HandlerRegistration	addCloseHandler(com.google.gwt.event.logical.shared.CloseHandler<MaterialDatePicker> handler)
com.google.gwt.event.shared.HandlerRegistration	addOpenHandler(com.google.gwt.event.logical.shared.OpenHandler<MaterialDatePicker> handler)
com.google.gwt.event.shared.HandlerRegistration	addValidationChangedHandler(ValidationChangedEvent.ValidationChangedHandler handler) Adds a validation changed handler.
void	addValidator(Validator<Date> validator) Adds the validator.
com.google.gwt.event.shared.HandlerRegistration	addValueChangeHandler(com.google.gwt.event.logical.shared.ValueChangeHandler<Date> handler)
void	clear()
void	clearErrorOrSuccess()
void	clearValues() Clears the values of the picker field.
void	clearValues(com.google.gwt.dom.client.Element picker)
Date	getDate() Same as calling getValue()
Date	getDateMax()
Date	getDateMin()
static com.google.gwt.core.client.JsDate	getDatePickerValue(com.google.gwt.dom.client.Element picker)
ErrorHandler	getErrorHandler() Gets the error handler.
ErrorHandlerType	getErrorHandlerType() Gets the error handler type.
String	getFormat()
MaterialIcon	getIcon() Get the icon widget.
DatePickerLanguage	getLanguage()
Orientation	getOrientation()
protected Date	getPickerDate()
static String	getPickerId(com.google.gwt.dom.client.Element inputSrc)
String	getPlaceholder()
MaterialDatePicker.MaterialDatePickerType	getSelectionType()
Date	getValue()
static com.google.gwt.dom.client.Element	initDatePicker(com.google.gwt.dom.client.Element inputSrc, String typeName, String format)
boolean	isAllowBlank()
boolean	isIconPrefix() Is the icon prefix in the container.
boolean	isValidateOnBlur() Gets the validate on blur.
protected void	onAttach()
protected void	onDetach()
void	reinitialize() Re initialize the datepicker
void	removeErrorModifiers()
boolean	removeValidator(Validator<Date> validator) Removes the validator.
void	reset() Reset the form element to blank and clear error messages.
void	setAllowBlank(boolean allowBlank)
void	setDate(Date date) Sets the current date of the picker.
void	setDateMax(Date dateMax)
void	setDateMin(Date dateMin)
void	setDateSelectionType(MaterialDatePicker.MaterialDatePickerType type) Sets the type of selection options (date, month, year,...).
void	setEnabled(boolean enabled)
void	setError(String error) Errors occur when an app fails to complete what is expected, such as: - The app does not understand user input - The system or app fails - A user intends to run incompatible operations concurrently
void	setErrorHandler(ErrorHandler errorHandler) Sets the error handler.
void	setErrorHandlerType(ErrorHandlerType errorHandlerType) Sets the error handler type.
void	setFormat(String format) To call before initialization
void	setGrid(String grid) Setting the grid for responsiveness don't forget to build rows first before setting the grid on each material widgets.
void	setHelperText(String helperText)
void	setIconColor(String iconColor) Sets the color of the icon.
void	setIconFontSize(double size, com.google.gwt.dom.client.Style.Unit unit) Set the font size of the icon.
void	setIconPosition(IconPosition position) Set the position of the icon.
void	setIconPrefix(boolean prefix) Make the icon prefix in its container.
void	setIconSize(IconSize size) Size of icon.
void	setIconType(IconType iconType) Set Material Design icon.
void	setLanguage(DatePickerLanguage language)
void	setOffset(String offset) Setting the offset.
void	setOrientation(Orientation orientation)
void	setPickerDate(com.google.gwt.core.client.JsDate date, com.google.gwt.dom.client.Element picker)
void	setPickerDateMax(com.google.gwt.core.client.JsDate date, com.google.gwt.dom.client.Element picker)
void	setPickerDateMin(com.google.gwt.core.client.JsDate date, com.google.gwt.dom.client.Element picker)
void	setPlaceholder(String placeholder)
void	setSelectionType(MaterialDatePicker.MaterialDatePickerType selectionType)
void	setSuccess(String success)
void	setValidateOnBlur(boolean validateOnBlur) Sets the validate on blur.
void	setValidators(Validator<Date>... validators) The validators used to validate this object.
void	setValue(Date value)
void	setValue(Date value, boolean fireEvents)
void	showErrors(List<com.google.gwt.editor.client.EditorError> errors)
void	stop() Stop the datepicker instance
protected void	stop(com.google.gwt.dom.client.Element picker)
boolean	validate() Validate the field's value using the supplied validators.
boolean	validate(boolean show) Validate the field's value using the supplied validators.

Methods inherited from class gwt.material.design.client.base.MaterialWidget

add, add, clearActiveClass, enableFeature, getBackgroundColor, getCenterOn, getCenterOnMixin, getCircleMixin, getColorsMixin, getDataAttribute, getDepth, getEnabledMixin, getFlexboxMixin, getFloat, getFloatMixin, getFocusableMixin, getFontSize, getFontSizeMixin, getFontWeight, getFontWeightMixin, getGridMixin, getHideOn, getHideOnMixin, getHoverableMixin, getId, getIdMixin, getInitialClasses, getOpacity, getScrollspy, getScrollspyMixin, getSeparatorMixin, getShadow, getShadowMixin, getShowOn, getShowOnMixin, getTabIndex, getTextAlign, getTextAlignMixin, getTextColor, getTooltip, getTooltipDelayMs, getTooltipMixin, getTooltipPosition, getTruncateMixin, getWaves, getWavesMixin, getWidth, getWidth, insert, insert, isCircle, isEnabled, isFeatureEnabled, isHoverable, isSeparator, onLoad, setAccessKey, setBackgroundColor, setBottom, setCenterOn, setCircle, setDataAttribute, setDepth, setDisplay, setFlex, setFlexAlignContent, setFlexAlignItems, setFlexAlignSelf, setFlexBasis, setFlexDirection, setFlexGrow, setFlexJustifyContent, setFlexOrder, setFlexShrink, setFlexWrap, setFloat, setFocus, setFontSize, setFontSize, setFontWeight, setGwtDisplay, setHideOn, setHoverable, setId, setInitialClasses, setLayoutPosition, setLeft, setMargin, setMarginBottom, setMarginLeft, setMarginRight, setMarginTop, setOpacity, setOverflow, setPadding, setPaddingBottom, setPaddingLeft, setPaddingRight, setPaddingTop, setRight, setScrollspy, setSeparator, setShadow, setShowOn, setTabIndex, setTextAlign, setTextColor, setTooltip, setTooltipDelayMs, setTooltipPosition, setTop, setTruncate, setVisibility, setWaves, stopTouchStartEvent, stopTouchStartEvent

Methods inherited from class com.google.gwt.user.client.ui.ComplexPanel

add, adjustIndex, checkIndexBoundsForAccess, checkIndexBoundsForInsertion, getChildren, getWidget, getWidgetCount, getWidgetIndex, getWidgetIndex, insert, iterator, remove, remove

Methods inherited from class com.google.gwt.user.client.ui.Panel

add, adopt, doAttachChildren, doDetachChildren, orphan, remove

Methods inherited from class com.google.gwt.user.client.ui.Widget

addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, fireEvent, getHandlerCount, getLayoutData, getParent, isAttached, isOrWasAttached, onBrowserEvent, onUnload, removeFromParent, setLayoutData, sinkEvents, unsinkEvents

Methods inherited from class com.google.gwt.user.client.ui.UIObject

addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getOffsetHeight, getOffsetWidth, getStyleElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, getTitle, isVisible, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, resolvePotentialElement, setElement, setElement, setHeight, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setTitle, setVisible, setVisible, setWidth, sinkBitlessEvent, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface gwt.material.design.client.base.HasFlexbox

setVisible

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

MaterialDatePicker

public MaterialDatePicker()

Method Detail

onAttach

protected void onAttach()

Overrides:

onAttach in class com.google.gwt.user.client.ui.Widget

onDetach

protected void onDetach()

Overrides:

onDetach in class com.google.gwt.user.client.ui.Widget

clear

public void clear()

Specified by:

clear in interface com.google.gwt.user.client.ui.HasWidgets

Overrides:

clear in class com.google.gwt.user.client.ui.Panel

removeErrorModifiers

public void removeErrorModifiers()

setDateSelectionType

public void setDateSelectionType(MaterialDatePicker.MaterialDatePickerType type)

Sets the type of selection options (date, month, year,...).

Parameters:

type - if null, MaterialDatePicker.MaterialDatePickerType.DAY will be used as fallback.

getPickerId

public static String getPickerId(com.google.gwt.dom.client.Element inputSrc)

initDatePicker

public static com.google.gwt.dom.client.Element initDatePicker(com.google.gwt.dom.client.Element inputSrc,
                                                               String typeName,
                                                               String format)

setDate

public void setDate(Date date)

Sets the current date of the picker.

Parameters:

date - - must not be null

getDateMin

public Date getDateMin()

setDateMin

public void setDateMin(Date dateMin)

setPickerDateMin

public void setPickerDateMin(com.google.gwt.core.client.JsDate date,
                             com.google.gwt.dom.client.Element picker)

getDateMax

public Date getDateMax()

setDateMax

public void setDateMax(Date dateMax)

setPickerDateMax

public void setPickerDateMax(com.google.gwt.core.client.JsDate date,
                             com.google.gwt.dom.client.Element picker)

setPickerDate

public void setPickerDate(com.google.gwt.core.client.JsDate date,
                          com.google.gwt.dom.client.Element picker)

getDate

public Date getDate()

Same as calling getValue()

getPickerDate

protected Date getPickerDate()

getDatePickerValue

public static com.google.gwt.core.client.JsDate getDatePickerValue(com.google.gwt.dom.client.Element picker)

clearValues

public void clearValues()

Clears the values of the picker field.

clearValues

public void clearValues(com.google.gwt.dom.client.Element picker)

getPlaceholder

public String getPlaceholder()

Specified by:

getPlaceholder in interface HasPlaceholder

setPlaceholder

public void setPlaceholder(String placeholder)

Specified by:

setPlaceholder in interface HasPlaceholder

getSelectionType

public MaterialDatePicker.MaterialDatePickerType getSelectionType()

setSelectionType

public void setSelectionType(MaterialDatePicker.MaterialDatePickerType selectionType)

getOrientation

public Orientation getOrientation()

Specified by:

getOrientation in interface HasOrientation

Returns:

the orientation

setOrientation

public void setOrientation(Orientation orientation)

Specified by:

setOrientation in interface HasOrientation

Parameters:

orientation - the orientation to set : can be Vertical or Horizontal

setGrid

public void setGrid(String grid)

Description copied from interface: HasGrid

Setting the grid for responsiveness don't forget to build rows first before setting the grid on each material widgets.

Specified by:

setGrid in interface HasGrid

Overrides:

setGrid in class MaterialWidget

setOffset

public void setOffset(String offset)

Description copied from interface: HasGrid

Setting the offset.

Specified by:

setOffset in interface HasGrid

Overrides:

setOffset in class MaterialWidget

setError

public void setError(String error)

Description copied from interface: HasError

Errors occur when an app fails to complete what is expected, such as: - The app does not understand user input - The system or app fails - A user intends to run incompatible operations concurrently

Specified by:

setError in interface HasError

setSuccess

public void setSuccess(String success)

Specified by:

setSuccess in interface HasError

setHelperText

public void setHelperText(String helperText)

Specified by:

setHelperText in interface HasError

clearErrorOrSuccess

public void clearErrorOrSuccess()

Specified by:

clearErrorOrSuccess in interface HasError

getFormat

public String getFormat()

setFormat

public void setFormat(String format)

To call before initialization

Parameters:

format -

addValueChangeHandler

public com.google.gwt.event.shared.HandlerRegistration addValueChangeHandler(com.google.gwt.event.logical.shared.ValueChangeHandler<Date> handler)

Specified by:

addValueChangeHandler in interface com.google.gwt.event.logical.shared.HasValueChangeHandlers<Date>

getValue

public Date getValue()

Specified by:

getValue in interface com.google.gwt.user.client.TakesValue<Date>

Specified by:

getValue in interface com.google.gwt.user.client.ui.HasValue<Date>

setValue

public void setValue(Date value)

Specified by:

setValue in interface com.google.gwt.user.client.TakesValue<Date>

Specified by:

setValue in interface com.google.gwt.user.client.ui.HasValue<Date>

setValue

public void setValue(Date value,
                     boolean fireEvents)

Specified by:

setValue in interface com.google.gwt.user.client.ui.HasValue<Date>

addCloseHandler

public com.google.gwt.event.shared.HandlerRegistration addCloseHandler(com.google.gwt.event.logical.shared.CloseHandler<MaterialDatePicker> handler)

Specified by:

addCloseHandler in interface com.google.gwt.event.logical.shared.HasCloseHandlers<MaterialDatePicker>

addOpenHandler

public com.google.gwt.event.shared.HandlerRegistration addOpenHandler(com.google.gwt.event.logical.shared.OpenHandler<MaterialDatePicker> handler)

Specified by:

addOpenHandler in interface com.google.gwt.event.logical.shared.HasOpenHandlers<MaterialDatePicker>

addBlurHandler

public com.google.gwt.event.shared.HandlerRegistration addBlurHandler(com.google.gwt.event.dom.client.BlurHandler handler)

Specified by:

addBlurHandler in interface com.google.gwt.event.dom.client.HasBlurHandlers

setEnabled

public void setEnabled(boolean enabled)

Specified by:

setEnabled in interface com.google.gwt.user.client.ui.HasEnabled

Overrides:

setEnabled in class MaterialWidget

isAllowBlank

public boolean isAllowBlank()

Specified by:

isAllowBlank in interface HasBlankValidator

Returns:

the allow blank

setAllowBlank

public void setAllowBlank(boolean allowBlank)

Specified by:

setAllowBlank in interface HasBlankValidator

Parameters:

allowBlank - the new allow blank

showErrors

public void showErrors(List<com.google.gwt.editor.client.EditorError> errors)

Specified by:

showErrors in interface com.google.gwt.editor.client.HasEditorErrors<Date>

getErrorHandler

public ErrorHandler getErrorHandler()

Description copied from interface: HasErrorHandler

Gets the error handler.

Specified by:

getErrorHandler in interface HasErrorHandler

Returns:

the error handler

setErrorHandler

public void setErrorHandler(ErrorHandler errorHandler)

Description copied from interface: HasErrorHandler

Sets the error handler.

Specified by:

setErrorHandler in interface HasErrorHandler

Parameters:

errorHandler - the new error handler

getErrorHandlerType

public ErrorHandlerType getErrorHandlerType()

Description copied from interface: HasErrorHandler

Gets the error handler type.

Specified by:

getErrorHandlerType in interface HasErrorHandler

Returns:

the error handler type

setErrorHandlerType

public void setErrorHandlerType(ErrorHandlerType errorHandlerType)

Description copied from interface: HasErrorHandler

Sets the error handler type.

Specified by:

setErrorHandlerType in interface HasErrorHandler

Parameters:

errorHandlerType - the new error handler type

addValidator

public void addValidator(Validator<Date> validator)

Description copied from interface: HasValidators

Adds the validator.

Specified by:

addValidator in interface HasValidators<Date>

Parameters:

validator - the validator

isValidateOnBlur

public boolean isValidateOnBlur()

Description copied from interface: HasValidators

Gets the validate on blur.

Specified by:

isValidateOnBlur in interface HasValidators<Date>

Returns:

the validate on blur

removeValidator

public boolean removeValidator(Validator<Date> validator)

Description copied from interface: HasValidators

Removes the validator.

Specified by:

removeValidator in interface HasValidators<Date>

Parameters:

validator - the validator

Returns:

true, if successful

reset

public void reset()

Description copied from interface: HasValidators

Reset the form element to blank and clear error messages.

Specified by:

reset in interface HasValidators<Date>

setValidateOnBlur

public void setValidateOnBlur(boolean validateOnBlur)

Description copied from interface: HasValidators

Sets the validate on blur.

Specified by:

setValidateOnBlur in interface HasValidators<Date>

Parameters:

validateOnBlur - the new validate on blur

setValidators

public void setValidators(Validator<Date>... validators)

Description copied from interface: HasValidators

The validators used to validate this object.

Specified by:

setValidators in interface HasValidators<Date>

Parameters:

validators - the new validators

validate

public boolean validate()

Description copied from interface: HasValidators

Validate the field's value using the supplied validators.

Specified by:

validate in interface HasValidators<Date>

Returns:

true, if valid

validate

public boolean validate(boolean show)

Description copied from interface: HasValidators

Validate the field's value using the supplied validators.

Specified by:

validate in interface HasValidators<Date>

Parameters:

show - the error to the user.

Returns:

true, if valid

addValidationChangedHandler

public com.google.gwt.event.shared.HandlerRegistration addValidationChangedHandler(ValidationChangedEvent.ValidationChangedHandler handler)

Description copied from interface: ValidationChangedEvent.HasValidationChangedHandlers

Adds a validation changed handler.

Specified by:

addValidationChangedHandler in interface ValidationChangedEvent.HasValidationChangedHandlers

Parameters:

handler - the handler

Returns:

the handler registration

getLanguage

public DatePickerLanguage getLanguage()

setLanguage

public void setLanguage(DatePickerLanguage language)

reinitialize

public void reinitialize()

Re initialize the datepicker

stop

public void stop()

Stop the datepicker instance

stop

protected void stop(com.google.gwt.dom.client.Element picker)

getIcon

public MaterialIcon getIcon()

Description copied from interface: HasIcon

Get the icon widget.

Specified by:

getIcon in interface HasIcon

setIconType

public void setIconType(IconType iconType)

Description copied from interface: HasIcon

Set Material Design icon. https://www.google.com/design/icons/

Specified by:

setIconType in interface HasIcon

setIconPosition

public void setIconPosition(IconPosition position)

Description copied from interface: HasIcon

Set the position of the icon.

Specified by:

setIconPosition in interface HasIcon

setIconSize

public void setIconSize(IconSize size)

Description copied from interface: HasIcon

Size of icon.

Specified by:

setIconSize in interface HasIcon

setIconFontSize

public void setIconFontSize(double size,
                            com.google.gwt.dom.client.Style.Unit unit)

Description copied from interface: HasIcon

Set the font size of the icon.

Specified by:

setIconFontSize in interface HasIcon

setIconColor

public void setIconColor(String iconColor)

Description copied from interface: HasIcon

Sets the color of the icon.

Specified by:

setIconColor in interface HasIcon

setIconPrefix

public void setIconPrefix(boolean prefix)

Description copied from interface: HasIcon

Make the icon prefix in its container.

Specified by:

setIconPrefix in interface HasIcon

isIconPrefix

public boolean isIconPrefix()

Description copied from interface: HasIcon

Is the icon prefix in the container.

Specified by:

isIconPrefix in interface HasIcon