com.vaadin.client.ui.grid.renderers
Class ComplexRenderer<T>

java.lang.Object
  com.vaadin.client.ui.grid.renderers.ComplexRenderer<T>

All Implemented Interfaces:

Renderer<T>

Direct Known Subclasses:

MultiSelectionRenderer, WidgetRenderer

public abstract class ComplexRenderer<T>
extends java.lang.Object
implements Renderer<T>

Base class for renderers that needs initialization and destruction logic (override and #destroy(FlyweightCell) and event handling (see onBrowserEvent(Cell, NativeEvent), getConsumedEvents() and #onActivate().

Also provides a helper method for hiding the cell contents by overriding setContentVisible(FlyweightCell, boolean)

Since:

Author:

Vaadin Ltd

Constructor Summary

ComplexRenderer()

Method Summary

void	destroy() Called when the renderer is deemed to be destroyed and no longer used by the Grid.
void	destroy(FlyweightCell cell) Called after the cell is deemed to be destroyed and no longer used by the Grid.
java.util.Collection<java.lang.String>	getConsumedEvents() Returns the events that the renderer should consume.
abstract void	init(FlyweightCell cell) Called at initialization stage.
boolean	onActivate(Cell cell) Called when the cell is "activated" by pressing enter, double clicking or performing a double tap on the cell.
boolean	onBrowserEvent(Cell cell, NativeEvent event) Called whenever a registered event is triggered in the column the renderer renders.
void	setContentVisible(FlyweightCell cell, boolean hasData) Used by Grid to toggle whether to show actual data or just an empty placeholder while data is loading.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.vaadin.client.ui.grid.Renderer

render

Constructor Detail

ComplexRenderer

public ComplexRenderer()

Method Detail

init

public abstract void init(FlyweightCell cell)

Called at initialization stage. Perform any initialization here e.g. attach handlers, attach widgets etc.

Parameters:

cell - The cell. Note that the cell is not to be stored outside of the method as the cell install will change. See FlyweightCell

destroy

public void destroy(FlyweightCell cell)

Called after the cell is deemed to be destroyed and no longer used by the Grid. Called after the cell element is detached from the DOM.

Parameters:

cell - The cell. Note that the cell is not to be stored outside of the method as the cell install will change. See FlyweightCell

getConsumedEvents

public java.util.Collection<java.lang.String> getConsumedEvents()

Returns the events that the renderer should consume. These are also the events that the Grid will pass to onBrowserEvent(Cell, NativeEvent) when they occur.

Returns:

a list of consumed events

See Also:

com.google.gwt.dom.client.BrowserEvents

onBrowserEvent

public boolean onBrowserEvent(Cell cell,
                              NativeEvent event)

Called whenever a registered event is triggered in the column the renderer renders.

The events that triggers this needs to be returned by the getConsumedEvents() method.

Returns boolean telling if the event has been completely handled and should not cause any other actions.

Parameters:

cell - Object containing information about the cell the event was triggered on.

event - The original DOM event

Returns:

true if event should not be handled by grid

setContentVisible

public void setContentVisible(FlyweightCell cell,
                              boolean hasData)

Used by Grid to toggle whether to show actual data or just an empty placeholder while data is loading. This method is invoked whenever a cell changes between data being available and data missing.

Default implementation hides content by setting visibility: hidden to all elements inside the cell. Text nodes are left as is - renderers that add such to the root element need to implement explicit support hiding them.

Parameters:

cell - The cell

hasData - Has the cell content been loaded from the data source

onActivate

public boolean onActivate(Cell cell)

Called when the cell is "activated" by pressing enter, double clicking or performing a double tap on the cell.

Parameters:

cell - the activated cell

Returns:

true if event was handled and should not be interpreted as a generic gesture by Grid.

destroy

public void destroy()

Called when the renderer is deemed to be destroyed and no longer used by the Grid.