FlexContainer

Use a FlexContainer widget to create a layout area on a form that can contain other widgets. If you want the layout area to include scroll bars, use a FlexScrollContainer widget. For more information, see Convert Flex Container Widgets.

To learn how to use this widget programmatically, refer Quantum Visualizer Widget guide.

Look Properties

Look properties define the appearance of the widget. The following are the major properties you can set:

For descriptions of the properties available on the Look tab of the Properties pane, see Look.

Auto Growth of a FlexContainer Widget

You can specify that a FlexContainer widget dynamically adjusts its height based on the height of its child widgets by setting the Height property on the Look tab to Preferred. The height of the FlexContainer then adjusts when the height of any child widgets changes.

Following are important considerations for a FlexContainer that is set to adjust dynamically:

The following table summarizes how to calculate the height of child widgets:

Height Center Y Top Bottom Child Height
Yes Yes Yes Yes centerY + height/2 + bottom
Yes Yes No Yes centerY + height/2 + bottom
Yes Yes Yes No centerY+ height/2
Yes Yes No No centerY+ height/2
No Yes Yes Yes (centerY – top) * 2 + top + bottom
No Yes Yes No (centerY – top) * 2 + top
No Yes No Yes centerY + bottom + cph/2
No Yes No No centerY + CPH/2
Yes No Yes Yes top + height + bottom
No No Yes Yes top + CPH + bottom
Yes No Yes No top + height
No No Yes No top + CPH
Yes No No Yes height + bottom
No No No Yes cph + bottom
Yes No No No height
No No No No CPH

Note: The Computed Preferred Height (CPH) is determined by the calculated height for the content-driven widget, the default value returned from the configuration file, and the calculated height of the Auto Grow Segment or FlexContainer.

Limitations:

Skin Properties

Skin properties define a skin for the widget, including background color, borders, and shadows. If the widget includes text, you can also specify the text font.

For a FlexContainer widget, you can apply a skin and its associated properties for the following states:

Skin Definition
Normal The default skin of the widget.
Focus The skin applied when the widget has the focus.
Blocked UI

The skin applied to block the interface until the action in progress (for example, a service call) completes.

Note: Blocked UI is available only for SPA platforms.

For more information about applying skins, see Understanding Skins and Themes.

FlexContainer Properties

FlexContainer properties specify properties that are available on any platform supported by Quantum Visualizer, and assign platform-specific properties.

Clip Bounds

Specifies whether to clip child widgets when they go out of boundaries.

Layout Type

Specifies whether the arrangement of widgets in the FlexContainer flows horizontally, vertically, or in both directions.

Default: Vertical

Child Widget Align

Specifies whether the arrangement of widgets in the child widget of the FlexContainer flows horizontally, vertically, or in both directions.

Default: Right to Left.

Visualizer generates reverseLayoutDirection property with true for Right to Left and Bottom to Top. Visualizer generates this property with false for Left to Right and Top to Bottom.

Snap to Grid

Specifies whether the widget aligns to the nearest intersection of lines in the grid, or other widgets.

Snap Grid Size

Specifies the grid size. This option is available only when Snap to Grid is enabled.

Default Unit

Specifies the default unit used for interpretation of numbers with no qualifiers when passed to layout properties.

Following are the options:

Swipe Config

From Quantum Visualizer V9 onwards, you can configure the swipe functionality for a Segment widget. The Swipe config settings enable users to dismiss a row or to reveal certain actions when they swipe a row to the left or right.

Note: The Swipe Config setting is applicable only on the Flex Container widget that is present inside a segment widget.

To enable the swipe left or swipe right functionality on the rows of a Segment, follow these steps:

  1. In Visualizer, from the Project explorer, navigate to a <channel> > Forms.
  2. Right-click Forms and then click New Form.
  3. Drag and drop a Segment widget onto the form, and then rename the Segment.
  4. On the Templates tab, go to Mobile > Segment.
  5. Right-click Segment, select New Template, and then rename the template as Temp1.
  6. On the Project Explorer, click the Segment widget.
  7. On the Properties panel, click the Segment tab. For Row Template, select Temp1.
  8. Go to the Templates Explorer, and then select the Flex Container under Temp1.
  9. On the Properties panel, click the FlexContainer tab. The Swipe Config section appears.
  10. Under the Swipe Config section, select On for Enable Swipe. The Enable Swipe Left and Enable Swipe Right settings appear.

  11. To enable a swipe left or swipe right functionality, select On for Enable Swipe Left or Enable Swipe Right respectively. After the selection, right/left FlexContainers are added under the Swipe Container.
  12. Then, select the actions that the rows of a Segment must perform on swiping:
    • Swipe to Reveal: Enables you to display the left or right swipe container when you swipe a row to the left or right. The right FlexContainer is visible when you swipe the row to the left and vice-versa.
    • Swipe to Dismiss: Enables you to perform an action on a row when you swipe the row to the left or right.
  13. From the Templates Explorer, select the FlexContainer under the Temp1 template.
    If you select Swipe to Dismiss, the onSwipeLeft or onSwipeRight actions are available and can be configured under the Action tab of the Properties panel.

    Note: If you have not used a row template but dragged the widgets directly onto the Segment, the onSwipeLeftor onSwipeRight properties are available on the Action tab of the Segment.

  14. Click Edit beside the onSwipeLeft or onSwipeRight action. In the Action Editor, add the actions that the row must perform on swiping to left or right.
  15. To edit the Swipe Config settings, go to the Properties panel, and then click the Segment tab. Under General settings, click Edit beside the Swipe Config option.

The swipe functionality can be configured to a row of a segment through code by using the widgetSwipeMove property.

Note: On Android and SPA/Desktop Web platforms, if you reset the data of a Segment widget, make sure that you include entries for the widgets that are inside the swipe container. Otherwise, the widgets are not rendered at the run time.

Actions

Actions define what happens when an event occurs. On a FlexContainer widget, you can run an action when the following events occur:

For more information, see Add Actions.

 

 

 

 

 

Rev Author Edits
V8 SP2 PG PG
8 SHS SHS
7.2.1 SHS SHS
Copyright © 2020 Temenos. All rights reserved.