# Gridlist

**Category:** Field

**Version:** 1.0

**Last Updated:** October 31, 2025

**Author:** Any2Info

### Description <a href="#description" id="description"></a>

The gridlist field allows visualization of a dataset structured like a table. The field support several table related features like filtering, sorting and footers.&#x20;

Besides the functionality for usability the field allows various styling related features regarding look and feel and line styling.&#x20;

Generally speaking, this control is used to either display a table or allow users to make selections for non-singular data entries (i.e. order lines or product details).&#x20;

### Events <a href="#general-properties" id="general-properties"></a>

The Tooltip only has 1 property, which is the text that is to be displayed. If this is empty then the tooltip will not be displayed at all.

<table data-header-hidden><thead><tr><th width="177"></th><th></th></tr></thead><tbody><tr><td>On data update </td><td>Triggers whenever the grid receives or updates its data as a result of an initial load or filter value </td></tr><tr><td>On value change </td><td>Triggers whenever a user selects an individual row. Take note that this will only be triggered when the selection mode is set to anything but none </td></tr></tbody></table>

### Content <a href="#changelog" id="changelog"></a>

Using the datasource property under Properties > Grid data the values to display in the grid can be configured&#x20;

For additional configuration regarding data formatting or styling see “Advanced configuration”&#x20;

### Advanced configuration

Advanced configuration configuration of the mapped columns can be done using the overview fields property under Properties > Grid data.

<table data-header-hidden><thead><tr><th width="170">Aspect</th><th></th></tr></thead><tbody><tr><td>Header text </td><td>Allows setting the specific text displayed for the column, by default this will use the column name </td></tr><tr><td>Weight </td><td><p>Sets the weight of the column in regards to the horizontal width each column will fill in the grid. </p><p> </p><p>Using a weight of 0 will make the column invisible, which can be useful when value is used but doesn’t need to be shown </p></td></tr><tr><td>Format </td><td><p>Depending on the underlying type values in the cell can be formatted at will. </p><p> </p><p>Numerical values can have their decimal count set by using {#}. For example  €{2} would result in  €4.50 for the value 4.5. </p><p> </p><p>Date(time) values use the ISO8601 tags for format dates. </p></td></tr><tr><td>Footer  </td><td><p>Each column or column group allows setting a footer type.  </p><p> </p><p>Textual footers allow setting a text for the footer cell. </p><p> </p><p>For numerical columns additional footer types will be shown to allow mathematical operations of the shown values in the column (i.e. Sum, Min and Max). </p></td></tr><tr><td>Styling </td><td><p>Using the styling override flag an individual cell can be styled separately from the defined styling of the field. </p><p> </p><p>Additionally using this flag you can enable data driven cell background coloring </p></td></tr></tbody></table>

### Changelog <a href="#changelog" id="changelog"></a>

| Version | Date             | Change                               |
| ------- | ---------------- | ------------------------------------ |
| 1.0     | October 31, 2025 | Initial documentation version added. |
