At run time, an entire page does not have to be refreshed because a small area of the page changed.
Smart refresh is a set of technologies that lets your application update parts of its user interface without reloading the entire page. Unlike the partial-page refresh available in the page action builders since IBM® WebSphere® Portlet Factory 6.0, smart refresh does not require a page location, and can refresh across WebSphere Portlet Factory pages. Because of this flexibility, smart refresh can be used locally in the page action builders and globally by a setting that can apply to some or all page action builder calls in a model.
Smart refresh does not update the browser history with each page action. Smart refresh is considered partial-page refresh (updating part of a page) rather than page-to-page navigation.
If used in a portlet, smart refresh updates the contents of the portlet without reloading the containing portal page or any other portlets on the page. Smart refresh refreshes the entire page when it runs in standalone mode, but does not update the browser location. This behavior is most useful for doing standalone testing of portlets.
Smart refresh is technically disabled in widgets, because widgets already are contained so that page actions result in updating only the widget HTML code.
Smart refresh can be enabled in the following ways.
- Locally by selecting the Smart Refresh option in the Post-Action Behavior builder input for one particular page action builder call.
- An intermediate approach by using the Ajax Region builder in which smart refresh can be enabled for a subset of the actions in a model.
- Globally by using a setting in a theme file that causes all action in a model to use smart refresh.
The <Use_Smart_Refresh> element can be placed in a theme definition file to control smart refresh globally. The default theme file (blue_WPF7.uitheme) for new projects uses the <Use_Smart_Refresh> element to have smart refresh active.
- In the Theme builder Partial-Page Refresh group, the Use "Smart Refresh" input lets you activate smart refresh across a model.
This setting corresponds to using the <Use_Smart_Refresh> element in a theme definition file.
Parent topic: Theme builder: wpf7