Package com.vaadin.client.ui

Class VPopupCalendar

  • All Implemented Interfaces:
    com.google.gwt.event.dom.client.ChangeHandler, com.google.gwt.event.dom.client.ClickHandler, com.google.gwt.event.dom.client.KeyDownHandler, com.google.gwt.event.logical.shared.CloseHandler<com.google.gwt.user.client.ui.PopupPanel>, com.google.gwt.event.logical.shared.HasAttachHandlers, com.google.gwt.event.shared.EventHandler, 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, Focusable, HandlesAriaCaption, HandlesAriaInvalid, HandlesAriaRequired, Field, SubPartAware, Iterable<com.google.gwt.user.client.ui.Widget>
    public class VPopupCalendar
extends VTextualDate
implements Field, com.google.gwt.event.dom.client.ClickHandler, com.google.gwt.event.logical.shared.CloseHandler<com.google.gwt.user.client.ui.PopupPanel>, SubPartAware
    Represents a date selection component with a text field and a popup date selector. Note: To change the keyboard assignments used in the popup dialog you should extend VCalendarPanel and then pass set it by calling the setCalendarPanel(VCalendarPanel panel) method.

    • Field Detail

      • calendarToggle

        public final com.google.gwt.user.client.ui.Button calendarToggle
        For internal use only. May be removed or replaced in the future.

      • calendar

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

      • popup

        public final VOverlay popup
        For internal use only. May be removed or replaced in the future.

      • parsable

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

    • Constructor Detail

      • VPopupCalendar

        public VPopupCalendar()

    • 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

      • updateValue

        public void updateValue​(Date newDate)

      • isTextFieldEnabled

        public boolean isTextFieldEnabled()
        Checks whether the text field is enabled.
        Returns:
        The current state of the text field.
        See Also:
        setTextFieldEnabled(boolean)

      • setTextFieldEnabled

        public void setTextFieldEnabled​(boolean textFieldEnabled)
        Sets the state of the text field of this component. By default the text field is enabled. Disabling it causes only the button for date selection to be active, thus preventing the user from entering invalid dates. See 6790.
        Parameters:
        textFieldEnabled -

      • updateTextFieldEnabled

        protected void updateTextFieldEnabled()

      • setTextFieldTabIndex

        public void setTextFieldTabIndex()
        Set correct tab index for disabled text field in IE as the value set in setTextFieldEnabled(...) gets overridden in TextualDateConnection.updateFromUIDL(...)
        Since:
        7.3.1

      • bindAriaCaption

        public void bindAriaCaption​(com.google.gwt.user.client.Element captionElement)
        Description copied from interface: HandlesAriaCaption
        Called to bind the provided caption (label in HTML speak) element to the main input element of the Widget. Binding should be removed from the main input field when captionElement is null.
        Specified by:
        bindAriaCaption in interface HandlesAriaCaption
        Overrides:
        bindAriaCaption in class VTextualDate
        Parameters:
        captionElement - Element of the caption

      • setStyleName

        public void setStyleName​(String style)
        Overrides:
        setStyleName in class com.google.gwt.user.client.ui.UIObject

      • setStylePrimaryName

        public void setStylePrimaryName​(String style)
        Overrides:
        setStylePrimaryName in class com.google.gwt.user.client.ui.UIObject

      • openCalendarPanel

        public void openCalendarPanel()
        Opens the calendar panel popup

      • onClick

        public void onClick​(com.google.gwt.event.dom.client.ClickEvent event)
        Specified by:
        onClick in interface com.google.gwt.event.dom.client.ClickHandler

      • onClose

        public void onClose​(com.google.gwt.event.logical.shared.CloseEvent<com.google.gwt.user.client.ui.PopupPanel> event)
        Specified by:
        onClose in interface com.google.gwt.event.logical.shared.CloseHandler<com.google.gwt.user.client.ui.PopupPanel>

      • setFocus

        public void setFocus​(boolean focus)
        Sets focus to Calendar panel.
        Parameters:
        focus -

      • setEnabled

        public void setEnabled​(boolean enabled)
        Specified by:
        setEnabled in interface com.google.gwt.user.client.ui.HasEnabled
        Overrides:
        setEnabled in class VTextualDate

      • setFocusedDate

        public void setFocusedDate​(Date selectedDate)
        Sets the content of a special field for assistive devices, so that they can recognize the change and inform the user (reading out in case of screen reader)
        Parameters:
        selectedDate - Date that is currently selected

      • buildDate

        protected void buildDate​(boolean forceValid)
        Update the text field contents from the date. See buildDate().
        Parameters:
        forceValid - true to force the text field to be updated, false to only update if the parsable flag is true.

      • onBrowserEvent

        public void onBrowserEvent​(com.google.gwt.user.client.Event event)
        Specified by:
        onBrowserEvent in interface com.google.gwt.user.client.EventListener
        Overrides:
        onBrowserEvent in class com.google.gwt.user.client.ui.Widget

      • getOpenCalenderPanelKey

        protected int getOpenCalenderPanelKey()
        Get the key code that opens the calendar panel. By default it is the down key but you can override this to be whatever you like
        Returns:

      • closeCalendarPanel

        public void closeCalendarPanel()
        Closes the open popup panel

      • getSubPartElement

        public com.google.gwt.user.client.Element getSubPartElement​(String subPart)
        Description copied from interface: SubPartAware
        Locates an element inside a component using the identifier provided in subPart. The subPart identifier is component specific and may be any string of characters, numbers, space characters and brackets.
        Specified by:
        getSubPartElement in interface SubPartAware
        Overrides:
        getSubPartElement in class VTextualDate
        Parameters:
        subPart - The identifier for the element inside the component
        Returns:
        The element identified by subPart or null if the element could not be found.

      • getSubPartName

        public String getSubPartName​(com.google.gwt.user.client.Element subElement)
        Description copied from interface: SubPartAware
        Provides an identifier that identifies the element within the component. The subElement is a part of the component and must never be null.

        Note! getSubPartElement(getSubPartName(element)) == element is not always true. A component can choose to provide a more generic identifier for any given element if the results of all interactions with subElement are the same as interactions with the element identified by the return value. For example a button can return an identifier for the root element even though a DIV inside the button was passed as subElement because interactions with the DIV and the root button element produce the same result.

        Specified by:
        getSubPartName in interface SubPartAware
        Overrides:
        getSubPartName in class VTextualDate
        Parameters:
        subElement - The element the identifier string should uniquely identify
        Returns:
        An identifier that uniquely identifies subElement or null if no identifier could be provided.

      • setDescriptionForAssistiveDevices

        public void setDescriptionForAssistiveDevices​(String descriptionForAssistiveDevices)
        Set a description that explains the usage of the Widget for users of assistive devices.
        Parameters:
        descriptionForAssistiveDevices - String with the description

      • getDescriptionForAssistiveDevices

        public String getDescriptionForAssistiveDevices()
        Get the description that explains the usage of the Widget for users of assistive devices.
        Returns:
        String with the description

      • setRangeStart

        public void setRangeStart​(Date rangeStart)
        Sets the start range for this component. The start range is inclusive, and it depends on the current resolution, what is considered inside the range.
        Parameters:
        rangeStart - - the allowed range's start date

      • setRangeEnd

        public void setRangeEnd​(Date rangeEnd)
        Sets the end range for this component. The end range is inclusive, and it depends on the current resolution, what is considered inside the range.
        Parameters:
        rangeEnd - - the allowed range's end date