Skip to main content
Matrix42 Self-Service Help Center

Container Controls

Overview

On this page, you may find a list of container controls and their configuration in the Layout Designer.

Dialog Container

Dialog Container is configured in a Layout to serve as a container for another layout on the page, for instance, when a specific property is chosen on the main layout and it might need some additional properties configuration that is not displayed until this option is selected and thus a layout can show an additional dialog in it.

Dialog Container can be used on the following layout types:

  • Dialog
  • Wizard

Instead of Dialog Container, use the Composite Control Descriptor to configure the same behavior with more advanced options and simpler configuration.

Properties and Settings

For an example of Dialog Container configuration, open the Service Dialog in the Layout Designer. Service Dialog is used in the Service Catalog application → Service Catalog navigation item → Services → Provisioning view or in the Shopping Cart wizard for the Self Service Portal.

Property Group Property Name Description Default Property Setting Example

Appearance

Hide Message Panel

This property allows preventing showing warning or error message duplicates:

  • selected: all messages of the layout and dialog container are displayed in a single message panel
    dialog_container_message_panel_hide1.png
  • disabled: message panel for the layout and for the container is displayed as well and message duplicates can occur
    dialog_container_message_panel1.png
Selected hide_message_panel.png
Content Widget ID

Defines the ID of the Dialog that should be displayed on the Layout:

Choose a source from one of the configurable options:

  • Model: select the source from the data model;
  • Static Value: specify the ID to display.
dialog_container_content_widget_id.png
Single View

If a Dialog has several views, with this option being enabled only the first view of the dialog is shown in the Dialog Container. 

  • Disabled: all available views of the dialog container are shown on the layout
    dialog_container_views1.png
  • Selected: the layout renders only the first view of the dialog container
    dialog_container_single_view1.png
Disabled dilog_container_single_view.png
Available Views

This option allows showing only specified views on the layout. Choose a source from one of the configurable options:

  • Model: select the source of the data model;
  • Static Value: specify the views to display. Enter the technical name of the View that should be displayed.

Note that while configuring this option, the Single View property should be disabled.

 
Visibility

Container display on the page modes:

  1. Static value: check-box options
    • selected (True): container displaying on the page layout template is enabled; 
    • disabled (False): the container is not shown on the page layout template.
  2. Model:
    • assigned model: select the source of the data model;
True dialog_container_visibility.png
Margin

Margin clears an area outside the border. Set the control's margin in CSS format, for instance:

  • 10px
  • 1rem
  • 1rem 2rem (for top-bottom, right-left)
  • 1px 2px 3px 4px (defines top, right, bottom, left)
dialog_container_margin.png
Padding

Padding clears an area around the content. Set the control's padding in CSS format, for instance:

  • 10px
  • 1rem
  • 1rem 2rem (for top-bottom, right-left)
  • 1px 2px 3px 4px (defines top, right, bottom, left)
dialog_container_padding.png
Flex option

obsolete

Fixed dialog_container_flex_option.png

Model

Entity Data
Is an output field of a string type, it's a model of the dialog saved as a string. Gets a value only when the Watch entity data option is enabled. dialog_container_entity_data.png
Entity Name
(mandatory) Entity type of the edited object. dialog_container_entity_name.png
Preset Fields
The property defines the pre-filled fields of the dialog container. dialog_container_preset_fields.png
Entity
Returns an object that can be edited in the Dialog Container dialog_container_entity.png
Object ID
(mandatory) ID of an object, handled by a dialog dialog_container_object_id.png

Common

Help

help icon and tooltip for information displaying as:

  • ❌  not set: help icon is not displayed;
  • static value: manually entered text displayed in a pop-up window; 
  • localizable:  plain text specified per each available in the system locale. Shows appropriate localized help message according to the currently selected by the user language profile settings;
  • model: displayed data is retrieved from a specified data model field.
 
Watch entity data

See Entity Data property of the Dialog Container.

Available options:

  • selected (default)
  • disabled
enabled dialog_container_watch_entity_data.png
Name
automatically generated name or identifier of the container.  auto-generated dialog_container_name.png

Device Visibility

Desktop

This property allows improving user experience by managing device visibility options. 

The application checks the user device's screen resolution and shows or hides the container based on the selected check-box options settings:

  • selected (default): the container is shown on the page
  • disabled: the container is not displayed
Enabled layout_container_device_visibility.png
Tablet
Enabled
Mobile
Enabled

Layout Container

Layout Container is a part of the Layout canvas which serves as a container for the Control Descriptors that are added from the Toolbox and has configurable style properties.

Layout Container can be used on the following layout types:

  • Dataset View
  • Dialog
  • Wizard
  • Preview
  • Base widget
  • Landing Page

To add a new Layout Container in the Layout Designer use the following options:

  1. Drag&drop the Control Descriptor from the Toolbox to a new area on the Canvas. The new control is added to the empty Layout Container.
  2. Another way is to click Add an icon on the Layout's canvas to add an empty Layout Container:

layout_container_add_new1.png

To configure the Layout Container properties, double-click on the container to select it:

layout_container_new2.png

Properties and Settings

Property Group Property Name Description Default Property setting example

Appearance

Container style

Allows defining additional custom CSS styles:

Container_style.png

It is not recommended to configure this option as in case of breaking changes in the Layout Container they may affect the container and cause conflicts in its display.

See also Style property.

container_style_example.png
Title

Define the title of the container via one of the following options:

  • Model: displayed data is retrieved from a specified data model field
  • Localizable: plain text specified per each available in the system locale. Shows appropriate localized message according to the currently selected by the user language profile settings;
  • Static value: manually entered text 

layout_container_title.png

Layout Container Title display example

layout_container_title_example.png
Icon
not supported -
Layout Direction

Defines the layout direction of the control descriptors added to the container. 

Available options:

  • Vertical (default): controls are aligned vertically
    align_vertical1.png
  • Horizontal: controls are placed horizontally
    align_horizontal1.png
Vertical layout_direction_example.png
Alignment in Layout Direction

Alignment of the controls in the container applied to elements according to the selected Layout Direction. Available options: 

  • Default: the same as the start option
  • Start
  • Center 
  • End
  • Justify
  • Spaced

 

Default alignment_in_layout_direction.png
Alignment in Perpendicular Direction

Alignment of the controls in the container applied to elements perpendicularly to the selected Layout Direction. Available options: 

  • Default: the same as the start option
  • Start
  • Center 
  • End
  • Stretch
Default alignment_in_perpendicular_direction.png
Mode

The display mode of the container. Available options: 

  • Default: the container is displayed as an integral part of the layout and is not outlined in a stand-alone panel. For instance, Appearance section:
    layout_container_mode_default1.png
  • Panel: each container is visually outlined on the layout canvas as a stand-alone panel. For instance:
    layout_container_panel_mode.png
  • Container: the same as a Default option or not set option.
Default mode.png
Style

Defines the additional style of the Layout Container. Possible options:

  • Model: choose the value from the data model attributes;
  • Static Value: choose a style from the suggested options with the style preview

layout_container_style_example.png

Style Static Value examples with the style preview

layout_container_style_ex.png
Vertical flex

This option defines how much the controls fill up the space of the container. Despite the title, the property is applied in the horizontal direction of the container.  Available options:

  • None 
  • Flex
  • Flex 5
  • Flex 10
  • Flex 15
  • Flex 20
  • Flex 25
  • Flex 30
  • Flex 33
  • Flex 40
  • Flex 45
  • Flex 50
  • Flex 66
  • Flex 75

Example:

flex_option.png

None flex_option_example.png
Apply Classes

Along with the Container Style and Style properties in the Layout Container configuration, this option can be also used as an alternative way to define additional CSS styles for the container.

Here you can specify the class(es) that have previously been added via Front-End Workspaces.

 
Visibility

Container display on the page modes:

  1. Static value: check-box options
    • selected (True): container displaying on the page layout template is enabled; 
    • disabled (False): the container is not shown on the page layout template.
  2. model:
    • assigned model: select the source of the data model;
True layout_container_visibility.png
Background Color

The background color of the container. Available options:

  • Model: choose the value from the data model attributes 
  • Theme colors: select a color from the suggested palette
  • Static value: use the color picker or set the hex value

The background color is applied to the container also based on the current Mode value, for instance:

  • Container with Default or Container mode has the background color displayed in the Appearance section as follows:
    background_color_default.png
  • Container with Panel mode has the same background color displayed in the Appearance section differently:
    background_color_panel.png
background_color_example.png
Hide if empty

Checkbox options:

  • Selected (default): the container will be hidden automatically if it's empty or if it contains empty hidden literals.
  • Disabled: even container without any data to display is shown on the layout.
True layout_container_hide_if_empty.png

Common

Help

help icon and tooltip for information displaying as:

  • ❌  not set: help icon is not displayed;
  • static value: manually entered text displayed in a pop-up window;
  • localizable:  plain text specified per each available in the system locale. Shows appropriate localized help message according to the currently selected by the user language profile settings;
  • model: displayed data is retrieved from a specified data model field.

layout_containre_help.png

Help icon with a tooltip displaying example

layout_container_help_example.png
Name
automatically generated name or identifier of the container auto-generated layout_container_name.png

Device Visibility

Desktop

This property allows improving user experience by managing device visibility options. 

The application checks the user device's screen resolution and shows or hides the container based on the selected check-box options settings:

  • selected (default): the container is shown on the page
  • disabled: the container is not displayed
Enabled layout_container_device_visibility.png
Tablet
Enabled
Mobile
Enabled

Tile Container

Tile Container defines the width and height of the container, for instance, Catalog Services Tiles layout in the Self Service Portal:

tile_container.png

Tile Container can be used on the following layout types:

  • Dataset View

Properties and Settings

Property Group Property Name Description Property Setting Example

Appearance

Min Width

Allows defining the minimum width of the container. Set the numeric value and choose the unit of measurement from the list:

  • px
  • %
  • em
  • rem
min_width_example.png

Common 

Min Height

Allows defining the minimum height of the container. Set the numeric value and choose the unit of measurement from the list:

  • px
  • %
  • em
  • rem
min_height_example.png
Name
automatically generated name or identifier of the container tile_name_example.png
  • Was this article helpful?