Skip to main content

adjust

defines whether the width of columns is automatically adjusted to the width of their content

adjust?: "header" | "footer" | "data" | boolean;
Default value: false

Example

var treegrid = new dhx.TreeGrid("treegrid_container", {
columns: [
// columns config
],
adjust: true,
data: dataset
});

Related sample: TreeGrid. Adjust columns by header, data, all

The property can be specified to one of the available adjustment modes:

"header"adjusts the columns to the width of their header
"footer"adjusts the columns to the width of their footer
"data"adjusts the columns to the width of their content
truecombines the above mentioned modes and adjusts the column to the bigger value

The adjust property has a priority over the autoWidth property if it is specified either for a grid or for its column, and over the width property of the column.

The width the columns will be adjusted to also depends on the values of the minWidth/maxWidth properties if they are set for a column.

Note, that:

  • to optimize performance, you should specify htmlEnable: true in the configuration object of the column which contains HTML content;
  • you can also specify htmlEnable:true in the configuration object of TreeGrid;
  • htmlEnable: true allows calculating the content of simple HTML templates by excluding HTML markup and calculating internal content;
  • the adjust option enabled (including the "header", "footer", "data" modes) adjusts the width of columns with account of template added to cells. You need to set the content attribute of the header/footer properties to one of the following modes: "avg" | "sum" | "max" | "min" | "count", otherwise text will be calculated.

Change log:

added in v6.4