You are here: Reference > Rule types > Skin rules > Skin form - General - Modal dialogs - Header

Skin form — Components tab — General — Modal dialogs

  1. Header
  2. Body
  3. Modal Dialog window

Styles set here apply to the header of modal dialogs. You can define styles for the Standard modal dialog format or create custom modal dialog formats.

Note that the implementation and CSS classes for modal formats differs, depending upon whether your application is rendered in HTML5 document type - standards mode or in quirks mode. See Displaying a modal dialog in a custom format created in the skin on the PDN.

A preview of the currently selected format displays to the right. You can also preview formats by selecting Actions > Launch in the toolbar and then choosing one of the following preview options: Run Process, Open Portal, Harness Preview, UI Gallery Preview, Skin Preview. In the Skin Preview, select the Controls tab and click Open Modal.

Text

Applies to the text of the modal dialog header.

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 to define a custom style for text in the modal dialog header.

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

Border

Applies to the bottom border of the modal dialog header.

Bottom Select a border type for the bottom border: none, solid, dashed, or dotted. Click the box next to the field to Choose a Color.

Background

Applies to the background of the modal dialog header.

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.

Creating a custom modal dialog format

Styles that you define in the modal dialog format in the skin are applied to the modal dialog template, pyModalTemplate or pyGridModalTemplate. You can modify this template, for example, to replace the OK and Cancel buttons. Buttons in the modal dialog are styled using the settings in the Standard Button format in the skin.

Creating a custom modal dialog format

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.

Applying a custom modal dialog format

  1. Configure a modal dialog to launch from a control, such as a button, or from a grid. See How to present a row of a repeating layout as a modal dialog for instructions.
  2. In the Modal Format field, select Other.
  3. In the field that displays, press the down arrow to select the custom modal dialog format that you want to use.

The implementation and CSS classes for custom modal formats differs, depending upon whether your application is rendered in HTML5 document type - standards mode or in quirks mode. For example, in HTML5 document type – standards mode, modal dialogs honor the design time width of the layout, while, in quirks mode, modal dialogs shrink to the minimum width and height possible. Drag and drop is not supported in modal dialogs rendered in standards mode. If your application contains modal dialogs and is rendered in both standards and quirks modes, generate test cases for each. See Displaying a modal dialog in a custom format created in the skin on the PDN.

About Skin rules