Links may not function; however, this content may be relevant to outdated versions of the product.
Skin form — Components tab — Layouts — Layout Groups
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.
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 Understanding accessibility 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:
Layout group formats
There are four style formats for layout groups:
- Accordion – Panes are selectable by dividers .
- Menu – Panes are selectable by a menu .
- Stacked – Panes are selectable by a stacked format .
- 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.
Each layout type can be styled independently in the skin, presenting a large number of display options.
A preview of the currently selected format displays to the right. You can also preview formats by selecting Run Process, Open Portal, Harness Preview, UI Gallery Preview, Skin Preview.in the toolbar and then choosing one of the following preview options:
Display Type: Tab, Accordion, Stacked, and Menu General options
Applies to the general styles for layout groups (rendered as a menu, accordion, or tabs).
|Default border|| Select Use mixin to apply the skin's standard active mixin. You can then
override individual border attributes. Select Specify styles to define all your own
border attributes independently of the mixin. |
The Mixin field displays the name and a preview of the currently selected mixin. Click the menu icon to select a different mixin from the list.
You can modify the following border style attributes:
|Default background|| Select Use mixin to apply the skin's standard active mixin. Select Specify
styles to define your own border attributes independently of the mixin. |
You can modify the following default background attributes:
|Minimum height||Specify the minimum height that the dynamic layout will display in the format you specified to ensure content is consistent when swiping on a touch device. Leave minimum height at 0 when a range is not desired.|
|Allow opening of multiple panes||Select this check box if you want to create a multi-expand accordion that allows you to open any number of panes.|
|Hide header on touch devices||Choose the Menu style format to select this check box if you want to hide the menu header on a mobile device when swiping content to navigate the layouts.|
|Hide expand icon on touch devices||Choose the Menu style format to select this check box if you want to hide the expand icon from displaying on a mobile device when swiping content to navigate the layouts.|
|Enable support for responsive breakpoints|
Select this check box if you want to add a responsive breakpoint to the layout group. When the screen size reaches the dimensions that you specify, the layout group format changes to the type you specify: Tab, Accordion, or Menu.
Display Type: Tab, Accordion, Stacked, and Menu Styling options
Applies to the layout-specific styles for the layout group panel. These options apply individually to the rendering of accordions, menus, and tabs.
|Height, Left Padding, Right Padding||Determines the position of the labels (tab name, accordion pane names, or menu names) in the layout group.|
|Collapse icon, Expand icon|
Applies only to accordions. Specify an image for collapsing a pane and for expanding the pane. Choose the horizontal position: Left, Right, Center. Set a width (gap) in pixels from the left, center, or right of the panel (according to position)
|Tab Panel Alignment|
Applies only to tabs. Specify the alignment of tabs within the layout group: Left, Right, Center. Also specify Inner Spacing: the spacing between the tabs. Also specify a Left Offset or Right Offset to determine the space between the first tab or last tab from the left or right side of the layout group.
|Image, Width, Horizontal position|
Applies only to menus. Specify a menu image. Choose the horizontal position: Left, Right, Center. Set a width (gap) in pixels from the menu label (according to position)
|Enable rounded corners only for first and last tabs||Applies only to tabs. Restrict rounded corners to the first and last tab only.|
|Tab Panel Background|
Applies only to tabs. Select to use the default background you specified for the layout group (in General settings) or specify a tab panel-specific background using the current mixin or by specifying styles. See Skin form — Components tab — Layouts — Layout Groups for a description of options.
This is applicable to the whole panel, not the tabs themselves.
|Tab Panel Border|
Applies only to tabs. Select to use the default border you specified for the layout group (in General settings) or specify a tab panel-specific border using the current mixin or by specifying styles. See Default border for a description of options.
This is applicable to the whole panel, not the tabs themselves.
|Typography|| For all tab states or individually for the Active Text, Inactive Text, and
Hover Text, choose from the following: |
|Borders|| For all tab states or individually for the Active Border, Inactive Border, and
Hover Border, choose from the following: |
|Backgrounds|| For all tab states or individually for the Active Background, Inactive
Background, and Hover Background, choose from the following: |
|Padding||Determines the position of the text in the layout group. Choose the same padding on all sides or specify the top, right, bottom, and left padding in pixels.|
Content: Accordion, Stacked, Tabs, and Menu
Applies to the layout-specific styles for the text content inside the layout group panel. These options apply individually to the rendering of accordions, menus, and tabs.
Layout group states
Use the options in this section to style the control based on its state. You can style the control differently when it is in one of the following states:
- :hover – State of the control when a user points to the control or rests the pointer on the control.
- :focus – State of the control when the field is in focus, for example, the state of a text field when it is ready to accept inputs.
- :active – State of the control when the field is ready to be activated, for example, when a user has clicked the control but has not yet released the mouse button.
- Auto – Select this option to apply auto-generated styles for the control in this state. These styles are generated based on the applied control format and the mixins defined within the format.
- Default – Select this option to apply the default browser styles for the states instead of generating the styles based on a skin or defined CSS in the application.
- Custom – Select this option to define your own styles for the element in this state.
- Creating a custom layout group format
You can create a new custom format or copy an existing one.
- Layout Groups
Use layout groups to modularize closely related information so that you can optimize screen area and still provide all the information that you want to make available in the application at run time.
Previous topic Creating a custom dynamic layout format Next topic Creating a custom layout group format