igx-ButtonGroup

November 19, 2025 ยท View on GitHub

The igx-ButtonGroup component aims at providing a button group functionality to developers that also allow horizontal/vertical alignment, single/multiple selection with toggling. The igx-ButtounGroup component makes use of the igxButton directive. A walkthrough of how to get started can be found here

Usage

<igx-buttongroup [.. options]>
</igx-buttongroup>

API Summary

NameTypeDescription
idstringUnique identifier of the component. If not provided it will be automatically generated.
multiSelectionbooleanEnables selecting multiple buttons. Value by default is false.
alignmentenumSet the button group alignment. Available enum members are ButtonGroupAlignment.horizontal (default) or ButtonGroupAlignment.vertical.
disabledbooleanDisables the igxButtounGroup component. False by default.

API Methods

NameDescription
selectButton(index: number)Selects a button by its index.
deselectButton(index: number)Deselects a button by its index.
selectedButtons()Gets the selected button/buttons.

Events

NameDescription
onSelectFired when a button is selected.
onUnselectFired when a button is unselected.
onClickFired when a button is clicked.

Examples

Using igx-ButtonGroup to organize buttons into an Angular styled button group.

    <igx-buttongroup multiSelection="false" [values]="buttons" [alignment]="alignment">
    </igx-buttongroup>