Restrictions on Runtime Functionality

For static panes, contents of the pane are rendered in simple HTML using streamlined JavaScript generated at design-time.

  • Validation markers are not displayed on controls in static panes.
    • Initial data are assumed to be valid.
    • For master-detail configurations, the grid pane can be updated using a non-static detail pane, but validation markers are only shown in the detail pane.
    • Data can be changed using the data API.
      Warning: The values updated using the data API are not validated if they are shown only within a static pane.
  • ’Required value’ indicators are not displayed on controls in static panes.
    Warning: Static panes should only be used in cases where you are assured that all required values have already been filled out, or when the user has an alternate method of specifying data, such as master-detail configurations. An example would be a step in a process where a user confirms previously specified data before proceeding.
  • Controls in static panes are completely static. It is possible to set a Style Class Name on a static pane and the child components, but the value is fixed 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.

Warning: A control within a static pane will not be refreshed when the underlying data value is updated if the control is directly bound to either of the following:
  • A primitive parameter or data field.
  • A primitive attribute of a data field.

Static Grid Panes

Static grid panes support the following functionality:

  • Row selection
  • Pagination
  • Adding records
  • Deleting records
  • Sorting

The following functionality is not supported in static grid panes:

  • Editing
  • Validations on controls
  • Computation actions on controls

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 the table Rendering of Specific Controls). 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 table Rendering of Specific Controls lists how specific controls in a static pane are rendered:

Rendering of Specific Controls

Control Rendering in Static Panes
Text Rendered as a read-only text input.
Text-Secret Rendered as a read-only secret text input (values are obscured).
Text-Numeric Rendered as a read-only text input. Numbers are formatted according to the format set on the control.
Textarea Rendered as a read-only text area. The content of the text area is scrollable.
Checkbox Rendered as a read-only check box.
Date Rendered as a read-only input. Value is formatted using the date format.
Time Rendered as a read-only input. Value is formatted using the time format.
DateTime Rendered as a read-only input. Value is formatted using the datetime format.
Hyperlink Rendered as a normal, active hyperlink.
Image Rendered within an img element.
Label Rendered as plain text.
Optionlist The label for the selected value is displayed in a read-only input element.
Multi-select Optionlist A read-only version of the multi-select optionlist is displayed, with the selected values highlighted.
Pass-through Static pass-through content is inserted as normal.
Radiogroup Rendered as a read-only radiogroup, showing the selected value.
Button Rendered normally. The button is active and can trigger rules defined in the form model.
List controls Values rendered in a string, in a read-only input, using the localized list item-separator.