com.google.gwt.user.client.ui
Class PotentialElement
java.lang.Object
com.google.gwt.core.client.JavaScriptObject
com.google.gwt.dom.client.Node
com.google.gwt.dom.client.Element
com.google.gwt.user.client.ui.PotentialElement
public class PotentialElement
- extends Element
EXPERIMENTAL and subject to change. Do not use this in production code.
A simple Element implementation (not an actual dom
object) that can serve as stand in to be used by IsRenderable widgets
before they are fully built. For example, it can accumulate simple set*()
values to be used when the widget is actually ready to render. Thus, most
IsRenderable widget code can be written without taking into account
whether or not the widget has yet been rendered.
DOM#appendChild is aware of PotentialElement, and calls its
resolve() method. This triggers a call to
UIObject.resolvePotentialElement(), which widgets can customize
to get a real Element in place at the last moment.
TODO(rdcastro): Cover all unsupported methods with helpful error messages.
| Methods inherited from class com.google.gwt.dom.client.Element |
addClassName, as, as, blur, dispatchEvent, focus, getAbsoluteBottom, getAbsoluteLeft, getAbsoluteRight, getAbsoluteTop, getAttribute, getClassName, getClientHeight, getClientWidth, getDir, getDraggable, getElementsByTagName, getFirstChildElement, getId, getInnerHTML, getInnerText, getLang, getNextSiblingElement, getOffsetHeight, getOffsetLeft, getOffsetParent, getOffsetTop, getOffsetWidth, getPropertyBoolean, getPropertyDouble, getPropertyInt, getPropertyJSO, getPropertyObject, getPropertyString, getScrollHeight, getScrollLeft, getScrollTop, getScrollWidth, getString, getStyle, getTabIndex, getTagName, getTitle, hasAttribute, hasTagName, is, is, removeAttribute, removeClassName, replaceClassName, scrollIntoView, setAttribute, setClassName, setDir, setDraggable, setId, setInnerHTML, setInnerText, setLang, setPropertyBoolean, setPropertyDouble, setPropertyInt, setPropertyJSO, setPropertyObject, setPropertyString, setScrollLeft, setScrollTop, setTabIndex, setTitle |
| Methods inherited from class com.google.gwt.dom.client.Node |
appendChild, cloneNode, getChild, getChildCount, getChildNodes, getFirstChild, getLastChild, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentElement, getParentNode, getPreviousSibling, hasChildNodes, hasParentElement, insertAfter, insertBefore, insertFirst, isOrHasChild, removeChild, removeFromParent, replaceChild, setNodeValue |
| Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
PotentialElement
protected PotentialElement()
as
public static PotentialElement as(Element e)
build
public static PotentialElement build(UIObject o)
- Builds a new PotentialElement with the tag name set to "div".
- See Also:
build(UIObject,String)
build
public static PotentialElement build(UIObject o,
java.lang.String tagName)
- Builds a new PotentialElement. This element keeps track of the
UIObject so that it can call
UIObject.resolvePotentialElement() to get a real element when
that is needed.
isPotential
public static boolean isPotential(JavaScriptObject o)
resolve
public static Element resolve(Element maybePotential)
- If given a PotentialElement, returns the real Element to be
built from it. Otherwise returns the given Element itself.
Note that a PotentialElement can only be resolved once.
Making repeated calls to this method with the same PotentialElement
is an error.