Common
```kotlin
@ExperimentalMaterial3ExpressiveApi
object ToggleButtonDefaults
```
Contains the default values for all five toggle button types.
## Properties
Common
```kotlin
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.
Common
```kotlin
val IconSpacing = ButtonSmallTokens.IconLabelSpace
```
The default size of the spacing between an icon and a text when they used inside any toggle
button.
Common
```kotlin
val IconSize = ButtonSmallTokens.IconSize
```
The default size of the spacing between an icon and a text when they used inside any toggle
button.
Common
```kotlin
val ContentPadding =
PaddingValues(
start = ToggleButtonStartPadding,
top = ButtonVerticalPadding,
end = ToggleButtonEndPadding,
bottom = ButtonVerticalPadding,
)
```
The default content padding used by all toggle buttons.
Common
```kotlin
val roundShape: Shape
```
A round shape that can be used for all [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton)s and its variants
Common
```kotlin
val squareShape: Shape
```
A square shape that can be used for all [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton)s and its variants
Common
```kotlin
val shape: Shape
```
The default unchecked shape for [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton)
Common
```kotlin
val pressedShape: Shape
```
The default pressed shape for [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton)
Common
```kotlin
val checkedShape: Shape
```
The default checked shape for [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton)
Common
```kotlin
val extraSmallSquareShape: Shape
```
The default square shape for a extra small toggle button
Common
```kotlin
val mediumSquareShape: Shape
```
The default square shape for a medium toggle button
Common
```kotlin
val largeSquareShape: Shape
```
The default square shape for a large toggle button
Common
```kotlin
val extraLargeSquareShape: Shape
```
The default square shape for a extra large toggle button
Common
```kotlin
val extraSmallPressedShape: Shape
```
The default pressed shape for a extra small toggle button
Common
```kotlin
val mediumPressedShape: Shape
```
The default pressed shape for a medium toggle button
Common
```kotlin
val largePressedShape: Shape
```
The default pressed shape for a large toggle button
Common
```kotlin
val extraLargePressedShape: Shape
```
The default pressed shape for a extra large toggle button
Common
```kotlin
val extraSmallCheckedSquareShape: Shape
```
The default checked square shape for a extra small toggle button
Common
```kotlin
val mediumCheckedSquareShape: Shape
```
The default checked square shape for a medium toggle button
Common
```kotlin
val largeCheckedSquareShape: Shape
```
The default checked square shape for a large toggle button
Common
```kotlin
val extraLargeCheckedSquareShape: Shape
```
The default checked square shape for a extra large toggle button
## Functions
```kotlin
@Composable fun shapes() = MaterialTheme.shapes.defaultToggleButtonShapes
```
Creates a [ToggleButtonShapes](/jetpack-compose/androidx.compose.material3/material3/classes/ToggleButtonShapes) that represents the default shape, pressedShape, and
checkedShape used in a [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton).
shapes
```kotlin
@Composable
fun shapes(
shape: Shape? = null,
pressedShape: Shape? = null,
checkedShape: Shape? = null,
): ToggleButtonShapes
```
Creates a [ToggleButtonShapes](/jetpack-compose/androidx.compose.material3/material3/classes/ToggleButtonShapes) that represents the default shape, pressedShape, and
checkedShape used in a [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton) and its variants.
#### Parameters
| | |
| --- | --- |
| shape | the unchecked shape for [ToggleButtonShapes](/jetpack-compose/androidx.compose.material3/material3/classes/ToggleButtonShapes) |
| pressedShape | the unchecked shape for [ToggleButtonShapes](/jetpack-compose/androidx.compose.material3/material3/classes/ToggleButtonShapes) |
| checkedShape | the unchecked shape for [ToggleButtonShapes](/jetpack-compose/androidx.compose.material3/material3/classes/ToggleButtonShapes) |
```kotlin
@Composable fun toggleButtonColors() = MaterialTheme.colorScheme.defaultToggleButtonColors
```
Creates a [ToggleButtonColors](/jetpack-compose/androidx.compose.material3/material3/classes/ToggleButtonColors) that represents the default container and content colors used
in a [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton).
toggleButtonColors
```kotlin
@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](/jetpack-compose/androidx.compose.material3/material3/classes/ToggleButtonColors) that represents the default container and content colors used
in a [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton).
#### Parameters
| | |
| --- | --- |
| containerColor | the container color of this [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton) when enabled. |
| contentColor | the content color of this [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton) when enabled. |
| disabledContainerColor | the container color of this [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton) when not enabled. |
| disabledContentColor | the content color of this [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton) when not enabled. |
| checkedContainerColor | the container color of this [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton) when checked. |
| checkedContentColor | the content color of this [ToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ToggleButton) when checked. |
```kotlin
@Composable
fun elevatedToggleButtonColors() = MaterialTheme.colorScheme.defaultElevatedToggleButtonColors
```
Creates a [ToggleButtonColors](/jetpack-compose/androidx.compose.material3/material3/classes/ToggleButtonColors) that represents the default container and content colors used
in a [ElevatedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ElevatedToggleButton).
elevatedToggleButtonColors
```kotlin
@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](/jetpack-compose/androidx.compose.material3/material3/classes/ToggleButtonColors) that represents the default container and content colors used
in a [ElevatedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ElevatedToggleButton).
#### Parameters
| | |
| --- | --- |
| containerColor | the container color of this [ElevatedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ElevatedToggleButton) when enabled. |
| contentColor | the content color of this [ElevatedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ElevatedToggleButton) when enabled. |
| disabledContainerColor | the container color of this [ElevatedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ElevatedToggleButton) when not enabled. |
| disabledContentColor | the content color of this [ElevatedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ElevatedToggleButton) when not enabled. |
| checkedContainerColor | the container color of this [ElevatedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ElevatedToggleButton) when checked. |
| checkedContentColor | the content color of this [ElevatedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/ElevatedToggleButton) when checked. |
```kotlin
@Composable
fun tonalToggleButtonColors() = MaterialTheme.colorScheme.defaultTonalToggleButtonColors
```
Creates a [ToggleButtonColors](/jetpack-compose/androidx.compose.material3/material3/classes/ToggleButtonColors) that represents the default container and content colors used
in a [TonalToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/TonalToggleButton).
tonalToggleButtonColors
```kotlin
@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](/jetpack-compose/androidx.compose.material3/material3/classes/ToggleButtonColors) that represents the default container and content colors used
in a [TonalToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/TonalToggleButton).
#### Parameters
| | |
| --- | --- |
| containerColor | the container color of this [TonalToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/TonalToggleButton) when enabled. |
| contentColor | the content color of this [TonalToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/TonalToggleButton) when enabled. |
| disabledContainerColor | the container color of this [TonalToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/TonalToggleButton) when not enabled. |
| disabledContentColor | the content color of this [TonalToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/TonalToggleButton) when not enabled. |
| checkedContainerColor | the container color of this [TonalToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/TonalToggleButton) when checked. |
| checkedContentColor | the content color of this [TonalToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/TonalToggleButton) when checked. |
```kotlin
@Composable
fun outlinedToggleButtonColors() = MaterialTheme.colorScheme.defaultOutlinedToggleButtonColors
```
Creates a [ToggleButtonColors](/jetpack-compose/androidx.compose.material3/material3/classes/ToggleButtonColors) that represents the default container and content colors used
in a [OutlinedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/OutlinedToggleButton).
outlinedToggleButtonColors
```kotlin
@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](/jetpack-compose/androidx.compose.material3/material3/classes/ToggleButtonColors) that represents the default container and content colors used
in a [OutlinedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/OutlinedToggleButton).
#### Parameters
| | |
| --- | --- |
| containerColor | the container color of this [OutlinedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/OutlinedToggleButton) when enabled. |
| contentColor | the content color of this [OutlinedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/OutlinedToggleButton) when enabled. |
| disabledContainerColor | the container color of this [OutlinedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/OutlinedToggleButton) when not enabled. |
| disabledContentColor | the content color of this [OutlinedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/OutlinedToggleButton) when not enabled. |
| checkedContainerColor | the container color of this [OutlinedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/OutlinedToggleButton) when checked. |
| checkedContentColor | the content color of this [OutlinedToggleButton](/jetpack-compose/androidx.compose.material3/material3/components/OutlinedToggleButton) when checked. |
```kotlin
@Composable
fun shapesFor(buttonHeight: Dp): ToggleButtonShapes
```
Recommended [ToggleButtonShapes](/jetpack-compose/androidx.compose.material3/material3/classes/ToggleButtonShapes) for a provided toggle button height.
#### Parameters
| | |
| --- | --- |
| buttonHeight | The height of the button |