GridContainer component

Level: beginner

GridContainer is a component that lets you lay out its children elements within a grid. The elements may have variable size depending on their content. Built on top of CSS Grid Layout.

Learn more about Grid Layout in the following article: Basic Concepts of grid layout.

Properties

@Input rows, columns

Defines the track size of the layout grid.

Available values

Constant

The track size must be integer.

View the example for the columns and rows properties below.

Example settings for the columns and rows properties

{
    ...
    "columns": [
        "298px",
        "minmax(64px, 1fr)"
    ],
    "rows": "minmax(max-content, 32px)",
    ...
}

GridContainer does not support the following CSS Grid Layout features:

• The grid-line-name property. Required for named grid lines.
• The fit-content() function. Limits the size of a track. The function is the a min(max-content, max(auto, argument)) formula calculated as the auto property (i. e., minmax(auto, max-content)). The track size is capped at the argument value as long as that value is larger than the minimum value of auto. In Creatio, the browser renders a single 32px-wide column regardless of the argument in the fit-content() function.
• The repeat() function. Introduces a repeated fragment of a track list for compact representation of a recurring pattern.

@Input justifyItems

Space distribution along the main axis. Defines how the browser distributes space between and around elements relative to the horizontal axis of the grid container.

Available values

start	Pack the elements inside the block on the left.
end	Pack the elements inside the block on the right.
center	Pack the elements inside the block around the center.
stretch	Pack the elements inside the block evenly from left to right.

View the example settings for the justify-items property below.

Example settings for the justify-items property

.container {
    justify-items: start | end | center | stretch;
}

@Input alignItems

Space distribution along the cross axis. Pack the elements inside the block vertically.

Available values

start	Pack the elements inside the block from top.
end	Pack the elements inside the block at the bottom.
center	Pack the elements inside the block around the center.
stretch	Pack the elements inside the block evenly from top to bottom.

View the example settings for the align-items property below.

Example settings for the align-items property

.container {
    align-items: start | end | center | stretch;
}

@Input gap

Defines the track spacing between the elements in the grid container. This is a shorthand for the row-gap (vertical gap) and column-gap (horizontal gap) properties.

View the resulting settings for row-gap and column-gap below.

Resulting settings for row-gap and column-gap

.container {
    grid-template-columns: 100px auto;
    grid-template-rows: 80px 60px;
    column-gap: 40px;
    row-gap: 20px;
}

View the resulting layout in the figure below.

@Input padding

Defines the container padding settings. This setting can apply a single value to all sides or provide a specific value for each side. The property can accept numbers, strings, and the available values listed below.

Available values

none	Zero padding.
small	Small padding.
medium	Medium padding.
large	Large padding.

View the example settings for the padding property below.

Example settings for the padding property

"padding": {
    "top": "6px",
    "right": 6,
    "bottom": "small",
    "left": "large"
}

@Input border-radius

Defines the corner rounding in the container. This setting can apply a single value to all sides or provide a specific value for each side. The property can accept numbers, strings, and the available values listed below.

Available values

none	No rounding.
small	Small corner radius.
medium	Medium corner radius.
large	Large corner radius.

View the example settings for the border-radius property below.

Example settings for the border-radius property

"borderRadius": "medium"

@Input color

Defines the container color. This setting accepts a color code.

View the example settings for the color property below.

Example settings for the color property

"color": "#FDAB06"

LayoutConfig: layoutConfig

Configures width and height of grid container, in pixels.

Parameters

minWidth	Minimum width.
maxWidth	Maximum width.
width	Strictly defined width.
height	Strictly defined height.

View the example settings for the layoutConfig property below.

Example settings for the layoutConfig property

"layoutConfig": {
    "minWidth": 368,
    "maxWidth": 368
}

Use example

An example of using the GridContainer component in the diagram is available below.

Example of using the GridContainer component in the diagram

"name": "GridContainer",
"values": {
    "layoutConfig": {
        "minWidth": 368,
        "maxWidth": 368
    },
    "type": "crt.GridContainer",
    "columns": [
        "minmax(32px, 1fr)",
        "minmax(32px, 1fr)",
        "minmax(32px, 1fr)",
        "minmax(32px, 1fr)"
    ],
    "rows": "minmax(max-content, 32px)",
    "gap": {
        "columnGap": "large"
    },
    "items": []
}
...
{
    "operation": "insert",
    "name": "Button",
    "values": {
        "layoutConfig": {
            "column": 1,
            "row": 1,
            "colSpan": 3,
            "rowSpan": 1
        },
        "type": "crt.Button",
        "caption": "#ResourceString(Button_caption)#",
        "color": "default",
    },
    "parentName": "GridContainer",
    "propertyName": "Items",
    "index": 0
}