Harness and section forms - Adding a Layout Group

A layout group combines different types of layouts to display a set of content such as a list of financial accounts and related transactions. You use a layout group to specify how to navigate sets of information. For example, this could be a tab for each account, or by simply changing the type, the account list can be rendered as either a drop-down menu, accordion, tabbed, or list. Additionally, a layout group is a way to present information responsively that is normally shown within one control type. A layout group can be rendered as a tab control, an accordion, a stacked format, or a drop-down menu according to screen size. A layout group can contain any number of dynamic layouts, column layouts, repeating dynamic layouts, or other layout groups.

Layout groups are available only to user interfaces rendered in HTML5 document type (standards mode). Layout groups have been designed to comply fully with WCAG accessibility guidelines.

Swipeable content on a touch device

With a layout group, what would usually appear as a tab control on a regular desktop or laptop converts to a different navigation mechanism on a touch device, negating the need for horizontal scrolling. You can set responsive breakpoints, enabling the layout to adjust to the available space. When the user resizes to the default or custom breakpoint dimensions, tabs turn into an accordion or a menu.

If using a touch device that supports swiping, the user can swipe to navigate across available content in tabbed or menu-style layout groups. Select the Enable swipe action check box below the Display header and title check box. The swipe action setting is enabled by default. With this setting, visible indicators appear on the left or right when additional content is available to view. These swipe indicators are shown when a user presses or taps down on the device and are hidden when the user lifts ("taps up") from the screen or moves to another area.

Customizing swipe indicators

You can use customized CSS to change the following behaviors of swipe indicators:

• Fade-in duration - Tap-down transition can be adjusted
• Fade-out transition duration - Tap-up transition can be adjusted
• Show new indicators on every tap - By default, if a user rapidly taps the screen, the swipe indicators appear just once and then fade out. You can, however, show new indicators each time the user taps or quickly swipes through group items.

While there are no options to configure the swipe indicators in the skin rule form, you can override the pzBaseCore classes to adjust indicator styling. The preferred option is to add an additional style sheet to the skin rule form and define the styling there.

For example, to override the default swipe indicators with an image called psMyCustomRightSwipeIndicator.png in the library webwb, you would use the following code:

.swipe-indicator {

background-color:transparent;

border: none;

opacity: 1;

}

.left-swipe-indicator {

border-radius:0;

background-image:url(webwb/pzMyCustomLeftIndicator.png);

}

.right-swipe-indicator {

border-radius:0;

background-image:url(webwb/pzMyCustomRightIndicator.png);

}

Layout group formats

There are four style formats for layout groups:

• Tab
  In a tab mode, each pane appears in a separate tab. When several tabs need to be displayed, the tabs are shown as a single row of tabs that can be scrolled horizontally by clicking the left and right arrows. Additionally, click the down arrow to view all the open tabs and switch to a tab directly.
  
  
• Accordion
  Panes are selectable by dividers.
  

• Stacked
  Panes are selectable by a stacked format.
  

• Menu
  Panes are selectable by a menu.
  

A preview of the currently selected format is displayed to the right. 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.

Adding a Layout group

1. In the harness or section, click the Layout control group and drag a Layout Group control.
2. On the Choose layout-group format dialog box, select one of the layout group formats: Tab, Accordion, Menu, Default (last selected), or Other (for a custom layout).
3. Click the Gear icon to open the layout group properties panel.
4. On the Layout group properties panel, define the instance-specific properties of the layout group:
   

• General
• Presentation

To view and interact with examples and review configurations, select Designer Studio> User Interface > UI Gallery, and then select Layout Group in the Layouts and Containers group. Not implemented yet.

Open topic with navigation