Grid Column Resizing

With deferred grid column resizing, the user will see a temporary resize indicator while the Angular drag resizing operation is in effect. The new grid column width is applied once the drag operation has ended.

Grid Column Resizing Demo


Column resizing is also enabled per-column level, meaning that the igx-grid can have a mix of resizable and non-resizable columns. This is done via the resizable input of the igx-column.

<igx-column [field]="'ID'" width="100px" [resizable]="true"></igx-column>

You can subscribe to the onColumnResized event of the igx-grid to implement some custom logic when a column is resized. Both, previous and new column widths, as well as the IgxColumnComponent object, are exposed through the event arguments.

<igx-grid [data]="data" (onColumnResized)="onResize($event)" [autoGenerate]="false">
    <igx-column [field]="'ID'" width="100px" [resizable]="true"></igx-column>
    <igx-column [field]="'CompanyName'" width="100px" [resizable]="true"></igx-column>
</igx-grid>
public onResize(event) {
    this.col = event.column;
    this.pWidth = event.prevWidth;
    this.nWidth = event.newWidth;
}

Restrict column resizing

You can also configure the minimum and maximum allowable column widths. This is done via the minWidth and maxWidth inputs of the igx-column. In this case the resize indicator drag operation is restricted to notify the user that the column cannot be resized outside the boundaries defined by minWidth and maxWidth.

<igx-column [field]="'ID'" width="100px" [resizable]="true"
            [minWidth]="'60px'" [maxWidth]="'230px'"></igx-column>

Auto-size columns on double click

Each column can be auto sized by double clicking the right side of the header - the column will be sized to the longest currently visible cell value, including the header itself. This behavior is enabled by default, no additional configuration is needed. However, the column will not be auto-sized in case maxWidth is set on that column and the new width exceeds that maxWidth value. In this case the column will be sized according to preset maxWidth value.

You can also auto-size a column dynamically using the exposed autosize() method on IgxColumnComponent.

@ViewChild('grid') grid: IgxGridComponent;

let column = this.grid.columnList.filter(c => c.field === 'ID')[0];
column.autosize();

Pinned columns resizing

Pinned columns can also be resized. However, resizing is limited so that the overall width of the pinned columns container cannot become larger than 80% of the overall Grid width. Again, if you try to autosize a pinned column and the new width will cause the pinned columns container to exceed those 80% of the overall Grid width, auto sizing will be discarded. We just want to make sure that the unpinned columns are always visible and available to the user!

Styling

To get started with the styling of the Grid column resize line, we need to import the index file, where all the theme functions and component mixins live:

// grid-resize-line-styling-sample.scss
@import '~igniteui-angular/lib/core/styles/themes/index';

The simplest approach to achieve this is to create a new theme that extends the igx-grid-theme and accepts many parameters as well as the $resize-line-color parameter.

$custom-grid-theme: igx-grid-theme(
    $resize-line-color: #0288D1
);
Note

If the component is using an Emulated ViewEncapsulation, it is necessary to penetrate this encapsulation using ::ng-deep.

:host {
    ::ng-deep {
        @include igx-grid($custom-grid-theme);
    }
}

Defining a color palette

Instead of hard-coding the color values, we can achieve greater flexibility in terms of colors by using the igx-palette and igx-color functions.

igx-palette generates a color palette based on the specified primary and secondary color:

$primary-color: #0288D1;
$secondary-color: #BDBDBD;

$custom-theme-palette: igx-palette($primary: $primary-color, $secondary: $secondary-color);

And then, with igx-color, we can easily retrieve the color from the palette.

$custom-grid-theme: igx-grid-theme(
    $palette: $custom-theme-palette,
    $resize-line-color: igx-color($custom-theme-palette, 'secondary', 500)
);
Note

The igx-color and igx-palette are powerful functions for generating and retrieving colors. Please, refer to Palettes topic for detailed guidance on how to use them.

Using Schemas

Going further with the theming engine, you can build a robust and flexible structure that benefits from schemas. A schema is a recipe of a theme.

Extend the predefined schema provided for every component, in this case - light-grid schema:

// Extending the light grid schema
$light-grid-schema: extend($_light-grid,
    (
        resize-line-color: (
            igx-color: ('secondary', 500)
            ),
        header-background: (
            igx-color: ("primary", 100)
            ),
        header-text-color: (
            igx-color: ("primary", 600)
            )
    )
);

In order to apply our custom schema, we have to extend one of the globals (light or dark), which is basically pointing out the components with a custom schema, and after that add it to the respective component theme:

// Extending the global light-schema
$custom-light-grid-schema: extend($light-schema,(
    igx-grid: $light-grid-schema
));

// Specifying the palette and schema of the custom grid theme
$custom-grid-theme: igx-grid-theme(
    $palette: $custom-theme-palette,
    $schema: $custom-light-grid-schema
);

Don't forget to include the theme in the same way as it was demonstrated above.

Demo

API References

Additional Resources

Our community is active and always welcoming to new ideas.