ToggleButtonDefaults

@ExperimentalMaterial3ExpressiveApi
object ToggleButtonDefaults

Contains the default values for all five toggle button types.

Properties

val MinHeight = ButtonSmallTokens.ContainerHeight

The default min height applied for all toggle buttons. Note that you can override it by applying Modifier.heightIn directly on the toggle button composable.

val IconSpacing = ButtonSmallTokens.IconLabelSpace

The default size of the spacing between an icon and a text when they used inside any toggle button.

val IconSize = ButtonSmallTokens.IconSize

The default size of the spacing between an icon and a text when they used inside any toggle button.

val ContentPadding =
    PaddingValues(
        start = ToggleButtonStartPadding,
        top = ButtonVerticalPadding,
        end = ToggleButtonEndPadding,
        bottom = ButtonVerticalPadding,
    )

The default content padding used by all toggle buttons.

val roundShape: Shape

A round shape that can be used for all ToggleButtons and its variants

val squareShape: Shape

A square shape that can be used for all ToggleButtons and its variants

val shape: Shape

The default unchecked shape for ToggleButton

val pressedShape: Shape

The default pressed shape for ToggleButton

val checkedShape: Shape

The default checked shape for ToggleButton

val extraSmallSquareShape: Shape

The default square shape for a extra small toggle button

val mediumSquareShape: Shape

The default square shape for a medium toggle button

val largeSquareShape: Shape

The default square shape for a large toggle button

val extraLargeSquareShape: Shape

The default square shape for a extra large toggle button

val extraSmallPressedShape: Shape

The default pressed shape for a extra small toggle button

val mediumPressedShape: Shape

The default pressed shape for a medium toggle button

val largePressedShape: Shape

The default pressed shape for a large toggle button

val extraLargePressedShape: Shape

The default pressed shape for a extra large toggle button

val extraSmallCheckedSquareShape: Shape

The default checked square shape for a extra small toggle button

val mediumCheckedSquareShape: Shape

The default checked square shape for a medium toggle button

val largeCheckedSquareShape: Shape

The default checked square shape for a large toggle button

val extraLargeCheckedSquareShape: Shape

The default checked square shape for a extra large toggle button

Functions

@Composable fun shapes() = MaterialTheme.shapes.defaultToggleButtonShapes

Creates a ToggleButtonShapes that represents the default shape, pressedShape, and checkedShape used in a ToggleButton.

shapes

@Composable
    fun shapes(
        shape: Shape? = null,
        pressedShape: Shape? = null,
        checkedShape: Shape? = null,
    ): ToggleButtonShapes

Creates a ToggleButtonShapes that represents the default shape, pressedShape, and checkedShape used in a ToggleButton and its variants.

Parameters

@Composable fun toggleButtonColors() = MaterialTheme.colorScheme.defaultToggleButtonColors

Creates a ToggleButtonColors that represents the default container and content colors used in a ToggleButton.

toggleButtonColors

@Composable
    fun toggleButtonColors(
        containerColor: Color = Color.Unspecified,
        contentColor: Color = Color.Unspecified,
        disabledContainerColor: Color = Color.Unspecified,
        disabledContentColor: Color = Color.Unspecified,
        checkedContainerColor: Color = Color.Unspecified,
        checkedContentColor: Color = Color.Unspecified,
    ): ToggleButtonColors

Creates a ToggleButtonColors that represents the default container and content colors used in a ToggleButton.

Parameters

elevatedToggleButtonColors

@Composable
    fun elevatedToggleButtonColors() = MaterialTheme.colorScheme.defaultElevatedToggleButtonColors

Creates a ToggleButtonColors that represents the default container and content colors used in a ElevatedToggleButton.

elevatedToggleButtonColors

@Composable
    fun elevatedToggleButtonColors(
        containerColor: Color = Color.Unspecified,
        contentColor: Color = Color.Unspecified,
        disabledContainerColor: Color = Color.Unspecified,
        disabledContentColor: Color = Color.Unspecified,
        checkedContainerColor: Color = Color.Unspecified,
        checkedContentColor: Color = Color.Unspecified,
    ): ToggleButtonColors

Creates a ToggleButtonColors that represents the default container and content colors used in a ElevatedToggleButton.

Parameters

tonalToggleButtonColors

@Composable
    fun tonalToggleButtonColors() = MaterialTheme.colorScheme.defaultTonalToggleButtonColors

Creates a ToggleButtonColors that represents the default container and content colors used in a TonalToggleButton.

tonalToggleButtonColors

@Composable
    fun tonalToggleButtonColors(
        containerColor: Color = Color.Unspecified,
        contentColor: Color = Color.Unspecified,
        disabledContainerColor: Color = Color.Unspecified,
        disabledContentColor: Color = Color.Unspecified,
        checkedContainerColor: Color = Color.Unspecified,
        checkedContentColor: Color = Color.Unspecified,
    ): ToggleButtonColors

Creates a ToggleButtonColors that represents the default container and content colors used in a TonalToggleButton.

Parameters

outlinedToggleButtonColors

@Composable
    fun outlinedToggleButtonColors() = MaterialTheme.colorScheme.defaultOutlinedToggleButtonColors

Creates a ToggleButtonColors that represents the default container and content colors used in a OutlinedToggleButton.

outlinedToggleButtonColors

@Composable
    fun outlinedToggleButtonColors(
        containerColor: Color = Color.Unspecified,
        contentColor: Color = Color.Unspecified,
        disabledContainerColor: Color = Color.Unspecified,
        disabledContentColor: Color = Color.Unspecified,
        checkedContainerColor: Color = Color.Unspecified,
        checkedContentColor: Color = Color.Unspecified,
    ): ToggleButtonColors

Creates a ToggleButtonColors that represents the default container and content colors used in a OutlinedToggleButton.

Parameters

shapesFor

@Composable
    fun shapesFor(buttonHeight: Dp): ToggleButtonShapes

Recommended ToggleButtonShapes for a provided toggle button height.

Parameters