Static Rendering

There are certain cases where the information displayed within a pane is read-only, and the user does not need to edit the values in the pane. In such scenarios, you may gain a performance boost in the load time of the form by marking the pane to use static rendering.

How does Static Rendering Improve Performance?

When a pane is marked to use static rendering, the following optimizations are applied:

  • Faster Rendering: Form uses an optimized rendering of the controls and markup within the pane which helps the form to render faster.
  • Reduced Load Time: For a pane having multiple child controls and child panes, individual objects are not instantiated for each child. This reduces the load time considerably. The drawback is that it is not possible to reference those objects using JavaScript in form actions.
Note: Although the static rendering feature helps to enhance the performance of forms it imposes constraints on model validations. The runtime functionality of static panes is also restricted. Refer to Runtime Functionality for details.

When to Use Static Rendering

The use of static rendering may not make a big difference in simple and small panes. The difference in load time is more pronounced as the panes get larger in terms of child controls and child panes.

Using static rendering can be useful in the following scenarios:

  • Panes that need to display a large amount of non-editable information.
  • Non-editable grid panes, such as those used in a master-detail implementation. It is possible to select individual rows, and the data within the pane are refreshed if the underlying records are modified. However, the static grid pane renders faster than the corresponding editable grid pane.

Configuration of Static Rendering

Panes support the static rendering functionality. You can configure this feature using the options available on the Properties tab in the Properties view of a pane.

  • Static Rendering: Check box used to mark a pane to use static rendering. If selected, the pane is rendered as static pane. This property can be set only at design-time. It is not possible to convert a pane to static at runtime.
  • Text Only: Check box used to mark a static pane to use text-only rendering. If selected, the pane is rendered as plain text, with no control widgets. This check box is enabled only if the Static Rendering check box is selected.