Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 5 Performance Improvements : Static Rendering

Static Rendering
There are certain cases where the information displayed within a pane is read-only, and the end 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.
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:
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.
Figure 127 Properties View for 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.
Static Rendering Constraints
Model Validations
Panes with the Static Rendering property set to true have the following constraints on model validation:
The Static Rendering property setting is ignored by the Mobile runtime. A warning-level problem marker is shown if a pane has the Static Rendering property set to true and any of the presentation channels uses Mobile rendering.
Runtime Functionality
For static panes, contents of the pane are rendered in simple HTML using streamlined JavaScript generated at design-time.
Pane Value Update
When the value of a static pane is updated using either script, binding or computation action, the content of the pane is regenerated using the same JavaScript initially used to render the pane.
Static Grid Panes
Static grid panes support the following functionality:
The following functionality is not supported in static grid panes:
A static grid pane is rendered as a compact non-editable grid pane, with the values represented as plain text.
It is possible to use a static grid pane as a part of a master-detail configuration. The non-static detail pane can be bound to the selection of the grid pane as is currently done. When a value is changed in the detail pane, the corresponding row in the static grid pane is re-rendered using the original generated JavaScript.
Tabbed Panes
Although tabbed panes cannot be marked as static, child panes that are vertical, horizontal, or grid panes can be marked as static.
Localization
Static panes support localization and will be regenerated if the form locale is updated.
Renderings for Specific Controls
Most controls in a static pane are rendered in the same fashion as in a normal pane, but are rendered in a read-only fashion.
If the Text Only property is set to true, then the value of each control is rendered as plain text. The values are formatted appropriately according to the type (as listed in Table 19). The control widgets are not rendered. Although, the rendering of images, hyperlinks, buttons, and pass-through controls is the same as in a static pane.
The following table lists how specific controls in a static pane are rendered:
 
Table 19 Rendering of Specific Controls
 

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved