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 — Trees and tables - General tab

Updated on April 5, 2022

Use this tab to define default settings for text, border, and background in the selected grid format. You can then select a check box to apply these default settings to various table (grid) elements on the Rows, Headers, Borders, Behaviors, and Headers and footers tabs, rather than defining the text, border, and background style on each of these tabs.

The styles that you define on the General tab are not applied until you select to use them; for example, on the Rows tab, you can select the Use default text for this format check box to enable the default text format for odd rows in a grid.

You can define styles for the following grid, tree grid, and Creating a hierarchical table layout layouts, as well as create additional formats.

  • Default
  • Spreadsheet
  • Transparent
  • List report
  • Summarized report

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

Responsiveness

The responsive behavior of grids corresponds with the dynamic behavior of layouts and layout groups. When the screen size reduces or increases to the dimensions that you specify, the grid's appearance changes, according to the options you select. In the skin, you are able to specify a single primary column and multiple secondary columns. As determined by screen widths that you define (called breakpoints), the grid can remove or add "other" columns (ones that are neither primary or secondary). The table can also transform into a "fat list", in which the primary column becomes a header and the information in the secondary columns appears below the header. The grid can optionally be hidden completely.

Default text

Use mixin
Mixin overrides
Click Add mixin override to override a style that is set by the mixin:
Font
Select the font family. The font family defaults to (use overall), which is the font that you specified in the Overall Font field at the top of the Mixins tab.
Font Size
Select the font size in pixels (px), points (pts), em (the current font size), or percentage (%).
Color
Enter a hexadecimal value (such as #3d3d3d), or click the box next to the field to choose a color.
Font Weight
Select a font weight from the list.
Text Decoration
Select a text decoration option from the list. For example: Underline. A blank selection indicates that no additional attributes are applied.
Transform Text
Select a text transformation option from the list. Ffor example: Lowercase. A blank selection indicates that no additional attributes are applied.
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 text styles. Click Add additional styles to define another CSS attribute-value pair.
Specify styles Select this check box to define a custom text format:
Font
Select the font family. The font family defaults to (use overall) , which is the font that you specified in the Overall Font field at the top of the Mixins tab.
Font Size
Select the font size in pixels (px), points (pts), em (the current font size), or percentage (%).
Color
Enter a hexadecimal value (such as #3d3d3d), or click the box next to the field to choose a color.
Font Weight
Select a font weight from the list.
Text Decoration
Select a text decoration option from the list, for example, Underline. The blank selection is the default selection for backward compatibility and indicates that no additional attributes are applied.
Transform Text
Select a text transformation option from the list, for example, Lowercase. The blank selection is the default selection for backward compatibility and indicates that no additional attributes are applied.
  • Additional styles — 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 text styles. Click Add additional styles to define another CSS attribute-value pair.

Default border

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

Default background

Use mixin
  • Additional styles — 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 text styles. Click Add additional styles to define another CSS attribute-value pair.
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.
Responsive Breakpoints
Enable support for responsive breakpoints Select this check box if you want to add a responsive breakpoint to your grid. When the screen size reduces to the dimensions that you specify, the grid's appearance changes, according to the options you select for the first, second, and third breakpoints.

See Grid layout - Presentation tab

Breakpoint1 Select the format that the grid should use when rendering at the dimensions specified for this breakpoint.
  • Drop columns with importance ‘other’ — All columns in a harness or section grid that have the default Importance property of Other are removed from the grid when the screen size is less than the selected breakpoint.
  • Transform to list — The contents of all columns in a harness or section grid that have the Importance property of Secondary are consolidated in a single-column "fat list" with their respective Primary column text appearing as a bolded heading. See Breakpoint2 (below) for the list options.
  • Hide grid — The entire grid is hidden when the screen size is less than the selected breakpoint.
  • max-width — Specify the maximum width at which the grid will display in the format you specified for this breakpoint.
  • unit — Specify the unit of measurement for the width of the grid: px (pixels) or em (font size).
  • min-width — Specify the minimum width at the grid will display in the format you specified for this breakpoint. Leave min-width empty when a range is not desired.
  • unit — Specify the unit of measurement for the width of the grid: px (pixels) or em (font size).
  • Add breakpoint — Select to add another responsive breakpoint. Click the X icon to remove an additional breakpoint.
Breakpoint2 Typically, the second breakpoint determines the appearance of the primary and secondary cells when the grid becomes a "fat list". (You have the same options for dropping columns, transforming to a list, or hiding the grid as for Breakpoint1.)
  • List Item — Changes the grid to a one-column list with the following options. Refer to Border settings above.
  • List Item Bottom Spacing — The spacing in px (pixels), percent, or em (font size) from the base of the grid to the edge of the harness/section or next control.
  • Primary Cell — Applies to the cells of the column marked Primary as it appears in the list. Refer to Border and Background settings above.
    • Background — Refer to Background settings above.
    • Border — Refer to Border settings above.
  • Secondary Cell — Applies to the cells of the columns marked Secondary as they appear in the list.
  • Label position — Select None (no label) or Left.
  • Label width — Specify the label width and unit of measurement for the label width: px (pixels) or em (font size).
  • Label format — Choose from the available skin styles.
  • max-width/unit — Refer to Breakpoint1 properties above.
  • min-width/unit — Refer to Breakpoint1 properties above.
Breakpoint<n>Typically, the third (and any other) breakpoints determine the final appearance of the grid or whether to hide it. (You have the same options for dropping columns, transforming to a list, or hiding the grid as for Breakpoint1 and Breakpoint2.)

Creating custom table and tree table formats

  • To create a style format, perform the following actions:

    1. Click Add a format.

    2. In the Create a new format dialog box, enter the Format name by using only alphanumeric characters (a-z and 0-9) and spaces.

      The name cannot begin with a number. The format name that you enter is converted into the name CSS class or classes.

    3. Optional:

      Provide a Usage annotation.

    4. Click OK.

    Result: The new format is populated with default values.
  • To create a style format by copying an existing format, click Actions and select Save as from the list.

  • Creating custom table and tree table formats

    You can create a new custom format or copy an existing one.

  • grid

    Help users access and compare data with table layouts. Use tables in your applications as a flexible basis for users to process large amounts of information. For example, tables in a price comparison application can help users efficiently identify the best offer.

  • tree grid

    A tree layout allows users to view, navigate, and access the properties in pages in an embedded Page List property. The user can quickly expand and collapse branches of the tree to find entries of current interest.

  • Creating a hierarchical table layout

    Help users access and compare nested data with a Hierarchical table layout. Hierarchical table layouts support expandable rows, which can provide you with a more compact view of your data.

  • Component styles (custom style formats)

    Use the Component styles tab to define the presentation of components by creating custom style formats. After you define style formats, reference them on property panes for sections, harnesses, and controls.

  • Previous topic Skin form &mdash; Components tab &mdash; Layouts &mdash; Tabs
  • Next topic Creating custom table and tree table formats

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