Table of Contents

Managing the main content of your application


Only available versions of this content are shown in the dropdown
Applicable to Theme Cosmos applications

Define the primary content of your portal to ensure that users who rely on assistive technology can navigate your application with less effort.

When you create an application in App Studio, Pega Platform sets WAI-ARIA roles for different content areas automatically (see WAI-ARIA roles in a screen layout). For screen layouts that you set up manually in Dev Studio, Pega Platform assigns the main content WAI-ARIA role to the central area in a screen layout by default.

However, if the UI that you want to build is unusual, and the main content belongs in an area that is not a default area, change the WAI-ARIA assignment manually to ensure that assistive technology can interpret the screen correctly.

  1. In the navigation pane of Dev Studio, click Records.

  2. Expand the User Interface category, and then click Harness.

  3. Open the harness that contains the screen layout that you want to edit.

  4. Select the main area of the layout, and then click the View properties icon.

  5. In the Panel properties window, in the Accessibility section, define the role for the area:

    • To remove semantic markup from the area and make it neutral to screen readers, in the Aria role list, select Presentation.
    • To designate the area as the main content area, in the Aria role list, select Main.
  6. Click Submit.

  7. On the harness form, click Save.

Skip link to the main content is the most important, because it directs the user to the purpose of the page.

Skip link to main content
Main skip link on an application dashboard.
If you set the WAI-ARIA role to Presentation and want to designate another layout as the main content area, assign a WAI-ARIA Main role to that layout. For more information, see Assigning WAI-ARIA roles to a Dynamic Layout.
Did you find this content helpful?

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.