You are here: Reference > Rule types > Skin rules > Skin form — Controls — Buttons

Skin form — Components tab — Controls — Buttons

Styles set here apply to buttons. The following button formats are available in a skin form.

You can also create custom button formats.

A preview of the currently selected format displays to the right. To preview all Button formats, click Preview All.

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.

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.

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.

Rounded corners

enable rounded corners (HTML5 only)

Select this check box if you want the border of the overlay to have rounded corners when rendered in HTML5 document type. You can select this option when using a mixin or a custom border.

For information about rendering your application in HTML5 document type, see HTML5 Application Readiness.

Rounded corners do not work when the UI is rendered in quirks mode.

same for all corners

Select to use the rounded corner settings that you specify in the Unit and Radius fields for all four corners or clear to specify the length of the x and y axis for the Top Left, Top Right, Bottom Left, and Bottom Right.

same x and y axis radii

Select to specify x and y radii of the same length. If you clear this check box, specify the length of the x and y axis for the Top Left, Top Right, Bottom Left, and Bottom Right.

Unit Select the unit of measurement for the rounded corner settings: pixels (px), em (the current font size), or percentage (%).
Radius

Define the curve of rounded corners by specifying the x (hortizontal) and y (vertical) radii of the quarter ellipse that makes the rounded corner of the overlay.

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.

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

Height

Height Specify the height of the button by entering a value in pixels.

Padding

Padding

Specify the width of the padding in pixels. Clear the Apply same padding on all sides check box if you want to specify a different amount of padding, in pixels, for Top, Left, Right, and Bottom.

Button states

Use the options in this section to style the control based on its state. You can style the control differently when it is in one of the following states:

You can apply different styles for different states by using one of the following styles. To use the same style for all states, select the Use same styles for hover, focus and active check box.

Creating custom button 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.

Applying a custom button format

  1. In the cell that contains the button control, click the Gear icon to open the Cell Properties panel.
  2. On the Presentation tab, select Other in the Format list.
  3. In the field that is displayed, press the Down Arrow to select the format that you want to apply to the button.

About Skin rules