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 — Controls — Buttons

Updated on April 5, 2022

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

  • Standard — Default format applied to buttons
  • Simple
  • Strong

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

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

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.

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

same for all cornersSelect 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 radiiSelect 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 (%).
RadiusDefine 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
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.
  • 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

HeightSpecify the height of the button by entering a value in pixels.

Padding

Padding

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:

  • :hover – State of the control when a user points to the control or rests the pointer on the control.
  • :focus – State of the control when the field is in focus, for example, the state of a text field when it is ready to accept inputs.
  • :active – State of the control when the field is ready to be activated, for example, when a user has clicked the control but has not yet released the mouse button.
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.
  • Auto – Select this option to apply auto-generated styles for the control in this state. These styles are generated based on the applied control format and the mixins defined within the format.
  • Default – Select this option to apply the default browser styles for the states instead of generating the styles based on a skin or defined CSS in the application.
  • Custom – Select this option to define your own styles for the element in this state.

Skin rules

  • Previous topic Skin form — Components tab — Controls — Autocomplete
  • Next topic Creating a custom button format

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