ASP.NET Core CheckBoxGroup Overview

The Telerik UI CheckBoxGroup TagHelper and HtmlHelper for ASP.NET Core are server-side wrappers for the Kendo UI CheckBoxGroup widget.

The CheckBoxGroup allows to style and provide checkbox functionality to list elements, set the position of the labels, attributes and custom css classes.

• Demo page for the CheckBoxGroup

Initializing the CheckBoxGroup

The following example demonstrates how to define the CheckBoxGroup.

Razor

    @(Html.Kendo().CheckBoxGroup()
        .Name("checkboxgroup")
    )

Razor

     <kendo-checkboxgroup name="checkboxgroup"
            input-name="checkboxItem">
    </kendo-checkboxgroup>

Basic Configuration

The following example demonstrates the basic configuration for the CheckBoxGroup.

Razor

    @(Html.Kendo().CheckBoxGroup()
        .Name("checkboxgroup")
        .Items(i =>
        {
            i.Add().Label("Spain").Value("1");
            i.Add().Label("Italy").Value("2");
            i.Add().Label("UK").Value("3");
        })
        .Value(new string[] { "1" })
    )
    <script>
    $(function() {
        // The Name() of the CheckBoxGroup is used to get its client-side instance.
        var checkboxgroup = $("#checkboxgroup").data("kendoCheckBoxGroup");
    });
    </script>

Razor

    @{
        var data = new string[]{ "1" };
    }
    <kendo-checkboxgroup name="checkboxgroup"
                        value="data" >
        <kendo-checkboxgroup-items>
            <kendo-checkboxgroup-item value="1" label="Spain"></kendo-checkboxgroup-item>
            <kendo-checkboxgroup-item value="2" label="Italy"></kendo-checkboxgroup-item>
            <kendo-checkboxgroup-item value="3" label="UK"></kendo-checkboxgroup-item>
        </kendo-checkboxgroup-items>
    </kendo-checkboxgroup>

Functionality and Features

• Binding—You can bind the CheckBoxGroup's items by using its Items configuration method or the BindTo method to bind to a view model.
• Label—The CheckBoxGroup allows you to customize the text and appearance of its labels.
• Layout—The CheckBoxGroup supports two types of layout - horizontal and vertical.

Next Steps

• Getting Started with the CheckBoxGroup
• Basic Usage of the CheckBoxGroup HtmlHelper for ASP.NET Core (Demo)

See Also

• Using the API of the CheckBoxGroup HtmlHelper for ASP.NET Core (Demo)

• Client-Side API of the CheckBoxGroup

• CheckBoxGroup in Razor Pages

• Server-Side API

• Knowledge Base Section