Stacked Display Mode

The Grid component in ASP.NET MVC supports a Stacked Layout mode that arranges multiple columns in a compact, card-like format. This layout is especially useful where horizontal space is limited (for example, on smaller screens) or when you want to present complex row content in a visually stacked arrangement.

When the Stacked Layout is enabled, the Grid displays its cells in a fixed-width grid arrangement, defined by a set of column widths.

Enabling Stacked Layout

To activate the stacked layout mode:

1. Set the DataLayoutMode() option to DataLayoutMode.Stacked.
2. Configure the column widths through the StackedLayoutSettings() method by providing an array of values representing the widths of each stacked column.

Razor

@(Html.Kendo().Grid<MyViewModel>()
    .Name("grid")
    .DataLayoutMode(DataLayoutMode.Stacked)
    .StackedLayoutSettings(s => s.Cols(320, 120, 120))
    // Grid configuration...
)

In this example:

• The first stacked column has a width of 320px.
• The second stacked column has a width of 120px.
• The third stacked column has a width of 120px.

Stacked Layout Settings

The StackedLayoutSettings configuration defines how cells are arranged in stacked columns.

Setting	Description
.Cols(params int[] widths)	Defines the number and width of stacked columns in pixels.
cols-array (TagHelper)	Accepts an array of values representing the widths of stacked columns.

Example

The example below demonstrates a Grid in Stacked Layout mode with template columns and widgets.

Razor

@(Html.Kendo().Grid<ProductViewModel>()
    .Name("grid")
    .DataLayoutMode(DataLayoutMode.Stacked)
    .StackedLayoutSettings(s => s.Cols(320, 120, 120))
    .Columns(columns =>
    {
        columns.Bound(p => p.ProductName)
            .ClientTemplate(
                @"<div class='product-photo' style='background-image: url(" + Url.Content("~/images/#:data.ProductID#.jpg") + ");'></div>
                  <div class='product-name'>#: ProductName #</div>");
        columns.Bound(p => p.UnitPrice).Title("Price");
        columns.Bound(p => p.Discontinued).Title("In Stock")
            .ClientTemplate("<span class='badgeTemplate'></span>");
    })
    .Pageable()
    .Sortable()
    .Filterable()
    .AdaptiveMode(AdaptiveMode.Auto)
    .DataSource(ds => ds
        .Ajax()
        .Read("Read", "Grid")
    )
)

Best Practices

• Balance widths — Ensure the total width suits your target screen sizes.
• Compact templates — Rows can become taller; keep item templates concise.
• Use with Adaptive Mode — Combine with AdaptiveMode.Auto for better small-screen UX.
• Test with real data — Verify widgets (badges, progress bars, etc.) render correctly in the allotted widths.

See Also

• Grid Stacked Display Mode (Demo)
• Server-Side API of the Grid