com.google.gwt.user.client.ui
Class RenderableStamper

java.lang.Object
  com.google.gwt.user.client.ui.RenderableStamper

public class RenderableStamper
extends java.lang.Object

Used by IsRenderable to mark their root element in such a way that they can be later retrieved. This class abstracts the exact details of how the element is marked and retrieved, so that we can always use the best method avaialable without having to change all implementations of IsRenderable.

The expected flow is for the IsRenderable object to use one of the stamp(com.google.gwt.safehtml.shared.SafeHtml) methods below to mark their HTML. At a later point, its parent widget will use the findStampedElement() to retrieve the right element.

RenderableStamper

public RenderableStamper(java.lang.String token)

Creates a stamper that will be use the given token, which is assumed to be unique and will be escaped before being used.

findStampedElement

public Element findStampedElement()

Finds the element that was previously stamped in the DOM. For this to work properly the element must be attached to the document.

stamp

public SafeHtml stamp(SafeHtml safeHtml)

Stamps an HTML element in such a way that it can be later found in the DOM tree. To be used by IsRenderable objects built using SafeHtml directly, this assumes the element to be stamped is the first found in the given SafeHtml. Returns safeHtml untouched if it does not being with a tag.

stamp

public <T extends HtmlElementBuilderBase<?>> T stamp(T elementBuilder)

Stamps an HTML element in such a way that it can be later found in the DOM tree. To be used by IsRenderable objects built using ElementBuilder, this assumes the given elementBuilder is for the root element that should later be claimed.