Client-side and server-side page rendering modes

The Page Builder theme supports two rendering modes. These are referred to as client-side and server-side aggregation modes.
Client-side mode

In client-side mode the following applies:

• Page changes occur without a browser full page refresh. Upon a user request a SWITCH_PAGE client-side event is fired. This triggers the update of the page navigation, and the contents of the new page are loaded and replace the content of the prior page.

• Interaction with portlets and widgets updates only the affected portlet or widget, and possibly others as a result of wiring. Portlets are rendered as iWidgets by means of an iWidget Wrapper.

• The implementation and programming model for client-side mode is provided by the Mashups Enabler common component, and public builder events.

Server-side mode

In server-side mode the following applies:

• Page changes cause a browser full page refresh.

• Interactions with portlets result in a browser full page refresh.

• However, iWidgets are rendered and interact within the page just as in client-side mode.

Theme element handling of rendering mode

To render the portal theme, the same theme elements are used in both rendering modes. In general, you can write navigation iWidgets to fire a SWITCH_PAGE event. The internal JavaScript NavigationController of the theme determines the current rendering mode of the page and processes the event appropriately.

Activating page rendering in client-side mode

To activate the client-side mode by using the iWidget standard, you need to do the following two things:

1. Change the page theme to one that uses client side rendering.

2. Set the render type to client-side mode by using one of the following two ways:

   • By using the Page Properties portlet:

     1. Select Edit Page Properties either from the Actions menu in the theme, or from the Manage Pages administration portlet.

     2. Find the radio button group for Page Rendering Mode and select Client-side rendering mode.

     3. Click OK to save changes.

   • By setting the appropriate page metadata on the page.

For example, you can do this by using WebDAV and the following content model URL:

http://my_server:portal_port/wps/mycontenthandler/dav/contentmodel/wps.content.root/metadata.properties

Make sure the following two lines have been added:

com.ibm.portal.rendertype=iwidget 
com.ibm.portal.rendertype.version=2.0

Parent

The Page Builder theme

 

+

Search Tips   |   Advanced Search