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.

Updated button and link formats in UIKit 10

Updated on October 16, 2017

Button and Link control formats in the pyEndUser skin have been simplified to focus on three formats: Strong, Standard, and Simple. These primary formats give your application a streamlined and predictable user interface, make it easier for users to complete forms, and now meet the WCAG2.0 AA contrast ratio standards for users with visual impairments. Because the meaning of Standard and Simple button formats has changed with this release, you need to update certain existing Button and Link controls when upgrading applications to UIKit 10 from a previous version. This article describes the new meanings of these formats and explains what you need to do to use the new formats.

Button control formats

You specify the format of a Button control to provide a visual cue to users about its relative importance. For example, when you design a form for updating a billing address, you want to indicate that the Update button represents the primary action that users take on the form. For this Button control, you would set the format to Strong.

FormatPurposeExample

Strong

Primary action on the form. Use once per view.

strongbutton
StandardNavigation and secondary actions.standard button
SimpleTertiary actions.simplebutton.png

As the table shows, Standard and Simple formats now have different meanings than they had in previous UIKit versions. You need to perform two actions when upgrading an application to UIKit 10 from a previous UIKit version:

  • Convert existing buttons that used the Simple format to the Standard format.
  • Convert existing buttons that used the Light format to the Simple format.

To specify formats for Button controls, use the Control format option on the Presentation tab of the Cell Properties panel.

If your application has many buttons that need to be converted, use the Update-Button-Link-Formats activity to automate updating your existing Button controls to the new formats. For more information, see Update-Button-Link-Formats.

In addition, some Button control formats have been deprecated. You should change existing Button controls to use a recommended new format. The following table outlines the deprecated formats and recommended replacements:

Deprecated Button control formatRecommended replacement

Full Width

Standard

DashboardStandard
SecondaryStandard

Link control formats

Similarly, you specify the format of a Link control to indicate its relative importance. For example, if you are designing a form with multiple links, you set the format to Strong for the primary Link control.

FormatPurposeExample

Strong

Primary link on the form. Use once per view.

stronglink.png
StandardLinks of secondary importance.standardlink.png
SimpleLeast important links.simplelink.png

To specify formats for Link controls, use the Control format option on the Presentation tab of the Cell Properties panel.

If your application has many links that need to be converted, use the Update-Button-Link-Formats activity to automate updating your existing Link controls to the new formats. For more information, see Update-Button-Link-Formats.

Some Link control formats have been deprecated. You should change existing Link controls to use a recommended new format. The following table outlines the deprecated formats and recommended replacements:

Deprecated Link control formatRecommended replacement

List link

Horizontal menu items

Work grid itemStrong
Case toolsSimple
Workarea header highlightStandard

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