Components / Grid / API / SpanColumnComponent / 
New to Kendo UI for Angular? Start a free 30-day trial

SpanColumnComponent

Represents a column which can be spanned over multiple data cells while the individual header and footer cells are retained (see example). Enables you to achieve more flexible layout while keeping the built-in UI element for sorting, filtering, and grouping. Wrap the columns that will be merged inside the <kendo-grid-span-column> tag.

<kendo-grid-span-column>
  <kendo-grid-column field="field1"></kendo-grid-column>
  <kendo-grid-column field="field2"></kendo-grid-column>
  <ng-template kendoGridCellTemplate let-dataItem>
    <h5>{{ dataItem.field1 }}</h5>
    <p>{{ dataItem.field2 }}</p>
  </ng-template>
</kendo-grid-span-column>

Selector

kendo-grid-span-column

Inputs

NameTypeDefaultDescription

autoSize

boolean

Indicates whether the column will be resized during initialization so that it fits its header and row content.

columnMenu

boolean

true

Specifies if the column menu will be shown for the column.

class

string | string[] | Set<string> | {[key: string]: any}

Sets the custom CSS classes to the column cells. Under the hood, to apply the property, the class option uses the NgClass directive. See example. To customize header and footer column cells, use the headerClass and footerClass inputs.

editable

boolean

false

Defines whether the edit template of the column will be rendered. To enable the editing functionality for a spanned column, set an edit template for it (see example).

filterClass

string | string[] | Set<string> | {[key: string]: any}

Sets the custom CSS classes to the filter row cell. Under the hood, to apply the property, the filterClass option uses the NgClass directive. See example.

filterStyle

{[key: string]: string}

Sets the custom styles for the filter row cell. Under the hood, to apply the property, the filterStyle option uses the NgStyle directive. See example.

hidden

boolean

false

Sets the visibility of the column (see example).

lockable

boolean

true

Specifies if the column can be locked or unlocked from the column menu or by reordering the columns.

locked

boolean

false

Toggles the locked (frozen) state of the columns (see example).

maxResizableWidth

number

The width (in pixels) above which the user is not able to resize the column by using the UI (see example). By default, the maximum width is not restricted. The autoFitColumn and autoFitColumns methods have higher priority.

media

string

Sets the condition that needs to be satisfied for a column to remain visible (see example). If you set the hidden property, the behavior of media is overridden.

Accepts the device identifiers that are available in Bootstrap 4 (see example):

minResizableWidth

number

10

The width (in pixels) below which the user is not able to resize the column by using the UI (see example). The autoFitColumn and autoFitColumns methods have higher priority.

reorderable

boolean

true

Indicates whether the column is reorderable.

resizable

boolean

true

Indicates whether the column is resizable.

stickable

boolean

true

Specifies if the column can be stuck or unstuck from the column menu.

sticky

boolean

false

Determines whether the column will be always visible when scrolling the Grid horizontally.

style

{[key: string]: string}

Sets the custom styles for the table cells (excluding the footer and header ones) of the column. Under the hood, to apply the property, the style option uses the NgStyle directive. See example.

tableCellsRole

string

"gridcell"

Allows setting the role attribute for the table cells (excluding the footer and header ones) of the column.

Fields

NameTypeDefaultDescription

orderIndex

number

0

The column index after reordering. The orderIndex is a read-only property. Setting this field does not affect column order.

In this article

Not finding the help you need?

Contact Support