State of Compose 2023 results are in! Click here to learn more

← Back to Material 3 Compose

SingleChoiceSegmentedButtonRow

Component
in
Material 3
. Since 1.2.0-alpha09

Overview

Code Examples

<a href="https://m3.material.io/components/segmented-buttons/overview" class="external" target="_blank">Material Segmented Button</a>.

A Layout to correctly position and size SegmentedButtons in a Row. It handles overlapping items so that strokes of the item are correctly on top of each other. SingleChoiceSegmentedButtonRow is used when the selection only allows one value, for correct semantics.

Overloads

SingleChoiceSegmentedButtonRow

@Composable
@ExperimentalMaterial3Api
fun SingleChoiceSegmentedButtonRow(
    modifier: Modifier = Modifier,
    space: Dp = SegmentedButtonDefaults.BorderWidth,
    content: @Composable SingleChoiceSegmentedButtonRowScope.() -> Unit
)

Parameters

NameDescription
modifierthe Modifier to be applied to this row
spacethe dimension of the overlap between buttons. Should be equal to the stroke width used on the items.
contentthe content of this Segmented Button Row, typically a sequence of SegmentedButton