SplitButtonDefaults

Artifact: androidx.compose.material3:material3

Cmn

@ExperimentalMaterial3ExpressiveApi
object SplitButtonDefaults

Contains default values used by SplitButtonLayout and its style variants.

Summary

Public functions
`Unit`	`@ExperimentalMaterial3ExpressiveApi @Composable ElevatedLeadingButton( onClick: () -> Unit, modifier: Modifier, enabled: Boolean, shapes: SplitButtonShapes, colors: ButtonColors, elevation: ButtonElevation?, border: BorderStroke?, contentPadding: PaddingValues, interactionSource: MutableInteractionSource?, content: @Composable RowScope.() -> Unit )` Create a elevated `leading` button that has the same visual as a `ElevatedButton`.	Cmn
`Unit`	`@ExperimentalMaterial3ExpressiveApi @Composable ElevatedTrailingButton( checked: Boolean, onCheckedChange: (Boolean) -> Unit, modifier: Modifier, enabled: Boolean, shapes: SplitButtonShapes, colors: ButtonColors, elevation: ButtonElevation?, border: BorderStroke?, contentPadding: PaddingValues, interactionSource: MutableInteractionSource?, content: @Composable RowScope.() -> Unit )` Creates a elevated `trailing` button that has the same visual as a `ElevatedButton`.	Cmn
`Unit`	`@ExperimentalMaterial3ExpressiveApi @Composable LeadingButton( onClick: () -> Unit, modifier: Modifier, enabled: Boolean, shapes: SplitButtonShapes, colors: ButtonColors, elevation: ButtonElevation?, border: BorderStroke?, contentPadding: PaddingValues, interactionSource: MutableInteractionSource?, content: @Composable RowScope.() -> Unit )` Create a default `leading` button that has the same visual as a Filled`Button`.	Cmn
`Unit`	`@ExperimentalMaterial3ExpressiveApi @Composable OutlinedLeadingButton( onClick: () -> Unit, modifier: Modifier, enabled: Boolean, shapes: SplitButtonShapes, colors: ButtonColors, elevation: ButtonElevation?, border: BorderStroke?, contentPadding: PaddingValues, interactionSource: MutableInteractionSource?, content: @Composable RowScope.() -> Unit )` Create a elevated `leading` button that has the same visual as a `ElevatedButton`.	Cmn
`Unit`	`@ExperimentalMaterial3ExpressiveApi @Composable OutlinedTrailingButton( checked: Boolean, onCheckedChange: (Boolean) -> Unit, modifier: Modifier, enabled: Boolean, shapes: SplitButtonShapes, colors: ButtonColors, elevation: ButtonElevation?, border: BorderStroke?, contentPadding: PaddingValues, interactionSource: MutableInteractionSource?, content: @Composable RowScope.() -> Unit )` Creates a outlined `trailing` button that has the same visual as a `OutlinedButton`.	Cmn
`Unit`	`@ExperimentalMaterial3ExpressiveApi @Composable TonalLeadingButton( onClick: () -> Unit, modifier: Modifier, enabled: Boolean, shapes: SplitButtonShapes, colors: ButtonColors, elevation: ButtonElevation?, border: BorderStroke?, contentPadding: PaddingValues, interactionSource: MutableInteractionSource?, content: @Composable RowScope.() -> Unit )` Create a tonal `leading` button that has the same visual as a Tonal`Button`.	Cmn
`Unit`	`@ExperimentalMaterial3ExpressiveApi @Composable TonalTrailingButton( checked: Boolean, onCheckedChange: (Boolean) -> Unit, modifier: Modifier, enabled: Boolean, shapes: SplitButtonShapes, colors: ButtonColors, elevation: ButtonElevation?, border: BorderStroke?, contentPadding: PaddingValues, interactionSource: MutableInteractionSource?, content: @Composable RowScope.() -> Unit )` Creates a tonal `trailing` button that has the same visual as a `FilledTonalButton`.	Cmn
`Unit`	`@Composable @ExperimentalMaterial3ExpressiveApi TrailingButton( onClick: () -> Unit, modifier: Modifier, enabled: Boolean, shapes: SplitButtonShapes, colors: ButtonColors, elevation: ButtonElevation?, border: BorderStroke?, contentPadding: PaddingValues, interactionSource: MutableInteractionSource?, content: @Composable RowScope.() -> Unit )` Creates a `trailing` button that has the same visual as a `Button`.	Cmn
`Unit`	`@Composable @ExperimentalMaterial3ExpressiveApi TrailingButton( checked: Boolean, onCheckedChange: (Boolean) -> Unit, modifier: Modifier, enabled: Boolean, shapes: SplitButtonShapes, colors: ButtonColors, elevation: ButtonElevation?, border: BorderStroke?, contentPadding: PaddingValues, interactionSource: MutableInteractionSource?, content: @Composable RowScope.() -> Unit )` Creates a `trailing` button that has the same visual as a `Button`.	Cmn
`PaddingValues`	`leadingButtonContentPaddingFor(buttonHeight: Dp)` Recommended `PaddingValues` for a provided leading button height.	Cmn
`Dp`	`leadingButtonIconSizeFor(buttonHeight: Dp)` Recommended leading button Icon size for a provided button height.	Cmn
`SplitButtonShapes`	`@Composable @ExperimentalMaterial3ExpressiveApi leadingButtonShapesFor(buttonHeight: Dp)` Recommended leading button `SplitButtonShapes` for a provided leading button height.	Cmn
`PaddingValues`	`trailingButtonContentPaddingFor(buttonHeight: Dp)` Recommended `PaddingValues` for a provided trailing button height.	Cmn
`Dp`	`trailingButtonIconSizeFor(buttonHeight: Dp)` Recommended trailing button Icon size for a provided button height.	Cmn
`SplitButtonShapes`	`@Composable @ExperimentalMaterial3ExpressiveApi trailingButtonShapesFor(buttonHeight: Dp)` Recommended trailing button `SplitButtonShapes` for a provided trailing button height.	Cmn

Public properties
`Dp`	`@ExperimentalMaterial3ExpressiveApi ExtraLargeContainerHeight` The default height for an extra large button container.	Cmn
`CornerSize`	`ExtraLargeInnerCornerSize` Default extra large size for the leading button end corners and trailing button start corners	Cmn
`CornerSize`	`ExtraLargeInnerCornerSizePressed` Default extra large size for the leading button end corners and trailing button start corners when pressed	Cmn
`PaddingValues`	`@ExperimentalMaterial3ExpressiveApi ExtraLargeLeadingButtonContentPadding` Default content padding of the extra large leading button	Cmn
`PaddingValues`	`@ExperimentalMaterial3ExpressiveApi ExtraLargeTrailingButtonContentPadding` Default content padding of the extra large trailing button	Cmn
`Dp`	`ExtraLargeTrailingButtonIconSize` The default size of the icon used inside of an extra large trailing button of a split button.	Cmn
`Dp`	`@ExperimentalMaterial3ExpressiveApi ExtraSmallContainerHeight` The default height for an extra small button container.	Cmn
`CornerSize`	`ExtraSmallInnerCornerSize` Default extra small size for the leading button end corners and trailing button start corners	Cmn
`CornerSize`	`ExtraSmallInnerCornerSizePressed` Default extra small size for the leading button end corners and trailing button start corners when pressed	Cmn
`PaddingValues`	`@ExperimentalMaterial3ExpressiveApi ExtraSmallLeadingButtonContentPadding` Default content padding of the extra small leading button	Cmn
`PaddingValues`	`@ExperimentalMaterial3ExpressiveApi ExtraSmallTrailingButtonContentPadding` Default content padding of the extra small trailing button	Cmn
`Dp`	`ExtraSmallTrailingButtonIconSize` The default size of the icon used inside of an extra small trailing button of a split button.	Cmn
`Dp`	`@ExperimentalMaterial3ExpressiveApi LargeContainerHeight` The default height for a large button container.	Cmn
`CornerSize`	`LargeInnerCornerSize` Default large size for the leading button end corners and trailing button start corners	Cmn
`CornerSize`	`LargeInnerCornerSizePressed` Default large size for the leading button end corners and trailing button start corners when pressed	Cmn
`PaddingValues`	`@ExperimentalMaterial3ExpressiveApi LargeLeadingButtonContentPadding` Default content padding of the large leading button	Cmn
`PaddingValues`	`@ExperimentalMaterial3ExpressiveApi LargeTrailingButtonContentPadding` Default content padding of the large trailing button	Cmn
`Dp`	`LargeTrailingButtonIconSize` The default size of the icon used inside of an large trailing button of a split button.	Cmn
`Dp`	`LeadingIconSize` Default icon size for the leading button	Cmn
`Dp`	`@ExperimentalMaterial3ExpressiveApi MediumContainerHeight` The default height for a medium button container.	Cmn
`CornerSize`	`MediumInnerCornerSize` Default medium size for the leading button end corners and trailing button start corners	Cmn
`CornerSize`	`MediumInnerCornerSizePressed` Default medium size for the leading button end corners and trailing button start corners when pressed	Cmn
`PaddingValues`	`@ExperimentalMaterial3ExpressiveApi MediumLeadingButtonContentPadding` Default content padding of the medium leading button	Cmn
`PaddingValues`	`@ExperimentalMaterial3ExpressiveApi MediumTrailingButtonContentPadding` Default content padding of the medium trailing button	Cmn
`Dp`	`MediumTrailingButtonIconSize` The default size of the icon used inside of an medium trailing button of a split button.	Cmn
`CornerSize`	`OuterCornerSize` Default percentage size for the leading button start corners and trailing button end corners	Cmn
`Dp`	`SmallContainerHeight` Default minimum height of the split button.	Cmn
`CornerSize`	`SmallInnerCornerSize` Default small size for the leading button end corners and trailing button start corners	Cmn
`CornerSize`	`SmallInnerCornerSizePressed` Default small size for the leading button end corners and trailing button start corners when pressed	Cmn
`PaddingValues`	`@ExperimentalMaterial3ExpressiveApi SmallLeadingButtonContentPadding` Default content padding of the small leading button	Cmn
`PaddingValues`	`@ExperimentalMaterial3ExpressiveApi SmallTrailingButtonContentPadding` Default content padding of the small trailing button	Cmn
`Dp`	`SmallTrailingButtonIconSize` The default size of the icon used inside of an small trailing button of a split button.	Cmn
`Dp`	`Spacing` Default spacing between the `leading` and `trailing` button	Cmn
`Dp`	`TrailingIconSize` Default icon size for the trailing button	Cmn

Public functions

ElevatedLeadingButton

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
@Composable
fun ElevatedLeadingButton(
    onClick: () -> Unit,
    modifier: Modifier = Modifier,
    enabled: Boolean = true,
    shapes: SplitButtonShapes = leadingButtonShapesFor(SmallContainerHeight),
    colors: ButtonColors = ButtonDefaults.elevatedButtonColors(),
    elevation: ButtonElevation? = ButtonDefaults.elevatedButtonElevation(),
    border: BorderStroke? = null,
    contentPadding: PaddingValues = leadingButtonContentPaddingFor(SmallContainerHeight),
    interactionSource: MutableInteractionSource? = null,
    content: @Composable RowScope.() -> Unit
): Unit

Create a elevated leading button that has the same visual as a ElevatedButton. To create a filled, outlined, or elevated version, the default value of Button params can be passed in. For example, ElevatedButton.

The default text style for internal Text components will be set to Typography.labelLarge.

Parameters
`onClick: () -> Unit`	called when the button is clicked
`modifier: Modifier = Modifier`	the `Modifier` to be applied to this button.
`enabled: Boolean = true`	controls the enabled state of the split button. When `false`, this component will not respond to user input, and it will appear visually disabled and disabled to accessibility services.
`shapes: SplitButtonShapes = leadingButtonShapesFor(SmallContainerHeight)`	the `SplitButtonShapes` that the trailing button will morph between depending on the user's interaction with the button.
`colors: ButtonColors = ButtonDefaults.elevatedButtonColors()`	`ButtonColors` that will be used to resolve the colors for this button in different states. See `ButtonDefaults.buttonColors`.
`elevation: ButtonElevation? = ButtonDefaults.elevatedButtonElevation()`	`ButtonElevation` used to resolve the elevation for this button in different states. This controls the size of the shadow below the button. See `ButtonElevation.shadowElevation`.
`border: BorderStroke? = null`	the border to draw around the container of this button contentPadding the spacing values to apply internally between the container and the content
`contentPadding: PaddingValues = leadingButtonContentPaddingFor(SmallContainerHeight)`	the spacing values to apply internally between the container and the content
`interactionSource: MutableInteractionSource? = null`	an optional hoisted `MutableInteractionSource` for observing and emitting `Interaction`s for this button. You can use this to change the button's appearance or preview the button in different states. Note that if `null` is provided, interactions will still happen internally.
`content: @Composable RowScope.() -> Unit`	the content for the button.

ElevatedTrailingButton

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
@Composable
fun ElevatedTrailingButton(
    checked: Boolean,
    onCheckedChange: (Boolean) -> Unit,
    modifier: Modifier = Modifier,
    enabled: Boolean = true,
    shapes: SplitButtonShapes = trailingButtonShapesFor(SmallContainerHeight),
    colors: ButtonColors = ButtonDefaults.elevatedButtonColors(),
    elevation: ButtonElevation? = ButtonDefaults.elevatedButtonElevation(),
    border: BorderStroke? = null,
    contentPadding: PaddingValues = trailingButtonContentPaddingFor(SmallContainerHeight),
    interactionSource: MutableInteractionSource? = null,
    content: @Composable RowScope.() -> Unit
): Unit

Creates a elevated trailing button that has the same visual as a ElevatedButton. When checked is updated from false to true, the buttons corners will morph to full by default. Pressed shape and checked shape can be customized via shapes param.

To create a tonal, outlined, or elevated version, the default value of Button params can be passed in. For example, ElevatedButton.

The default text style for internal Text components will be set to Typography.labelLarge.

Parameters
`checked: Boolean`	indicates whether the button is checked. This will trigger the corner morphing animation to reflect the updated state.
`onCheckedChange: (Boolean) -> Unit`	called when the button is clicked
`modifier: Modifier = Modifier`	the `Modifier` to be applied to this button.
`enabled: Boolean = true`	controls the enabled state of the split button. When `false`, this component will not respond to user input, and it will appear visually disabled and disabled to accessibility services.
`shapes: SplitButtonShapes = trailingButtonShapesFor(SmallContainerHeight)`	the `SplitButtonShapes` that the trailing button will morph between depending on the user's interaction with the button.
`colors: ButtonColors = ButtonDefaults.elevatedButtonColors()`	`ButtonColors` that will be used to resolve the colors for this button in different states. See `ButtonDefaults.buttonColors`.
`elevation: ButtonElevation? = ButtonDefaults.elevatedButtonElevation()`	`ButtonElevation` used to resolve the elevation for this button in different states. This controls the size of the shadow below the button. See `ButtonElevation.shadowElevation`.
`border: BorderStroke? = null`	the border to draw around the container of this button contentPadding the spacing values to apply internally between the container and the content
`contentPadding: PaddingValues = trailingButtonContentPaddingFor(SmallContainerHeight)`	the spacing values to apply internally between the container and the content
`interactionSource: MutableInteractionSource? = null`	an optional hoisted `MutableInteractionSource` for observing and emitting `Interaction`s for this button. You can use this to change the button's appearance or preview the button in different states. Note that if `null` is provided, interactions will still happen internally.
`content: @Composable RowScope.() -> Unit`	the content to be placed in the button

LeadingButton

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
@Composable
fun LeadingButton(
    onClick: () -> Unit,
    modifier: Modifier = Modifier,
    enabled: Boolean = true,
    shapes: SplitButtonShapes = leadingButtonShapesFor(SmallContainerHeight),
    colors: ButtonColors = ButtonDefaults.buttonColors(),
    elevation: ButtonElevation? = ButtonDefaults.buttonElevation(),
    border: BorderStroke? = null,
    contentPadding: PaddingValues = leadingButtonContentPaddingFor(SmallContainerHeight),
    interactionSource: MutableInteractionSource? = null,
    content: @Composable RowScope.() -> Unit
): Unit

Create a default leading button that has the same visual as a FilledButton. To create a tonal, outlined, or elevated version, the default value of Button params can be passed in. For example, ElevatedButton.

The default text style for internal Text components will be set to Typography.labelLarge.

Parameters
`onClick: () -> Unit`	called when the button is clicked
`modifier: Modifier = Modifier`	the `Modifier` to be applied to this button.
`enabled: Boolean = true`	controls the enabled state of the split button. When `false`, this component will not respond to user input, and it will appear visually disabled and disabled to accessibility services.
`shapes: SplitButtonShapes = leadingButtonShapesFor(SmallContainerHeight)`	the `SplitButtonShapes` that the trailing button will morph between depending on the user's interaction with the button.
`colors: ButtonColors = ButtonDefaults.buttonColors()`	`ButtonColors` that will be used to resolve the colors for this button in different states. See `ButtonDefaults.buttonColors`.
`elevation: ButtonElevation? = ButtonDefaults.buttonElevation()`	`ButtonElevation` used to resolve the elevation for this button in different states. This controls the size of the shadow below the button. See `ButtonElevation.shadowElevation`.
`border: BorderStroke? = null`	the border to draw around the container of this button contentPadding the spacing values to apply internally between the container and the content
`contentPadding: PaddingValues = leadingButtonContentPaddingFor(SmallContainerHeight)`	the spacing values to apply internally between the container and the content
`interactionSource: MutableInteractionSource? = null`	an optional hoisted `MutableInteractionSource` for observing and emitting `Interaction`s for this button. You can use this to change the button's appearance or preview the button in different states. Note that if `null` is provided, interactions will still happen internally.
`content: @Composable RowScope.() -> Unit`	the content for the button.

OutlinedLeadingButton

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
@Composable
fun OutlinedLeadingButton(
    onClick: () -> Unit,
    modifier: Modifier = Modifier,
    enabled: Boolean = true,
    shapes: SplitButtonShapes = leadingButtonShapesFor(SmallContainerHeight),
    colors: ButtonColors = ButtonDefaults.outlinedButtonColors(),
    elevation: ButtonElevation? = null,
    border: BorderStroke? = ButtonDefaults.outlinedButtonBorder(enabled),
    contentPadding: PaddingValues = leadingButtonContentPaddingFor(SmallContainerHeight),
    interactionSource: MutableInteractionSource? = null,
    content: @Composable RowScope.() -> Unit
): Unit

The default text style for internal Text components will be set to Typography.labelLarge.

Parameters
`onClick: () -> Unit`	called when the button is clicked
`modifier: Modifier = Modifier`	the `Modifier` to be applied to this button.
`enabled: Boolean = true`	controls the enabled state of the split button. When `false`, this component will not respond to user input, and it will appear visually disabled and disabled to accessibility services.
`shapes: SplitButtonShapes = leadingButtonShapesFor(SmallContainerHeight)`	the `SplitButtonShapes` that the trailing button will morph between depending on the user's interaction with the button.
`colors: ButtonColors = ButtonDefaults.outlinedButtonColors()`	`ButtonColors` that will be used to resolve the colors for this button in different states. See `ButtonDefaults.buttonColors`.
`elevation: ButtonElevation? = null`	`ButtonElevation` used to resolve the elevation for this button in different states. This controls the size of the shadow below the button. See `ButtonElevation.shadowElevation`.
`border: BorderStroke? = ButtonDefaults.outlinedButtonBorder(enabled)`	the border to draw around the container of this button contentPadding the spacing values to apply internally between the container and the content
`contentPadding: PaddingValues = leadingButtonContentPaddingFor(SmallContainerHeight)`	the spacing values to apply internally between the container and the content
`interactionSource: MutableInteractionSource? = null`	an optional hoisted `MutableInteractionSource` for observing and emitting `Interaction`s for this button. You can use this to change the button's appearance or preview the button in different states. Note that if `null` is provided, interactions will still happen internally.
`content: @Composable RowScope.() -> Unit`	the content for the button.

OutlinedTrailingButton

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
@Composable
fun OutlinedTrailingButton(
    checked: Boolean,
    onCheckedChange: (Boolean) -> Unit,
    modifier: Modifier = Modifier,
    enabled: Boolean = true,
    shapes: SplitButtonShapes = trailingButtonShapesFor(SmallContainerHeight),
    colors: ButtonColors = ButtonDefaults.outlinedButtonColors(),
    elevation: ButtonElevation? = null,
    border: BorderStroke? = ButtonDefaults.outlinedButtonBorder(enabled),
    contentPadding: PaddingValues = trailingButtonContentPaddingFor(SmallContainerHeight),
    interactionSource: MutableInteractionSource? = null,
    content: @Composable RowScope.() -> Unit
): Unit

Creates a outlined trailing button that has the same visual as a OutlinedButton. When checked is updated from false to true, the buttons corners will morph to full by default. Pressed shape and checked shape can be customized via shapes param.

To create a tonal, outlined, or elevated version, the default value of Button params can be passed in. For example, ElevatedButton.

The default text style for internal Text components will be set to Typography.labelLarge.

Parameters
`checked: Boolean`	indicates whether the button is checked. This will trigger the corner morphing animation to reflect the updated state.
`onCheckedChange: (Boolean) -> Unit`	called when the button is clicked
`modifier: Modifier = Modifier`	the `Modifier` to be applied to this button.
`enabled: Boolean = true`	controls the enabled state of the split button. When `false`, this component will not respond to user input, and it will appear visually disabled and disabled to accessibility services.
`shapes: SplitButtonShapes = trailingButtonShapesFor(SmallContainerHeight)`	the `SplitButtonShapes` that the trailing button will morph between depending on the user's interaction with the button.
`colors: ButtonColors = ButtonDefaults.outlinedButtonColors()`	`ButtonColors` that will be used to resolve the colors for this button in different states. See `ButtonDefaults.buttonColors`.
`elevation: ButtonElevation? = null`	`ButtonElevation` used to resolve the elevation for this button in different states. This controls the size of the shadow below the button. See `ButtonElevation.shadowElevation`.
`border: BorderStroke? = ButtonDefaults.outlinedButtonBorder(enabled)`	the border to draw around the container of this button contentPadding the spacing values to apply internally between the container and the content
`contentPadding: PaddingValues = trailingButtonContentPaddingFor(SmallContainerHeight)`	the spacing values to apply internally between the container and the content
`interactionSource: MutableInteractionSource? = null`	an optional hoisted `MutableInteractionSource` for observing and emitting `Interaction`s for this button. You can use this to change the button's appearance or preview the button in different states. Note that if `null` is provided, interactions will still happen internally.
`content: @Composable RowScope.() -> Unit`	the content to be placed in the button

TonalLeadingButton

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
@Composable
fun TonalLeadingButton(
    onClick: () -> Unit,
    modifier: Modifier = Modifier,
    enabled: Boolean = true,
    shapes: SplitButtonShapes = leadingButtonShapesFor(SmallContainerHeight),
    colors: ButtonColors = ButtonDefaults.filledTonalButtonColors(),
    elevation: ButtonElevation? = ButtonDefaults.filledTonalButtonElevation(),
    border: BorderStroke? = null,
    contentPadding: PaddingValues = leadingButtonContentPaddingFor(SmallContainerHeight),
    interactionSource: MutableInteractionSource? = null,
    content: @Composable RowScope.() -> Unit
): Unit

Create a tonal leading button that has the same visual as a TonalButton. To create a filled, outlined, or elevated version, the default value of Button params can be passed in. For example, ElevatedButton.

The default text style for internal Text components will be set to Typography.labelLarge.

Parameters
`onClick: () -> Unit`	called when the button is clicked
`modifier: Modifier = Modifier`	the `Modifier` to be applied to this button.
`enabled: Boolean = true`	controls the enabled state of the split button. When `false`, this component will not respond to user input, and it will appear visually disabled and disabled to accessibility services.
`shapes: SplitButtonShapes = leadingButtonShapesFor(SmallContainerHeight)`	the `SplitButtonShapes` that the trailing button will morph between depending on the user's interaction with the button.
`colors: ButtonColors = ButtonDefaults.filledTonalButtonColors()`	`ButtonColors` that will be used to resolve the colors for this button in different states. See `ButtonDefaults.buttonColors`.
`elevation: ButtonElevation? = ButtonDefaults.filledTonalButtonElevation()`	`ButtonElevation` used to resolve the elevation for this button in different states. This controls the size of the shadow below the button. See `ButtonElevation.shadowElevation`.
`border: BorderStroke? = null`	the border to draw around the container of this button contentPadding the spacing values to apply internally between the container and the content
`contentPadding: PaddingValues = leadingButtonContentPaddingFor(SmallContainerHeight)`	the spacing values to apply internally between the container and the content
`interactionSource: MutableInteractionSource? = null`	an optional hoisted `MutableInteractionSource` for observing and emitting `Interaction`s for this button. You can use this to change the button's appearance or preview the button in different states. Note that if `null` is provided, interactions will still happen internally.
`content: @Composable RowScope.() -> Unit`	the content for the button.

TonalTrailingButton

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
@Composable
fun TonalTrailingButton(
    checked: Boolean,
    onCheckedChange: (Boolean) -> Unit,
    modifier: Modifier = Modifier,
    enabled: Boolean = true,
    shapes: SplitButtonShapes = trailingButtonShapesFor(SmallContainerHeight),
    colors: ButtonColors = ButtonDefaults.filledTonalButtonColors(),
    elevation: ButtonElevation? = ButtonDefaults.filledTonalButtonElevation(),
    border: BorderStroke? = null,
    contentPadding: PaddingValues = trailingButtonContentPaddingFor(SmallContainerHeight),
    interactionSource: MutableInteractionSource? = null,
    content: @Composable RowScope.() -> Unit
): Unit

Creates a tonal trailing button that has the same visual as a FilledTonalButton. When checked is updated from false to true, the buttons corners will morph to full by default. Pressed shape and checked shape can be customized via shapes param.

To create a tonal, outlined, or elevated version, the default value of Button params can be passed in. For example, ElevatedButton.

The default text style for internal Text components will be set to Typography.labelLarge.

Parameters
`checked: Boolean`	indicates whether the button is checked. This will trigger the corner morphing animation to reflect the updated state.
`onCheckedChange: (Boolean) -> Unit`	called when the button is clicked
`modifier: Modifier = Modifier`	the `Modifier` to be applied to this button.
`enabled: Boolean = true`	controls the enabled state of the split button. When `false`, this component will not respond to user input, and it will appear visually disabled and disabled to accessibility services.
`shapes: SplitButtonShapes = trailingButtonShapesFor(SmallContainerHeight)`	the `SplitButtonShapes` that the trailing button will morph between depending on the user's interaction with the button.
`colors: ButtonColors = ButtonDefaults.filledTonalButtonColors()`	`ButtonColors` that will be used to resolve the colors for this button in different states. See `ButtonDefaults.buttonColors`.
`elevation: ButtonElevation? = ButtonDefaults.filledTonalButtonElevation()`	`ButtonElevation` used to resolve the elevation for this button in different states. This controls the size of the shadow below the button. See `ButtonElevation.shadowElevation`.
`border: BorderStroke? = null`	the border to draw around the container of this button contentPadding the spacing values to apply internally between the container and the content
`contentPadding: PaddingValues = trailingButtonContentPaddingFor(SmallContainerHeight)`	the spacing values to apply internally between the container and the content
`interactionSource: MutableInteractionSource? = null`	an optional hoisted `MutableInteractionSource` for observing and emitting `Interaction`s for this button. You can use this to change the button's appearance or preview the button in different states. Note that if `null` is provided, interactions will still happen internally.
`content: @Composable RowScope.() -> Unit`	the content to be placed in the button

TrailingButton

Cmn

Added in 1.4.0-alpha15

@Composable
@ExperimentalMaterial3ExpressiveApi
fun TrailingButton(
    onClick: () -> Unit,
    modifier: Modifier = Modifier,
    enabled: Boolean = true,
    shapes: SplitButtonShapes = trailingButtonShapesFor(SmallContainerHeight),
    colors: ButtonColors = ButtonDefaults.buttonColors(),
    elevation: ButtonElevation? = ButtonDefaults.buttonElevation(),
    border: BorderStroke? = null,
    contentPadding: PaddingValues = trailingButtonContentPaddingFor(SmallContainerHeight),
    interactionSource: MutableInteractionSource? = null,
    content: @Composable RowScope.() -> Unit
): Unit

Creates a trailing button that has the same visual as a Button.

To create a tonal, outlined, or elevated version, the default value of Button params can be passed in. For example, ElevatedButton.

The default text style for internal Text components will be set to Typography.labelLarge.

Parameters
`onClick: () -> Unit`	called when the button is clicked
`modifier: Modifier = Modifier`	the `Modifier` to be applied to this button.
`enabled: Boolean = true`	controls the enabled state of the split button. When `false`, this component will not respond to user input, and it will appear visually disabled and disabled to accessibility services.
`shapes: SplitButtonShapes = trailingButtonShapesFor(SmallContainerHeight)`	the `SplitButtonShapes` that the trailing button will morph between depending on the user's interaction with the button.
`colors: ButtonColors = ButtonDefaults.buttonColors()`	`ButtonColors` that will be used to resolve the colors for this button in different states. See `ButtonDefaults.buttonColors`.
`elevation: ButtonElevation? = ButtonDefaults.buttonElevation()`	`ButtonElevation` used to resolve the elevation for this button in different states. This controls the size of the shadow below the button. See `ButtonElevation.shadowElevation`.
`border: BorderStroke? = null`	the border to draw around the container of this button contentPadding the spacing values to apply internally between the container and the content
`contentPadding: PaddingValues = trailingButtonContentPaddingFor(SmallContainerHeight)`	the spacing values to apply internally between the container and the content
`interactionSource: MutableInteractionSource? = null`	an optional hoisted `MutableInteractionSource` for observing and emitting `Interaction`s for this button. You can use this to change the button's appearance or preview the button in different states. Note that if `null` is provided, interactions will still happen internally.
`content: @Composable RowScope.() -> Unit`	the content to be placed in the button

TrailingButton

Cmn

Added in 1.4.0-alpha15

@Composable
@ExperimentalMaterial3ExpressiveApi
fun TrailingButton(
    checked: Boolean,
    onCheckedChange: (Boolean) -> Unit,
    modifier: Modifier = Modifier,
    enabled: Boolean = true,
    shapes: SplitButtonShapes = trailingButtonShapesFor(SmallContainerHeight),
    colors: ButtonColors = ButtonDefaults.buttonColors(),
    elevation: ButtonElevation? = ButtonDefaults.buttonElevation(),
    border: BorderStroke? = null,
    contentPadding: PaddingValues = trailingButtonContentPaddingFor(SmallContainerHeight),
    interactionSource: MutableInteractionSource? = null,
    content: @Composable RowScope.() -> Unit
): Unit

Creates a trailing button that has the same visual as a Button. When checked is updated from false to true, the buttons corners will morph to full by default. Pressed shape and checked shape can be customized via shapes param.

To create a tonal, outlined, or elevated version, the default value of Button params can be passed in. For example, ElevatedButton.

The default text style for internal Text components will be set to Typography.labelLarge.

Parameters
`checked: Boolean`	indicates whether the button is checked. This will trigger the corner morphing animation to reflect the updated state.
`onCheckedChange: (Boolean) -> Unit`	called when the button is clicked
`modifier: Modifier = Modifier`	the `Modifier` to be applied to this button.
`enabled: Boolean = true`	controls the enabled state of the split button. When `false`, this component will not respond to user input, and it will appear visually disabled and disabled to accessibility services.
`shapes: SplitButtonShapes = trailingButtonShapesFor(SmallContainerHeight)`	the `SplitButtonShapes` that the trailing button will morph between depending on the user's interaction with the button.
`colors: ButtonColors = ButtonDefaults.buttonColors()`	`ButtonColors` that will be used to resolve the colors for this button in different states. See `ButtonDefaults.buttonColors`.
`elevation: ButtonElevation? = ButtonDefaults.buttonElevation()`	`ButtonElevation` used to resolve the elevation for this button in different states. This controls the size of the shadow below the button. See `ButtonElevation.shadowElevation`.
`border: BorderStroke? = null`	the border to draw around the container of this button contentPadding the spacing values to apply internally between the container and the content
`contentPadding: PaddingValues = trailingButtonContentPaddingFor(SmallContainerHeight)`	the spacing values to apply internally between the container and the content
`interactionSource: MutableInteractionSource? = null`	an optional hoisted `MutableInteractionSource` for observing and emitting `Interaction`s for this button. You can use this to change the button's appearance or preview the button in different states. Note that if `null` is provided, interactions will still happen internally.
`content: @Composable RowScope.() -> Unit`	the content to be placed in the button

leadingButtonContentPaddingFor

Cmn

fun leadingButtonContentPaddingFor(buttonHeight: Dp): PaddingValues

Recommended PaddingValues for a provided leading button height.

Parameters
`buttonHeight: Dp`	The height of the button

leadingButtonIconSizeFor

Cmn

fun leadingButtonIconSizeFor(buttonHeight: Dp): Dp

Recommended leading button Icon size for a provided button height.

Parameters
`buttonHeight: Dp`	The height of the button

leadingButtonShapesFor

Cmn

@Composable
@ExperimentalMaterial3ExpressiveApi
fun leadingButtonShapesFor(buttonHeight: Dp): SplitButtonShapes

Recommended leading button SplitButtonShapes for a provided leading button height.

Parameters
`buttonHeight: Dp`	The height of the button

trailingButtonContentPaddingFor

Cmn

fun trailingButtonContentPaddingFor(buttonHeight: Dp): PaddingValues

Recommended PaddingValues for a provided trailing button height.

Parameters
`buttonHeight: Dp`	The height of the button

trailingButtonIconSizeFor

Cmn

fun trailingButtonIconSizeFor(buttonHeight: Dp): Dp

Recommended trailing button Icon size for a provided button height.

Parameters
`buttonHeight: Dp`	The height of the button

trailingButtonShapesFor

Cmn

@Composable
@ExperimentalMaterial3ExpressiveApi
fun trailingButtonShapesFor(buttonHeight: Dp): SplitButtonShapes

Recommended trailing button SplitButtonShapes for a provided trailing button height.

Parameters
`buttonHeight: Dp`	The height of the button

Public properties

ExtraLargeContainerHeight

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
val ExtraLargeContainerHeight: Dp

The default height for an extra large button container.

ExtraLargeInnerCornerSize

Cmn

Added in 1.4.0-alpha15

val ExtraLargeInnerCornerSize: CornerSize

Default extra large size for the leading button end corners and trailing button start corners

ExtraLargeInnerCornerSizePressed

Cmn

Added in 1.4.0-alpha15

val ExtraLargeInnerCornerSizePressed: CornerSize

Default extra large size for the leading button end corners and trailing button start corners when pressed

ExtraLargeLeadingButtonContentPadding

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
val ExtraLargeLeadingButtonContentPadding: PaddingValues

Default content padding of the extra large leading button

ExtraLargeTrailingButtonContentPadding

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
val ExtraLargeTrailingButtonContentPadding: PaddingValues

Default content padding of the extra large trailing button

ExtraLargeTrailingButtonIconSize

Cmn

Added in 1.4.0-alpha15

val ExtraLargeTrailingButtonIconSize: Dp

The default size of the icon used inside of an extra large trailing button of a split button.

ExtraSmallContainerHeight

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
val ExtraSmallContainerHeight: Dp

The default height for an extra small button container.

ExtraSmallInnerCornerSize

Cmn

Added in 1.4.0-alpha15

val ExtraSmallInnerCornerSize: CornerSize

Default extra small size for the leading button end corners and trailing button start corners

ExtraSmallInnerCornerSizePressed

Cmn

Added in 1.4.0-alpha15

val ExtraSmallInnerCornerSizePressed: CornerSize

Default extra small size for the leading button end corners and trailing button start corners when pressed

ExtraSmallLeadingButtonContentPadding

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
val ExtraSmallLeadingButtonContentPadding: PaddingValues

Default content padding of the extra small leading button

ExtraSmallTrailingButtonContentPadding

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
val ExtraSmallTrailingButtonContentPadding: PaddingValues

Default content padding of the extra small trailing button

ExtraSmallTrailingButtonIconSize

Cmn

Added in 1.4.0-alpha15

val ExtraSmallTrailingButtonIconSize: Dp

The default size of the icon used inside of an extra small trailing button of a split button.

LargeContainerHeight

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
val LargeContainerHeight: Dp

The default height for a large button container.

LargeInnerCornerSize

Cmn

Added in 1.4.0-alpha15

val LargeInnerCornerSize: CornerSize

Default large size for the leading button end corners and trailing button start corners

LargeInnerCornerSizePressed

Cmn

Added in 1.4.0-alpha15

val LargeInnerCornerSizePressed: CornerSize

Default large size for the leading button end corners and trailing button start corners when pressed

LargeLeadingButtonContentPadding

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
val LargeLeadingButtonContentPadding: PaddingValues

Default content padding of the large leading button

LargeTrailingButtonContentPadding

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
val LargeTrailingButtonContentPadding: PaddingValues

Default content padding of the large trailing button

LargeTrailingButtonIconSize

Cmn

Added in 1.4.0-alpha15

val LargeTrailingButtonIconSize: Dp

The default size of the icon used inside of an large trailing button of a split button.

LeadingIconSize

Cmn

Added in 1.4.0-alpha15

val LeadingIconSize: Dp

Default icon size for the leading button

MediumContainerHeight

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
val MediumContainerHeight: Dp

The default height for a medium button container.

MediumInnerCornerSize

Cmn

Added in 1.4.0-alpha15

val MediumInnerCornerSize: CornerSize

Default medium size for the leading button end corners and trailing button start corners

MediumInnerCornerSizePressed

Cmn

Added in 1.4.0-alpha15

val MediumInnerCornerSizePressed: CornerSize

Default medium size for the leading button end corners and trailing button start corners when pressed

MediumLeadingButtonContentPadding

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
val MediumLeadingButtonContentPadding: PaddingValues

Default content padding of the medium leading button

MediumTrailingButtonContentPadding

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
val MediumTrailingButtonContentPadding: PaddingValues

Default content padding of the medium trailing button

MediumTrailingButtonIconSize

Cmn

Added in 1.4.0-alpha15

val MediumTrailingButtonIconSize: Dp

The default size of the icon used inside of an medium trailing button of a split button.

OuterCornerSize

Cmn

Added in 1.4.0-alpha15

val OuterCornerSize: CornerSize

Default percentage size for the leading button start corners and trailing button end corners

SmallContainerHeight

Cmn

Added in 1.4.0-alpha15

val SmallContainerHeight: Dp

Default minimum height of the split button. This applies to both LeadingButton and TrailingButton. Applies to all 4 variants of the split button

SmallInnerCornerSize

Cmn

Added in 1.4.0-alpha15

val SmallInnerCornerSize: CornerSize

Default small size for the leading button end corners and trailing button start corners

SmallInnerCornerSizePressed

Cmn

Added in 1.4.0-alpha15

val SmallInnerCornerSizePressed: CornerSize

Default small size for the leading button end corners and trailing button start corners when pressed

SmallLeadingButtonContentPadding

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
val SmallLeadingButtonContentPadding: PaddingValues

Default content padding of the small leading button

SmallTrailingButtonContentPadding

Cmn

Added in 1.4.0-alpha15

@ExperimentalMaterial3ExpressiveApi
val SmallTrailingButtonContentPadding: PaddingValues

Default content padding of the small trailing button

SmallTrailingButtonIconSize

Cmn

Added in 1.4.0-alpha15

val SmallTrailingButtonIconSize: Dp

The default size of the icon used inside of an small trailing button of a split button.

Spacing

Cmn

Added in 1.4.0-alpha15

val Spacing: Dp

Default spacing between the leading and trailing button

TrailingIconSize

Cmn

Added in 1.4.0-alpha15

val TrailingIconSize: Dp

Default icon size for the trailing button