Issue
Default form with two or three column layouts will not maintain the column format when added in the Partial/Read-only views.
Symptoms and Impact
After an upgrade from Pega Infinity™ release 23.1.3 to release 23.1.4 all partial form views with two or three column layouts now appear in a single column layout. This makes it difficult to scroll through large sets of data.
Steps to reproduce
-
Create Form views with Default form template with two column or three column layouts.
-
Refer these Form views in the Partial/Read-only view.
-
At runtime, the Read-only views display Form views in a single column layout structure.
Root Cause
This is an expected behavior change introduced in Pega Platform '23.1.4 to solve an accessibility issue. Changes were made to be compliant with the WGAG 2.1 standards. The issue that we are addressing is for the success criterion 1.3.2, which is for meaningful sequence. This means that even if the visual layout of a page changes, the order of elements should still make sense and be accessible to users, especially those using assistive technologies like screen readers.
Solution
1. Create Views containing meaningful collections of fields you want to reuse between Form and Detail views.
2. Update Form Views to use these sub-views in place of individual fields directly.
-
If necessary, update the outer (original) Form View to apply its layout arrangements to sub-views (via advanced settings).
3. Update Details Views to use a template with the desired number of columns.
4. Add meaningful groups of fields (the sub-views created in step 1) to columns in the Details View. This will arrange the meaningful groups of fields vertically in columns read top-to-bottom and left-to-right (unless using a RTL language like Arabic).
- If necessary create multiple Details Views with 1-3 columns and add sub-views to their columns.
- Arrange these Details sub-Views in the original outer Details View.
Related content
Creating read-only Views for Cases and data objects
Understanding Success Criterion 1.3.2 Meaningful Sequence (Level A)