Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Skin form — Components tab — Layouts — Screen layouts

Updated on April 5, 2022

Styles set here apply to screen layout formats. Screen layouts are available only to user interfaces rendered in HTML5 document type. As a best practice, update deprecated panel sets to use screen layouts.

Screen layouts are for portal harnesses only. You should use a column layout within a harness container to format a non-portal harness that creates a form tag.

You can specify responsive breakpoints for screen layout formats with left and/or right regions. When the user resizes the panel to the breakpoint dimensions that you specify, the panel becomes accessible from an icon in the header.

You specify the responsive breakpoints for a format in the skin; you enable them in the screen layout. In the screen layout, select the User resizable check box on the properties panel of the appropriate regions in the screen layout.

A preview of the currently selected format displays to the right. You can also preview formats by selecting ActionsLaunch in the toolbar and then choosing one of the following preview options: Run Process, Open Portal, Harness Preview, UI Gallery Preview, Skin Preview.

Overall

Minimum widthSpecify the minimum width of the screen layout.
Maximum widthSpecify the maximum width of the screen layout.
Width unit

Specify the unit of measurement for the width of the layout: percentage ( % ), em (the current font size), or pixels ( px ).

AlignmentSpecify the overall alignment of the screen layout on the screen.

Depending upon the format that you select, specify the Background and Border for the Header , Left , Right , Footer , and Center areas.

In addition, depending upon the format you select, complete the following:

Header and Footer

Applies to the header and footer of the screen layout.

Panel heightSpecify the height of the header region in pixels.

Left and Right

Applies to the left and right panels of the screen layout.

Panel widthSpecify the width of the panel.
Add responsive breakpoint Select this check box if you want to add a responsive breakpoint. When the user resizes the panel to the dimensions that you specify, the panel becomes accessible from an icon in the header.

If specify responsive breakpoints, which are available for screen layout formats with left and/or right regions, make sure you select the User resizable check box on the properties panel in the appropriate regions of the screen layout.

max-widthSpecify the maximum width at which the left or right panel is hidden and is accessible from the icon in the header.
unit

Specify the unit of measurement for the width of the layout: pixels ( px ) or em.

min-widthSpecify the minimum width at which the left or right panel is hidden and is accessible from the icon in the header. Leave the min-width empty when a range is not desired.
unit

Specify the unit of measurement for the width of the layout: pixels ( px ) or em.

Navigation Toggle Icon

Applies to the navigation icon that displays when the responsive breakpoints that you specify for the left or right panel are reached.

HeightSpecify the height of the navigation icon.
WidthSpecify the width of the navigation icon.
Location Specify the location of the file, including the relative path. For example, images/AlphaCorpLogo.png.

To search for an image, open the Image Catalog tool. Enter any portion of a file name (relative path, file name, or extension) in the Search box, and click Find. If you can’t find the image, make sure it is in the webwb directory.

Panel Separator

A panel separator is a feature of a screen layout that enables responsive behavior. When a screen layout has a resizable panel, you can drag the separator to change the relative sizes of the panels at run time.

Use same for horizontal and verticalClear this check box if you want to define different horizontal and vertical separators.
Separator thicknessSpecify the thickness of the separators in pixels.
Use mixin
Specify styles Select this check box to define a custom background for the separator:

Select the background Type:

none
Indicates no background color, similar to setting a transparent background.
solid
Enter a hexadecimal value (such as #3d3d3d), or click the box next to the Color field to choose a color.
gradient
Select the Direction in which you want to blend the background colors (horizontal or vertical. Specify the Start and Stop colors of the gradient. Specify a Backup color, in the event that the browser cannot render the gradient.
image
Select a background image by specifying the following options:
Background color
To use the background color specified in a mixin, choose obtained from mixin and then click the gear icon to select the mixin. Alternatively, you can select custom color and enter the CSS hexadecimal value or click the box next to the field to choose a color.
Location
Enter the location of the file, including the relative path. For example, images/AlphaCorpLogo.png.
Tile
Specify tile settings for the image.
  • If you want to use a single image, select None.
  • If you want a row of images in the background, select Horizontal.
  • If you want a column of images in the background, select Vertical.
  • If you want rows and columns containing the image in the background, select Both.
Position
Specify the placement of the starting tiled image, for example: top left.
Additional styles
You can apply additional styles, specific to styling the text for this element, by specifying a CSS attribute and value. You must specify a CSS attribute that is related to background styles. Click Add additional styles to define another CSS attribute-value pair.

Depending upon the format you select, specify the Background and Border for the Header , Left , Right , Footer , and Center areas.

Background

Applies to the background of the specified element: Header , Left , Right , Footer , and Center .

Use mixin
Specify styles Select this check box to define a custom background:

Select the background Type:

none
Indicates no background color, similar to setting a transparent background.
solid
Enter a hexadecimal value (such as #3d3d3d), or click the box next to the Color field to choose a color.
gradient
Select the Direction in which you want to blend the background colors (horizontal or vertical. Specify the Start and Stop colors of the gradient. Specify a Backup color, in the event that the browser cannot render the gradient.
image
Select a background image by specifying the following options:
Background color
To use the background color specified in a mixin, choose obtained from mixin and then click the gear icon to select the mixin. Alternatively, you can select custom color and enter the CSS hexadecimal value or click the box next to the field to choose a color.
Location
Enter the location of the file, including the relative path. For example, images/AlphaCorpLogo.png.
Tile
Specify tile settings for the image.
  • If you want to use a single image, select None.
  • If you want a row of images in the background, select Horizontal.
  • If you want a column of images in the background, select Vertical.
  • If you want rows and columns containing the image in the background, select Both.
Position
Specify the placement of the starting tiled image, for example: top left.
Additional styles
You can apply additional styles, specific to styling the text for this element, by specifying a CSS attribute and value. You must specify a CSS attribute that is related to background styles. Click Add additional styles to define another CSS attribute-value pair.

Border

Applies to the border of the specified element: Header , Left , Right , Footer , and Center .

Use mixin

If desired, you can specify the Top , Left , Right , or Bottom border as none, solid, dashed, or dotted, rather than inheriting the style from the selected mixin.

Specify styles

You can specify a custom border by selecting or clearing the Apply to all sides check box:

  • When selected, you can choose the same border style, pixel width, and color for the top, right, bottom, and left borders.
  • When cleared, you can choose a border style, pixel width, and color for the top, right, bottom, and left borders individually.

The following border styles are available:

  • none
  • solid
  • dashed
  • dotted

  • Harness form Adding a screen layout

    Screen layouts determine the overall structure of your screen. They define the structure of a harness that is included in a composite portal. When you create a new harness it contains a screen layout by default. A harness can contain only one screen layout.

  • Previous topic Skin form — Components tab — General — Panel Set
  • Next topic Skin form — Components tab — General — Wizard

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us