org.apache.tapestry5.corelib.components.ProgressiveDisplay

A component used to implement the progressive enhancement web design strategy; the component renders itself with a simplified initial content (i.e., "loading ...") and an Ajax request then supplies the component's true body. This results in much faster page loads. You can even nest these! The component simply does not render its body on initial render. On the subsequent action event request, it fires a EventConstants#PROGRESSIVE_DISPLAY event to inform the container about the (optional) event context. The event handler method may return a renderable object; if not then the component's body is rendered as the partial markup response.

[JavaDoc]

Available since

5.1.0.1

Component Parameters

NameTypeFlagsDefaultDefault PrefixSinceDescription
contextObjectNOT Allow NullpropIf provided, this is the event context, which will be provided via the event.
initialBlockNOT Allow Nullblock:defaultInitialliteralThe initial content to display until the real content arrives. Defaults to "Loading ..." and an Ajax activity icon.
updateStringNOT Allow NullliteralName of a function on the client-side Tapestry.ElementEffect object that is invoked after the elements's body content has been updated. If not specified, then the basic "highlight" method is used, which performs a classic "yellow fade" to indicate to the user that and update has taken place.

Informal parameters: supported

Component Events

  • progressiveDisplay

Back to index