# ASP.NET Core ButtonGroup Overview

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

The ButtonGroup renders a series of buttons together on a single line.

* [Demo page for the ButtonGroup](https://demos.telerik.com/aspnet-core/buttongroup/index)

## Initializing the ButtonGroup

The following example demonstrates how to initialize the ButtonGroup.

```Razor HtmlHelper
        @(Html.Kendo().ButtonGroup()
                .Name("select-period")
                .Items(t =>
                {
                        t.Add().Text("Month");
                        t.Add().Text("Quarter");
                        t.Add().Text("Year");
                }))
```

```Razor TagHelper
<kendo-buttongroup name="select-period">
        <buttongroup-items>
            <item text="Month"></item>
            <item text="Quarter"></item>
            <item text="Year"></item>
        </buttongroup-items>
    </kendo-buttongroup>
```

## Referencing the ButtonGroup Instance

After the ButtonGroup is initialized, you can retrieve its client-side instance with the `getKendoButtonGroup()` jQuery getter or the equivalent `data("kendoButtonGroup")` method:

```JS script
        <script>
                var buttonGroupReference = $("#select-period").getKendoButtonGroup();
                buttonGroupReference.enable(false);
        </script>
```

The `getKendoButtonGroup()` method is a client-side jQuery getter. It is separate from the server-side `Html.Kendo().ButtonGroup()` configuration.

## Functionality and Features

* [Disabled ButtonGroup](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/navigation/buttongroup/disabled-state)—The `Enable()` method allows you to render the ButtonGroup as disabled until certain requirements are met.
* [Icon ButtonGroup](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/navigation/buttongroup/icons)—To visually enhance the content of the buttons, you can use the `Icon()` method and add icons.
* [Index](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/navigation/buttongroup/indexes)—Using the `Index()` property allows you to configure the initially selected index of the ButtonGroup component.
* [Selection](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/navigation/buttongroup/selection)—You can control the number of buttons that the user can select in each ButtonGroup.
* [Events](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/navigation/buttongroup/events)—You can handle the ButtonGroup events and implement custom functionalities.

> tip To learn more about the appearance, anatomy, and accessibility of the ButtonGroup, visit the [Progress Design System documentation](https://www.telerik.com/design-system/docs/components/buttongroup/)—an information portal offering rich component usage guidelines, descriptions of the available style variables, and globalization support details.

## Next Steps

* [Getting Started with the ButtonGroup](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/navigation/buttongroup/getting-started)

* [Basic Usage of the ButtonGroup HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/buttongroup/index)

* [ButtonGroup in Razor Pages](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/navigation/buttongroup/razor-page)

## See Also

* [Using the API of the ButtonGroup for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/buttongroup/api)
* [Knowledge Base Section](https://www.telerik.com/aspnet-core-ui/documentation/knowledge-base)
