com.vaadin.client.ui.

Class VDateField<R extends Enum<R>>

  • 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
            • com.google.gwt.user.client.ui.FlowPanel
              • com.vaadin.client.ui.VDateField<R>

  • Type Parameters:

    R - the resolution type which this field is based on (day, month, ...)

    All Implemented Interfaces:

    com.google.gwt.event.logical.shared.HasAttachHandlers, com.google.gwt.event.shared.HasHandlers, com.google.gwt.user.client.EventListener, com.google.gwt.user.client.ui.HasEnabled, 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.InsertPanel, com.google.gwt.user.client.ui.InsertPanel.ForIsWidget, com.google.gwt.user.client.ui.IsWidget, Field, Iterable<com.google.gwt.user.client.ui.Widget>

    Direct Known Subclasses:

    VAbstractDateFieldCalendar, VAbstractTextualDate


    public abstract class VDateField<R extends Enum<R>>
extends com.google.gwt.user.client.ui.FlowPanel
implements Field, com.google.gwt.user.client.ui.HasEnabled

    A very base widget class for a date field.

    Author:

    Vaadin Ltd

    • Nested Class Summary

      • 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.user.client.ui.InsertPanel

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

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

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

    • Constructor Summary

      Constructors
      Constructor and Description
      VDateField(R resolution) 

    • Method Summary

      All Methods
      Modifier and Type Method and Description
      protected abstract R[] doGetResolutions()

      Returns all available resolutions as an array.
      ApplicationConnection getClient() 
      Date getCurrentDate() 
      String getCurrentLocale() 
      R getCurrentResolution() 
      Date getDate()

      Returns a copy of the current date.
      protected abstract Date getDate(Map<R,Integer> dateValues)

      Returns a date based on the provided date values map.
      DateTimeService getDateTimeService() 
      Date getDefaultDate()

      Sets the default date when no date is selected.
      String getId() 
      Stream<R> getResolutions()

      Returns all available resolutions for the field in the ascending order (which is the same as order of enumeration ordinals).
      String getResolutionVariable(R resolution)

      Returns a resolution variable name for the given resolution.
      boolean isEnabled() 
      boolean isReadonly() 
      boolean isShowISOWeekNumbers()

      Returns whether ISO 8601 week numbers should be shown in the date selector or not.
      abstract boolean isYear(R resolution)

      Checks whether the given resolution represents an year.
      abstract String resolutionAsString()

      Returns a current resolution as a string.
      void sendBufferedValues()

      Sends the bufferedDateString and bufferedResolutions to the server, and clears their values.
      void setCurrentDate(Date date) 
      void setCurrentDate(Map<R,Integer> dateValues)

      Set the current date using a map with date values.
      void setCurrentLocale(String currentLocale) 
      void setCurrentResolution(R currentResolution) 
      protected void setDate(Date date)

      Sets the current date for this VDateField.
      void setDefaultDate(Date date)

      Set the default date to open popup when no date is selected.
      void setDefaultDate(Map<R,Integer> defaultValues)

      Set the default date using a map with date values.
      void setEnabled(boolean enabled) 
      void setReadonly(boolean readonly) 
      void setShowISOWeekNumbers(boolean showISOWeekNumbers) 
      protected abstract boolean supportsTime()

      Checks whether time is supported by this widget.
      abstract void updateBufferedValues()

      Update buffered values bufferedDateString and bufferedResolutions that will be sent to the server.

      • Methods inherited from class com.google.gwt.user.client.ui.FlowPanel

        add, clear, insert, insert

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

        add, add, adjustIndex, checkIndexBoundsForAccess, checkIndexBoundsForInsertion, getChildren, getWidget, getWidgetCount, getWidgetIndex, getWidgetIndex, insert, 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, onAttach, onBrowserEvent, onDetach, onLoad, 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 interface com.google.gwt.user.client.ui.InsertPanel.ForIsWidget

        add

      • Methods inherited from interface com.google.gwt.user.client.ui.IndexedPanel.ForIsWidget

        getWidgetIndex

      • Methods inherited from interface com.google.gwt.user.client.ui.IndexedPanel

        getWidget, getWidgetCount, getWidgetIndex, remove

    • Field Detail

      • client

        public ApplicationConnection client

        For internal use only. May be removed or replaced in the future.

      • currentLocale

        protected String currentLocale

      • readonly

        protected boolean readonly

      • enabled

        protected boolean enabled

      • bufferedResolutions

        protected Map<R extends Enum<R>,Integer> bufferedResolutions

        A temporary holder of the time units (resolutions), which would be sent to the server through sendBufferedValues(). The key is the resolution. The value can be null.

        Since:

        8.2

      • bufferedDateString

        protected String bufferedDateString

        A temporary holder of the date string, which would be sent to the server through sendBufferedValues().

        Since:

        8.2

      • dts

        public DateTimeService dts

        For internal use only. May be removed or replaced in the future.

      • showISOWeekNumbers

        protected boolean showISOWeekNumbers

    • Constructor Detail

      • VDateField

        public VDateField(R resolution)

    • Method Detail

      • getCurrentResolution

        public R getCurrentResolution()

      • setCurrentResolution

        public void setCurrentResolution(R currentResolution)

      • getCurrentLocale

        public String getCurrentLocale()

      • setCurrentLocale

        public void setCurrentLocale(String currentLocale)

      • getCurrentDate

        public Date getCurrentDate()

      • setCurrentDate

        public void setCurrentDate(Date date)

      • setDefaultDate

        public void setDefaultDate(Date date)

        Set the default date to open popup when no date is selected.

        Parameters:

        date - default date to show as the initial (non-selected) value when opening a popup with no value selected

        Since:

        8.1.2

      • setCurrentDate

        public void setCurrentDate(Map<R,Integer> dateValues)

        Set the current date using a map with date values.

        The map contains integer representation of values per resolution. The method should construct a date based on the map and set it via setCurrentDate(Date)

        Parameters:

        dateValues - a map with date values to convert into a date

      • setDefaultDate

        public void setDefaultDate(Map<R,Integer> defaultValues)

        Set the default date using a map with date values.

        Parameters:

        defaultValues -

        Since:

        8.1.2

        See Also:

        setCurrentDate(Map)

      • getDefaultDate

        public Date getDefaultDate()

        Sets the default date when no date is selected.

        Returns:

        the default date

        Since:

        8.1.2

      • isReadonly

        public boolean isReadonly()

      • setReadonly

        public void setReadonly(boolean readonly)

      • isEnabled

        public boolean isEnabled()

        Specified by:

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

      • setEnabled

        public void setEnabled(boolean enabled)

        Specified by:

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

      • getId

        public String getId()

      • isShowISOWeekNumbers

        public boolean isShowISOWeekNumbers()

        Returns whether ISO 8601 week numbers should be shown in the date selector or not. ISO 8601 defines that a week always starts with a Monday so the week numbers are only shown if this is the case.

        Returns:

        true if week number should be shown, false otherwise

      • setShowISOWeekNumbers

        public void setShowISOWeekNumbers(boolean showISOWeekNumbers)

      • getDate

        public Date getDate()

        Returns a copy of the current date. Modifying the returned date will not modify the value of this VDateField. Use setDate(Date) to change the current date.

        For internal use only. May be removed or replaced in the future.

        Returns:

        A copy of the current date

      • setDate

        protected void setDate(Date date)

        Sets the current date for this VDateField.

        Parameters:

        date - The new date to use

      • getResolutionVariable

        public String getResolutionVariable(R resolution)

        Returns a resolution variable name for the given resolution.

        Parameters:

        resolution - the given resolution

        Returns:

        the resolution variable name

      • updateBufferedValues

        public abstract void updateBufferedValues()

        Update buffered values bufferedDateString and bufferedResolutions that will be sent to the server.

        This method should NOT send values to the server.

        This method can be implemented by subclasses to update buffered values from component values.

        Since:

        8.4

      • getResolutions

        public Stream<R> getResolutions()

        Returns all available resolutions for the field in the ascending order (which is the same as order of enumeration ordinals).

        The method uses doGetResolutions() to make sure that the order is the correct one.

        Returns:

        stream of all available resolutions in the ascending order.

        See Also:

        doGetResolutions()

      • resolutionAsString

        public abstract String resolutionAsString()

        Returns a current resolution as a string.

        The method is used to generate a style name for the current resolution.

        Returns:

        the current resolution as a string

      • isYear

        public abstract boolean isYear(R resolution)

        Checks whether the given resolution represents an year.

        Parameters:

        resolution - the given resolution

        Returns:

        true if the resolution represents an year

      • supportsTime

        protected abstract boolean supportsTime()

        Checks whether time is supported by this widget.

        Returns:

        true if time is supported in addition to date, false if only dates are supported

        Since:

        8.1

      • getDate

        protected abstract Date getDate(Map<R,Integer> dateValues)

        Returns a date based on the provided date values map.

        Parameters:

        dateValues - a map with date values to convert into a date

        Returns:

        the date based on the dateValues map

        See Also:

        setCurrentDate(Map)

      • doGetResolutions

        protected abstract R[] doGetResolutions()

        Returns all available resolutions as an array.

        No any order is required (in contrary to getResolutions().

        Returns:

        all available resolutions

        See Also:

        getResolutions()