public object ToggleButtonDefaults
Contains the default values and utility functions used by ToggleButton.
Properties
size
public val size: ToggleButtonSize = ToggleButtonSize.Small
The default ToggleButtonSize of a ToggleButton.
MinHeight
public val MinHeight: Dp = ButtonSmallTokens.ContainerHeight
The default min height applied for ToggleButton.
Override it by applying Modifier.heightIn directly on the toggle button composable.
IconSpacing
public val IconSpacing: Dp = ButtonSmallTokens.IconLabelSpace
The default size of the spacing between an icon and a text when they are used inside a ToggleButton.
IconSize
public val IconSize: Dp = ButtonSmallTokens.IconSize
The default size of an icon when used inside a ToggleButton.
shape
public val shape: Shape
The default unchecked shape for ToggleButton
pressedShape
public val pressedShape: Shape
The default pressed shape for ToggleButton
checkedShape
public val checkedShape: Shape
The default checked shape for ToggleButton
Functions
contentPaddingFor
public fun contentPaddingFor(
buttonHeight: Dp,
hasStartIcon: Boolean = false,
hasEndIcon: Boolean = false,
): PaddingValues
Recommended PaddingValues for a provided toggle button height.
The returned content padding is based on standard container height values and is not directly interpolated from the provided buttonHeight.
Parameters
| buttonHeight | the height of the toggle button |
| hasStartIcon | whether the toggle button has a leading icon |
| hasEndIcon | whether the toggle button has a trailing icon |
contentPaddingFor
public fun contentPaddingFor(
buttonSize: ToggleButtonSize,
hasStartIcon: Boolean = false,
hasEndIcon: Boolean = false,
): PaddingValues
Recommended PaddingValues for a provided buttonSize.
The returned content padding is based on standard container height values and is not directly interpolated from the provided buttonSize.
Parameters
| buttonSize | the ToggleButtonSize of the toggle button |
| hasStartIcon | whether the toggle button has a leading icon |
| hasEndIcon | whether the toggle button has a trailing icon |
elevation
@Composable
public fun elevation(
defaultElevation: Dp = FilledButtonTokens.ContainerElevation,
pressedElevation: Dp = FilledButtonTokens.PressedContainerElevation,
focusedElevation: Dp = FilledButtonTokens.FocusedContainerElevation,
hoveredElevation: Dp = FilledButtonTokens.HoveredContainerElevation,
disabledElevation: Dp = FilledButtonTokens.DisabledContainerElevation,
): ToggleButtonElevation
Creates a ToggleButtonElevation that will animate between the provided values according to the Material specification for a ToggleButton.
Parameters
| defaultElevation | the elevation used when the ToggleButton is enabled, and has no other Interactions. |
| pressedElevation | the elevation used when this ToggleButton is enabled and pressed. |
| focusedElevation | the elevation used when the ToggleButton is enabled and focused. |
| hoveredElevation | the elevation used when the ToggleButton is enabled and hovered. |
| disabledElevation | the elevation used when the ToggleButton is not enabled. |
colors
@Composable
public fun colors(): ToggleButtonColors
Creates a ToggleButtonColors that represents the default container and content colors used in a ToggleButton.
colors
@Composable
public fun colors(
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
| containerColor | the container color of this ToggleButton when enabled. |
| contentColor | the content color of this ToggleButton when enabled. |
| disabledContainerColor | the container color of this ToggleButton when not enabled. |
| disabledContentColor | the content color of this ToggleButton when not enabled. |
| checkedContainerColor | the container color of this ToggleButton when checked. |
| checkedContentColor | the content color of this ToggleButton when checked. |
shapesFor
@Composable
public fun shapesFor(buttonHeight: Dp): ToggleButtonShapes
Resolves the recommended ToggleButtonShapes for a given toggle button height.
The input height is categorized into a shape bucket (such as extra small, small, medium, large, or extra large) based on the closest standard button height.
Parameters
| buttonHeight | height of the button used to resolve the shape bucket |
shapesFor
@Composable
public fun shapesFor(buttonSize: ToggleButtonSize): ToggleButtonShapes
Resolves the recommended ToggleButtonShapes for a given buttonSize.
Parameters
| buttonSize | ToggleButtonSize used to resolve the shape bucket |