java.lang.Object | |
↳ | com.google.gwt.user.client.ui.AbstractImagePrototype |
Known Direct Subclasses |
An opaque representation of a particular image such that the image can be
accessed either as an HTML fragment or as an Image
object. An image
prototype can be thought of as an abstract image factory with additional
capabilities.
The applyTo(Image)
method provides an efficient way to replace the
contents of an existing Image
. This is useful in cases where an
image changes its appearance based on a user's action. Instead of creating
two Image
objects then alternately hiding/showing them, one can
use the applyTo(Image)
method of two
AbstractImagePrototype
objects to transform a single
Image
object between two (or more) visual representations. The
use of AbstractImagePrototypes
results in an cleaner and more
efficient implementation.
This class also provide methods for working with raw elements, using
createElement()
and applyTo(ImagePrototypeElement)
.
This class is also a useful way to encapsulate complex HTML that represents
an image without actually instantiating Image
objects. When
constructing large HTML fragments, especially those that contain many images,
getHTML()
can be much more efficient.
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
AbstractImagePrototype.ImagePrototypeElement | This corresponds to the top Element of the DOM structure created by
createElement() . |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Transforms an existing
Image into the image represented by this
prototype. | |||||||||||
Transforms an existing
AbstractImagePrototype.ImagePrototypeElement into the image
represented by this prototype. | |||||||||||
Create an AbstractImagePrototype backed by a ClientBundle ImageResource.
| |||||||||||
Creates a new
AbstractImagePrototype.ImagePrototypeElement based on the image represented by this
prototype. | |||||||||||
Creates a new
Image instance based on the image represented by this
prototype. | |||||||||||
Gets an HTML fragment that displays the image represented by this
prototype.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Transforms an existing Image
into the image represented by this
prototype.
image | the instance to be transformed to match this prototype |
---|
Transforms an existing AbstractImagePrototype.ImagePrototypeElement
into the image
represented by this prototype.
imageElement | an ImagePrototypeElement created by
createElement()
|
---|
Create an AbstractImagePrototype backed by a ClientBundle ImageResource. This method provides an API compatibility mapping for the new ImageResource API.
resource | an ImageResource produced by a ClientBundle |
---|
Creates a new AbstractImagePrototype.ImagePrototypeElement
based on the image represented by this
prototype. The DOM structure may not necessarily a simple
<img>
element. It may be a more complex structure that
should be treated opaquely.
ImagePrototypeElement
corresponding to the image
represented by this prototype
Gets an HTML fragment that displays the image represented by this
prototype. The HTML returned is not necessarily a simple
<img>
element. It may be a more complex structure that
should be treated opaquely.