You are here: Reference > Rule types > Skin rules > Skin form - Layouts - Trees & grids - General

Skin form — Components tab — Layouts — Trees & grids

  1. General
  2. Rows
  3. Headers
  4. Borders
  5. Behaviors
  6. Action Layouts

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 grid elements on the Rows, Headers, Borders, Behaviors, and Action Layouts 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 grid format check box to enable the default text format for odd rows in a grid.

You can define styles for the following grid, tree, and tree grid layouts, as well as create additional formats.

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

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

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

Select this option to use a mixin to define the appearance of this element. The Mixin field displays the name and a preview of the currently selected 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, for example, Lowercase. A blank selection indicates that no additional attributes are applied.
  • Additional styles — Add 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 — Add 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

Select this option to use a mixin to define the appearance of this element. The Mixin field displays the name and a preview of the currently selected 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

Select to define a custom border:

  • Apply to all sides — Select this check box to specify the same border style to the top, left, right, and bottom borders. Choose from none, solid, dashed, or dotted.
  • If you clear the Apply to all sides check box, select a border style for the Top, Left, Right, and Bottom borders. For each of these borders, you can select none, solid, dashed, or dotted. Specify the pixel width and color of the border, if applicable.

Default background

Use mixin

Select this option to use a mixin to define the appearance of this element. The Mixin field displays the name and a preview of the currently selected mixin.

  • Additional styles — Add 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 — Specify the following:
    • 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.

      To search for an image, click the Gear icon to 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 cannot find the image, make sure it is in the webwb directory.

    • Tile — Specify tile settings for the image. Select None if you want to use a single image; Horizontal if you want a row of images in the background; Vertical, if you want a column of images in the background, or Both, if you want rows and columns containing the image in the background.
    • Position — Specify the placement of the starting tiled image, for example, top left.
  • Additional styles — Add additional styles, specific to styling the background for this element, by specifying a CSS Attribute and Value. Specify only CSS related to background styles. Click Add additional styles to define another CSS attribute-value pair. Click the Delete icon to remove an additional style.
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 grid and tree grid formats

To create a style format:

  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. 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.

About Skin rules