Free cookie consent management tool by TermsFeed

Editable Grid Column Configuration Component

SAIL Design System guidance available for Grids

Grids should help your users take action and make decisions. Check out the grids design guidance page to learn how to display your data in a structured, easy-to-scan layout to help your users find what they need.

Function

a!gridLayoutColumnConfig( width, weight, showWhen )

Defines a column configuration for use in an Editable Grid.

Parameters

Name Keyword Types Description

Width

width

Text

Determines the column width. Valid values: "DISTRIBUTE" (default), "ICON", "ICON_PLUS", "NARROW", "NARROW_PLUS", "MEDIUM", "MEDIUM_PLUS", "WIDE".

Weight

weight

Number (Integer)

Determines how wide distributed columns are in relation to each other. Valid values: integers from 1 (default) to 10.

Visibility

showWhen

Boolean

Determines whether the column configuration is displayed in the grid. When set to false, the column configuration is hidden and is not evaluated. Default: true.

Usage considerations

Using the editable grid's columnConfigurations parameter

  • The number of column configurations need not match the number of columns in the grid. They are matched with the columns by their position in the columnConfigurations array.

Using the width parameter

  • Even if width is set to a fixed width, the column will be at least as wide as the longest word in the column. For example, if you set the column's width to ICON_PLUS but the column contains a longer word like "operations," the column will be wide enough to accommodate the longer word.
  • ICON and NARROW do not have a minimum width. This means the column will shrink to fit the longest word in the column.
  • When the total width of your fixed width columns is not wide enough to fill the horizontal space of the grid, the columns will expand proportionally to fill the space.

Examples

Click EXPRESSION to copy and paste an example into the Interface Definition to see it displayed.

Narrow grid column

This example needs to be used with the a!gridLayout() function for it to display anything. Examples that you can see in action are available in the Grid Layout component section.

1
2
3
a!gridLayoutColumnConfig(
  width: "ICON"
)

Feature compatibility

The table below lists this component's compatibility with various features in Appian.
Feature Compatibility Note
Portals Compatible
Offline Mobile Compatible
Sync-Time Custom Record Fields Incompatible
Real-Time Custom Record Fields Incompatible

Custom record fields that evaluate in real time must be configured using one or more Custom Field functions.

Process Reports Incompatible

Cannot be used to configure a process report.

Process Events Incompatible

Cannot be used to configure a process event node, such as a start event or timer event.

The following patterns include usage of the Editable Grid Column Configuration Component.

Feedback