ButtonDefaults

@Composable
fun buttonColors(): ButtonColors

Creates a ButtonColors that represents the default background and content colors used in a Button.

@Composable
fun buttonColors(
    containerColor: Color = Color.Unspecified,
    contentColor: Color = Color.Unspecified,
    secondaryContentColor: Color = Color.Unspecified,
    iconColor: Color = Color.Unspecified,
    disabledContainerColor: Color = Color.Unspecified,
    disabledContentColor: Color = Color.Unspecified,
    disabledSecondaryContentColor: Color = Color.Unspecified,
    disabledIconColor: Color = Color.Unspecified
): ButtonColors

Creates a ButtonColors that represents the default background and content colors used in a Button.

@Composable
fun childButtonColors(): ButtonColors

Creates a ButtonColors with transparent background, the defaults for low emphasis buttons like ChildButton. Use childButtonColors for optional or supplementary actions with the least amount of prominence.

If a button is disabled then the content will have an alpha(DisabledContentAlpha) value applied and container will have an alpha(DisabledContainerAlpha) value applied.

@Composable
fun childButtonColors(
    contentColor: Color = Color.Unspecified,
    secondaryContentColor: Color = Color.Unspecified,
    iconColor: Color = Color.Unspecified,
    disabledContentColor: Color = Color.Unspecified,
    disabledSecondaryContentColor: Color = Color.Unspecified,
    disabledIconColor: Color = Color.Unspecified
): ButtonColors

Creates a ButtonColors with transparent background, the defaults for low emphasis buttons like ChildButton. Use childButtonColors for optional or supplementary actions with the least amount of prominence.

If a button is disabled then the content will have an alpha(DisabledContentAlpha) value applied and container will have an alpha(DisabledContainerAlpha) value applied.

@Composable
fun filledTonalButtonColors(): ButtonColors

Creates a ButtonColors with a muted background and contrasting content color, the defaults for medium emphasis buttons like FilledTonalButton. Use filledTonalButtonColors for important actions that don't distract from other onscreen elements, such as final or unblocking actions in a flow with less emphasis than buttonColors.

If a button is disabled then the content will have an alpha(DisabledContentAlpha) value applied and container will have alpha (DisabledContainerAlpha) value applied.

@Composable
fun filledTonalButtonColors(
    containerColor: Color = Color.Unspecified,
    contentColor: Color = Color.Unspecified,
    secondaryContentColor: Color = Color.Unspecified,
    iconColor: Color = Color.Unspecified,
    disabledContainerColor: Color = Color.Unspecified,
    disabledContentColor: Color = Color.Unspecified,
    disabledSecondaryContentColor: Color = Color.Unspecified,
    disabledIconColor: Color = Color.Unspecified
): ButtonColors

Creates a ButtonColors with a muted background and contrasting content color, the defaults for medium emphasis buttons like FilledTonalButton. Use filledTonalButtonColors for important actions that don't distract from other onscreen elements, such as final or unblocking actions in a flow with less emphasis than buttonColors.

If a button is disabled then the content will have an alpha(DisabledContentAlpha) value applied and container will have alpha (DisabledContainerAlpha) value applied.

@Composable
fun filledVariantButtonColors(): ButtonColors

Creates a ButtonColors as an alternative to the filledTonalButtonColors, giving a surface with more chroma to indicate selected or highlighted states that are not primary calls-to-action. If the icon button is disabled then the colors will default to the MaterialTheme onSurface color with suitable alpha values applied.

If a button is disabled then the content will have an alpha(DisabledContentAlpha) value applied and container will have alpha (DisabledContainerAlpha) value applied.

Example of a Button with filledVariantButtonColors:

import androidx.wear.compose.material3.Button
import androidx.wear.compose.material3.ButtonDefaults
import androidx.wear.compose.material3.Text

Button(
    onClick = { /* Do something */ },
    colors = ButtonDefaults.filledVariantButtonColors(),
    label = { Text("Filled Variant Button") },
    modifier = modifier,
)

@Composable
fun filledVariantButtonColors(
    containerColor: Color = Color.Unspecified,
    contentColor: Color = Color.Unspecified,
    secondaryContentColor: Color = Color.Unspecified,
    iconColor: Color = Color.Unspecified,
    disabledContainerColor: Color = Color.Unspecified,
    disabledContentColor: Color = Color.Unspecified,
    disabledSecondaryContentColor: Color = Color.Unspecified,
    disabledIconColor: Color = Color.Unspecified
): ButtonColors

Creates a ButtonColors as an alternative to the filledTonalButtonColors, giving a surface with more chroma to indicate selected or highlighted states that are not primary calls-to-action. If the icon button is disabled then the colors will default to the MaterialTheme onSurface color with suitable alpha values applied.

If a button is disabled then the content will have an alpha(DisabledContentAlpha) value applied and container will have alpha (DisabledContainerAlpha) value applied.

Example of a Button with filledVariantButtonColors:

import androidx.compose.foundation.layout.size
import androidx.compose.ui.Modifier
import androidx.compose.ui.res.painterResource
import androidx.wear.compose.material3.Button
import androidx.wear.compose.material3.ButtonDefaults
import androidx.wear.compose.material3.Icon
import androidx.wear.compose.material3.Text

Button(
    onClick = { /* Do something */ },
    colors = ButtonDefaults.filledVariantButtonColors(),
    label = { Text("Filled Variant Button") },
    secondaryLabel = { Text("Secondary label") },
    icon = {
        Icon(
            painter = painterResource(R.drawable.ic_favorite_rounded),
            contentDescription = "Favorite icon",
            modifier = Modifier.size(ButtonDefaults.IconSize)
        )
    },
    modifier = modifier
)

@Composable
fun imageBackgroundButtonColors(
    backgroundImagePainter: Painter,
    backgroundImageScrimBrush: Brush = Brush.linearGradient(
                colors =
                    listOf(
                        ImageButtonTokens.BackgroundImageGradientColor.value.copy(
                            alpha = ImageButtonTokens.GradientStartOpacity
                        ),
                        ImageButtonTokens.BackgroundImageGradientColor.value.copy(
                            alpha = ImageButtonTokens.GradientEndOpacity
                        )
                    )
            ),
    contentColor: Color = ImageButtonTokens.ContentColor.value,
    secondaryContentColor: Color = ImageButtonTokens.SecondaryContentColor.value.copy(
                alpha = ImageButtonTokens.SecondaryContentOpacity
            ),
    iconColor: Color = ImageButtonTokens.IconColor.value,
    disabledContentColor: Color = ImageButtonTokens.DisabledContentColor.value.toDisabledColor(
                disabledAlpha = ImageButtonTokens.DisabledContentOpacity
            ),
    disabledSecondaryContentColor: Color = ImageButtonTokens.DisabledContentColor.value.toDisabledColor(
                disabledAlpha = ImageButtonTokens.DisabledContentOpacity
            ),
    disabledIconColor: Color = ImageButtonTokens.DisabledContentColor.value.toDisabledColor(
                disabledAlpha = ImageButtonTokens.DisabledContentOpacity
            ),
    forcedSize: Size? = Size.Unspecified
): ButtonColors

Creates a ButtonColors for a Button with an image background, typically with a scrim over the image to ensure that the content is visible. Uses a default content color of ColorScheme.onBackground.

@Composable
fun outlinedButtonBorder(
    enabled: Boolean,
    borderColor: Color = OutlinedButtonTokens.ContainerBorderColor.value,
    disabledBorderColor: Color = OutlinedButtonTokens.DisabledContainerBorderColor.value.toDisabledColor(
                disabledAlpha = OutlinedButtonTokens.DisabledContainerBorderOpacity
            ),
    borderWidth: Dp = OutlinedButtonTokens.ContainerBorderWidth
): BorderStroke

Creates a BorderStroke, such as for an OutlinedButton

@Composable
fun outlinedButtonColors(): ButtonColors

Creates a ButtonColors with a transparent background (typically paired with ButtonDefaults.outlinedButtonBorder), the defaults for medium emphasis buttons like OutlinedButton, for important, non-primary actions that need attention.

If a button is disabled then the content will have an alpha(DisabledContentAlpha) value applied and container will have an alpha(DisabledContainerAlpha) applied.

@Composable
fun outlinedButtonColors(
    contentColor: Color = Color.Unspecified,
    secondaryContentColor: Color = Color.Unspecified,
    iconColor: Color = Color.Unspecified,
    disabledContentColor: Color = Color.Unspecified,
    disabledSecondaryContentColor: Color = Color.Unspecified,
    disabledIconColor: Color = Color.Unspecified
): ButtonColors

Creates a ButtonColors with a transparent background (typically paired with ButtonDefaults.outlinedButtonBorder), the defaults for medium emphasis buttons like OutlinedButton, for important, non-primary actions that need attention.

If a button is disabled then the content will have an alpha(DisabledContentAlpha) value applied and container will have an alpha(DisabledContainerAlpha) applied.

val ButtonExtraLargeIconStartPadding: Dp

The recommended start padding to be used with Button with an extra large icon

val ButtonHorizontalPadding: Dp

The recommended horizontal padding used by Button by default

val ButtonLargeIconStartPadding: Dp

The recommended start padding to be used with Button with a large icon

val ButtonVerticalPadding: Dp

The recommended vertical padding used by Button by default

val ButtonWithExtraLargeIconContentPadding: PaddingValues

The default content padding used by Button with an extra large icon

val ButtonWithLargeIconContentPadding: PaddingValues

The default content padding used by Button with a large icon

val CompactButtonContentPadding: PaddingValues

The default content padding used by CompactButton

val CompactButtonHeight: Dp

The height applied for the CompactButton. This includes a visible button height of 32.dp and 8.dp of padding above and below the button in order to meet accessibility guidelines that request a minimum of 48.dp height and width of tappable area.

Note that you can override it by adjusting Modifier.height and Modifier.padding directly on CompactButton.

val CompactButtonHorizontalPadding: Dp

val CompactButtonTapTargetPadding: PaddingValues

The default padding to be provided around a CompactButton in order to ensure that its tappable area meets minimum UX guidance.

val CompactButtonVerticalPadding: Dp

val ContentPadding: PaddingValues

The default content padding used by Button

val EdgeButtonHeightExtraSmall: Dp

The height to be applied for an extra small EdgeButton.

val EdgeButtonHeightLarge: Dp

The height to be applied for a large EdgeButton.

val EdgeButtonHeightMedium: Dp

The height to be applied for a medium EdgeButton.

val EdgeButtonHeightSmall: Dp

The height to be applied for a small EdgeButton.

val ExtraLargeIconSize: Dp

The recommended icon size when used in Buttons for icons such as an avatar icon

val Height: Dp

The default height applied for the Button. Note that you can override it by applying Modifier.heightIn directly on Button.

val IconSize: Dp

The default size of the icon when used inside a Button.

val LargeIconSize: Dp

The recommended icon size when used in Buttons for icons such as an app icon

val SmallIconSize: Dp

The size of the icon when used inside a "CompactButton.

val compactButtonShape: Shape

Recommended Shape for CompactButton.

val shape: Shape

Recommended Shape for Button.