Skip to content

Commit 0b93271

Browse files
authored
docs(SegmentedControl): Compare with ButtonGroup and TabStrip (#3700)
1 parent 3de9561 commit 0b93271

4 files changed

Lines changed: 20 additions & 1 deletion

File tree

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
#comparison-with-buttongroup-tabstrip
2+
3+
The ButtonGroup, SegmentedControl, and TabStrip are similar and even inter-changeable in some aspects. The major differences between these components are:
4+
5+
* The [ButtonGroup](slug:buttongroup-overview) supports single and multiple selection. The SegmentedControl and TabStrip can only have one selected (active) item.
6+
* The [SegmentedControl](slug:segmentedcontrol-overview) is a databound component. The ButtonGroup and TabStrip use declarative items as child components.
7+
* The [TabStrip](slug:components/tabstrip/overview) renders content containers and manages their visibility out-of-the-box. The ButtonGroup and SegmentedControl can also integrate with separate content containers, but this must rely on the component events and a custom implementation.
8+
9+
#end

components/buttongroup/overview.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,9 @@ The ButtonGroup component is a container for [regular and toggle buttons](slug:b
1616

1717
The ButtonGroup component lets you [select one or more toggle buttons](slug:buttongroup-selection), and respond to the [selection and click events](slug:buttongroup-events). The buttons inside fill up the container, match the styling according to the [chosen theme](slug:themes-overview) and provide the regular button features like images and icons and the other parameters and attributes.
1818

19-
>tip Compared to the SegmentedControl, the ButtonGroup is a markup-based component — you declare each button explicitly as a child component and can configure the component for single or multiple selection. The [SegmentedControl](slug:segmentedcontrol-overview) is a data-bound component — it renders items from a `Data` collection and allows only single selection.
19+
## Comparison with SegmentedControl and TabStrip
20+
21+
@[template](/_contentTemplates/segmentedcontrol/notes.md#comparison-with-buttongroup-tabstrip)
2022

2123
## Creating Blazor ButtonGroup
2224

components/segmentedcontrol/overview.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,10 @@ The <a href="https://www.telerik.com/blazor-ui/segmented-control" target="_blank
1515

1616
>tip Compared to the ButtonGroup, the SegmentedControl is a data-bound component — it renders items from a `Data` collection and allows only single selection. The [ButtonGroup](slug:buttongroup-overview) is markup-based — you declare each button explicitly as a child component and can configure the component for single or multiple selection.
1717
18+
## Comparison with ButtonGroup and TabStrip
19+
20+
@[template](/_contentTemplates/segmentedcontrol/notes.md#comparison-with-buttongroup-tabstrip)
21+
1822
## Creating Blazor SegmentedControl
1923

2024
1. Use the `<TelerikSegmentedControl>` tag.

components/tabstrip/overview.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,10 @@ components: ["tabstrip"]
1212

1313
The <a href = "https://www.telerik.com/blazor-ui/tabstrip" target = "_blank">Blazor TabStrip component</a> displays a collection of tabs, containing associated content, which enable the user to switch between different views inside a single component.
1414

15+
## Comparison with ButtonGroup and SegmentedControl
16+
17+
@[template](/_contentTemplates/segmentedcontrol/notes.md#comparison-with-buttongroup-tabstrip)
18+
1519
## Creating Blazor TabStrip
1620

1721
1. Use the `<TelerikTabStrip>` tag.

0 commit comments

Comments
 (0)