smart layout

A Smart layout is a grid (corresponding to an HTML <TABLE> element) of paired cells on a harness, section, or flow action form that has columns of uniform width, uniform styles, and uniform characteristics. Each pair of cells holds one label and one property value or other form control.

Note: As a best practice, use dynamic layouts for new development. It is recommended that you upgrade existing smart layouts to take advantage of HTML5 capabilities including cross-browser and cross-platform compatibility, access to the latest HTML markup, and improved performance.

When you open a section with a smart layout, you'll see a guardrail warning and a suggestion to upgrade.

Click Update layouts for Designer Studio to update this layout instance to a dynamic layout.

Some smart layout configurations may not have a one-to-one correspondence with dynamic layouts and may require some manual modifications. Note the following:

Using Smart Layouts

Use Smart layouts when creating form-like layouts consisting of label-field pairs that align across multiple rules.

A primary benefit of Smart layouts it to force vertical alignment even when layouts are nested. When a section using Smart layouts is nested within another section, all labels and fields are given consistent widths. Padding and cell widths are adjusted to seek attractive spacing and presentation.

The width and other style characteristics of these Smart layout templates depends on the portal skin rule in use. To ensure consistent results when building harnesses, sections, or flow actions for user forms, set the Skin preference to the skin that application users are expected to use. You can change template widths, heights, cell padding, and other characteristics of the templates using the Skin rule.

By design, you cannot change the height or width of Smart layout template-based cells through rule form updates. However, the template cell height and widths in styles for the <TD> HTML element are recorded. If at run time a cell contains an object that is explicitly larger than these values, browsers expand the table cell to attempt to display the entire object, overriding the fixed size restriction. The resulting display might vary by browser version.

When creating a SmartLayout, choose a template to control the number of columns created: Single, Double or Triple.

Conversion

Non-Smart layout-based harnesses, sections, or flow actions cannot automatically be converted to a Smart layout form . While in some cases conversion is not possible, in many cases conversion might require only a few minutes.

To convert an existing Smart layout, select the Allow changes to column check box on the Properties panel of the Smart layout.