This content has been archived.

Table of Contents

Updated button and link formats in UIKit 10

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.

Format Purpose Example

Strong

Primary action on the form. Use once per view.

strongbutton
Standard Navigation and secondary actions. standard button
Simple Tertiary 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 format Recommended replacement

Full Width

Standard

Dashboard Standard
Secondary Standard

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.

Format Purpose Example

Strong

Primary link on the form. Use once per view.

stronglink.png
Standard Links of secondary importance. standardlink.png
Simple Least 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 format Recommended replacement

List link

Horizontal menu items

Work grid item Strong
Case tools Simple
Workarea header highlight Standard

Suggest Edit

100% found this useful

Have a question? Get answers now.

Visit the Pega Support Community to ask questions, engage in discussions, and help others.