com.vaadin.ui
Class PopupView

java.lang.Object
  com.vaadin.server.AbstractClientConnector
      com.vaadin.ui.AbstractComponent
          com.vaadin.ui.PopupView

All Implemented Interfaces:

MethodEventSource, ClientConnector, Sizeable, com.vaadin.shared.Connector, Component, HasComponents, java.io.Serializable, java.lang.Iterable<Component>

public class PopupView
extends AbstractComponent
implements HasComponents

A component for displaying a two different views to data. The minimized view is normally used to render the component, and when it is clicked the full view is displayed on a popup. The inner class PopupView.Content is used to deliver contents to this component.

Author:

Vaadin Ltd.

See Also:

Serialized Form

Nested Class Summary

static interface	PopupView.Content Used to deliver customized content-packages to the PopupView.
static class	PopupView.PopupVisibilityEvent This event is received by the PopupVisibilityListeners when the visibility of the popup changes.
static interface	PopupView.PopupVisibilityListener Defines a listener that can receive a PopupVisibilityEvent when the visibility of the popup changes.

Nested classes/interfaces inherited from interface com.vaadin.ui.HasComponents

HasComponents.ComponentAttachDetachNotifier, HasComponents.ComponentAttachEvent, HasComponents.ComponentAttachListener, HasComponents.ComponentDetachEvent, HasComponents.ComponentDetachListener

Nested classes/interfaces inherited from interface com.vaadin.ui.Component

Component.ErrorEvent, Component.Event, Component.Focusable, Component.Listener

Nested classes/interfaces inherited from interface com.vaadin.server.ClientConnector

ClientConnector.AttachEvent, ClientConnector.AttachListener, ClientConnector.ConnectorErrorEvent, ClientConnector.DetachEvent, ClientConnector.DetachListener

Nested classes/interfaces inherited from interface com.vaadin.server.Sizeable

Sizeable.Unit

Field Summary

Fields inherited from class com.vaadin.ui.AbstractComponent

DESIGN_ATTR_PLAIN_TEXT

Fields inherited from interface com.vaadin.server.Sizeable

SIZE_UNDEFINED, UNITS_CM, UNITS_EM, UNITS_EX, UNITS_INCH, UNITS_MM, UNITS_PERCENTAGE, UNITS_PICAS, UNITS_PIXELS, UNITS_POINTS

Constructor Summary

PopupView()
Deprecated.

PopupView(PopupView.Content content)
Creates a PopupView through the PopupView.Content interface.

PopupView(java.lang.String small, Component large)
A simple way to create a PopupPanel.

Method Summary

void	addListener(PopupView.PopupVisibilityListener listener) Deprecated. As of 7.0, replaced by addPopupVisibilityListener(PopupVisibilityListener)
void	addPopupVisibilityListener(PopupView.PopupVisibilityListener listener) Add a listener that is called whenever the visibility of the popup is changed.
void	beforeClientResponse(boolean initial) Called before the shared state and RPC invocations are sent to the client.
protected static PopupView.Content	createContent(java.lang.String minimizedValue, Component popupContent) Creates a Content from given text representation and popup content.
int	getComponentCount() Gets the number of contained components.
PopupView.Content	getContent() Returns the content-package for this PopupView.
protected com.vaadin.shared.ui.popupview.PopupViewState	getState() Returns the shared state bean with information to be sent from the server to the client.
protected com.vaadin.shared.ui.popupview.PopupViewState	getState(boolean markAsDirty) Returns the shared state for this connector.
boolean	isHideOnMouseOut() Check if this popup will be hidden when the user takes the mouse cursor out of the popup area.
boolean	isPopupVisible() Return whether the popup is visible.
java.util.Iterator<Component>	iterator() This class only contains other components when the popup is showing.
void	readDesign(org.jsoup.nodes.Element design, DesignContext designContext) Reads the component state from the given design.
void	removeListener(PopupView.PopupVisibilityListener listener) Deprecated. As of 7.0, replaced by removePopupVisibilityListener(PopupVisibilityListener)
void	removePopupVisibilityListener(PopupView.PopupVisibilityListener listener) Removes a previously added listener, so that it no longer receives events when the visibility of the popup changes.
void	setContent(PopupView.Content newContent) This method will replace the current content of the panel with a new one.
void	setHideOnMouseOut(boolean hideOnMouseOut) Should the popup automatically hide when the user takes the mouse cursor out of the popup area? If this is false, the user must click outside the popup to close it.
void	setPopupVisible(boolean visible) Set the visibility of the popup.
void	writeDesign(org.jsoup.nodes.Element design, DesignContext designContext) Writes the component state to the given design.

Methods inherited from class com.vaadin.ui.AbstractComponent

addListener, addShortcutListener, addStyleName, attach, detach, findAncestor, fireComponentErrorEvent, fireComponentEvent, focus, getActionManager, getCaption, getComponentError, getCustomAttributes, getData, getDebugId, getDescription, getErrorMessage, getExplicitImmediateValue, getHeight, getHeightUnits, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getStyleName, getWidth, getWidthUnits, isCaptionAsHtml, isConnectorEnabled, isEnabled, isImmediate, isOrHasAncestor, isReadOnly, isResponsive, isVisible, removeListener, removeShortcutListener, removeStyleName, setCaption, setCaptionAsHtml, setComponentError, setData, setDebugId, setDescription, setEnabled, setHeight, setHeight, setHeightUndefined, setIcon, setId, setImmediate, setLocale, setParent, setPrimaryStyleName, setReadOnly, setResponsive, setSizeFull, setSizeUndefined, setStyleName, setStyleName, setVisible, setWidth, setWidth, setWidthUndefined

Methods inherited from class com.vaadin.server.AbstractClientConnector

addAttachListener, addDetachListener, addExtension, addListener, addListener, addListener, addMethodInvocationToQueue, createState, encodeState, equals, fireEvent, getAllChildrenIterable, getConnectorId, getErrorHandler, getExtensions, getListeners, getResource, getRpcManager, getRpcProxy, getSession, getStateType, getUI, handleConnectorRequest, hashCode, hasListeners, isAttached, isThis, markAsDirty, markAsDirtyRecursive, registerRpc, registerRpc, removeAttachListener, removeDetachListener, removeExtension, removeListener, removeListener, removeListener, removeListener, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler, setResource

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.vaadin.ui.Component

addListener, addStyleName, attach, getCaption, getDescription, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getStyleName, getUI, isEnabled, isReadOnly, isVisible, removeListener, removeStyleName, setCaption, setEnabled, setIcon, setId, setParent, setPrimaryStyleName, setReadOnly, setStyleName, setVisible

Methods inherited from interface com.vaadin.server.ClientConnector

addAttachListener, addDetachListener, detach, encodeState, getErrorHandler, getExtensions, getRpcManager, getStateType, handleConnectorRequest, isAttached, isConnectorEnabled, markAsDirty, markAsDirtyRecursive, removeAttachListener, removeDetachListener, removeExtension, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler

Methods inherited from interface com.vaadin.shared.Connector

getConnectorId

Methods inherited from interface com.vaadin.server.Sizeable

getHeight, getHeightUnits, getWidth, getWidthUnits, setHeight, setHeight, setHeightUndefined, setSizeFull, setSizeUndefined, setWidth, setWidth, setWidthUndefined

Constructor Detail

PopupView

@Deprecated
public PopupView()

Deprecated.

This is an internal constructor. Use PopupView(String, Component) instead.

Since:

7.5.0

PopupView

public PopupView(java.lang.String small,
                 Component large)

A simple way to create a PopupPanel. Note that the minimal representation may not be dynamically updated, in order to achieve this create your own Content object and use PopupView(Content).

Parameters:

small - the minimal textual representation as HTML

large - the full, Component-type representation

PopupView

public PopupView(PopupView.Content content)

Creates a PopupView through the PopupView.Content interface. This allows the creator to dynamically change the contents of the PopupView.

Parameters:

content - the PopupView.Content that contains the information for this

Method Detail

createContent

protected static PopupView.Content createContent(java.lang.String minimizedValue,
                                                 Component popupContent)

Creates a Content from given text representation and popup content.

Parameters:

minimizedValue - text representation when popup is hidden

popupContent - popup content

Returns:

content with given data

Since:

7.5.0

setContent

public void setContent(PopupView.Content newContent)
                throws java.lang.IllegalArgumentException

This method will replace the current content of the panel with a new one.

Parameters:

newContent - PopupView.Content object containing new information for the PopupView

Throws:

java.lang.IllegalArgumentException - if the method is passed a null value, or if one of the content methods returns null

getContent

public PopupView.Content getContent()

Returns the content-package for this PopupView.

Returns:

the PopupView.Content for this object or null

setPopupVisible

public void setPopupVisible(boolean visible)

Set the visibility of the popup. Does not hide the minimal representation.

Parameters:

visible -

beforeClientResponse

public void beforeClientResponse(boolean initial)

Description copied from interface: ClientConnector

Called before the shared state and RPC invocations are sent to the client. Gives the connector an opportunity to set computed/dynamic state values or to invoke last minute RPC methods depending on other component features.

This method must not alter the component hierarchy in any way. Calling ClientConnector.markAsDirty() from this method will have no effect.

Specified by:

beforeClientResponse in interface ClientConnector

Overrides:

beforeClientResponse in class AbstractComponent

Parameters:

initial - true if the client-side connector will be created and initialized after this method has been invoked. false if there is already an initialized client-side connector.

isPopupVisible

public boolean isPopupVisible()

Return whether the popup is visible.

Returns:

true if the popup is showing

isHideOnMouseOut

public boolean isHideOnMouseOut()

Check if this popup will be hidden when the user takes the mouse cursor out of the popup area.

Returns:

true if the popup is hidden on mouse out, false otherwise

setHideOnMouseOut

public void setHideOnMouseOut(boolean hideOnMouseOut)

Should the popup automatically hide when the user takes the mouse cursor out of the popup area? If this is false, the user must click outside the popup to close it. The default is true.

Parameters:

hideOnMouseOut -

iterator

public java.util.Iterator<Component> iterator()

This class only contains other components when the popup is showing.

Specified by:

iterator in interface HasComponents

Specified by:

iterator in interface java.lang.Iterable<Component>

Returns:

the component iterator.

See Also:

ComponentContainer.getComponentIterator()

getComponentCount

public int getComponentCount()

Gets the number of contained components. Consistent with the iterator returned by #getComponentIterator().

Returns:

the number of contained components (zero or one)

readDesign

public void readDesign(org.jsoup.nodes.Element design,
                       DesignContext designContext)

Description copied from interface: Component

Reads the component state from the given design.

The component is responsible not only for updating its own state but also for ensuring that its children update their state based on the design.

It is assumed that the component is in its default state when this method is called. Reading should only take into consideration attributes specified in the design and not reset any unspecified attributes to their defaults.

This method must not modify the design.

Specified by:

readDesign in interface Component

Overrides:

readDesign in class AbstractComponent

Parameters:

design - The element to obtain the state from

designContext - The DesignContext instance used for parsing the design

writeDesign

public void writeDesign(org.jsoup.nodes.Element design,
                        DesignContext designContext)

Description copied from interface: Component

Writes the component state to the given design.

The component is responsible not only for writing its own state but also for ensuring that its children write their state to the design.

This method must not modify the component state.

Specified by:

writeDesign in interface Component

Overrides:

writeDesign in class AbstractComponent

Parameters:

design - The element to write the component state to. Any previous attributes or child nodes are not cleared.

designContext - The DesignContext instance used for writing the design

getState

protected com.vaadin.shared.ui.popupview.PopupViewState getState()

Description copied from class: AbstractComponent

Returns the shared state bean with information to be sent from the server to the client. Subclasses should override this method and set any relevant fields of the state returned by super.getState().

Overrides:

getState in class AbstractComponent

Returns:

updated component shared state

getState

protected com.vaadin.shared.ui.popupview.PopupViewState getState(boolean markAsDirty)

Description copied from class: AbstractClientConnector

Returns the shared state for this connector.

Overrides:

getState in class AbstractComponent

Parameters:

markAsDirty - true if the connector should automatically be marked dirty, false otherwise

Returns:

The shared state for this connector. Never null.

See Also:

AbstractClientConnector.getState()

addPopupVisibilityListener

public void addPopupVisibilityListener(PopupView.PopupVisibilityListener listener)

Add a listener that is called whenever the visibility of the popup is changed.

Parameters:

listener - the listener to add

See Also:

PopupView.PopupVisibilityListener, PopupView.PopupVisibilityEvent, removeListener(PopupVisibilityListener)

addListener

@Deprecated
public void addListener(PopupView.PopupVisibilityListener listener)

Deprecated. As of 7.0, replaced by addPopupVisibilityListener(PopupVisibilityListener)

removePopupVisibilityListener

public void removePopupVisibilityListener(PopupView.PopupVisibilityListener listener)

Removes a previously added listener, so that it no longer receives events when the visibility of the popup changes.

Parameters:

listener - the listener to remove

See Also:

PopupView.PopupVisibilityListener, addListener(PopupVisibilityListener)

removeListener

@Deprecated
public void removeListener(PopupView.PopupVisibilityListener listener)

Deprecated. As of 7.0, replaced by removePopupVisibilityListener(PopupVisibilityListener)