TextButtonDefaults

Artifact: androidx.wear.compose:compose-material3

object TextButtonDefaults

Contains the default values used by TextButton.

Summary

Public functions
`TextButtonShapes`	`@Composable animatedShapes(shape: CornerBasedShape, pressedShape: CornerBasedShape)` Creates a `Shape` with a animation between two CornerBasedShapes.
`TextButtonColors`	`@Composable filledTextButtonColors()` Creates a `TextButtonColors` with the colors for a filled `TextButton`- by default, a colored background with a contrasting content color.
`TextButtonColors`	`@Composable filledTextButtonColors( containerColor: Color, contentColor: Color, disabledContainerColor: Color, disabledContentColor: Color )` Creates a `TextButtonColors` with the colors for a filled `TextButton`- by default, a colored background with a contrasting content color.
`TextButtonColors`	`@Composable filledTonalTextButtonColors()` Creates a `TextButtonColors` with the colors for a filled, tonal `TextButton`- by default, a muted colored background with a contrasting content color.
`TextButtonColors`	`@Composable filledTonalTextButtonColors( containerColor: Color, contentColor: Color, disabledContainerColor: Color, disabledContentColor: Color )` Creates a `TextButtonColors` with the colors for a filled, tonal `TextButton`- by default, a muted colored background with a contrasting content color.
`TextButtonColors`	`@Composable filledVariantTextButtonColors()` Creates a `TextButtonColors` as an alternative to the filledTonal TextButtonColors, giving a surface with more chroma to indicate selected or highlighted states that are not primary calls-to-action.
`TextButtonColors`	`@Composable filledVariantTextButtonColors( containerColor: Color, contentColor: Color, disabledContainerColor: Color, disabledContentColor: Color )` Creates a `TextButtonColors` as an alternative to the filledTonal TextButtonColors, giving a surface with more chroma to indicate selected or highlighted states that are not primary calls-to-action.
`TextButtonColors`	`@Composable outlinedTextButtonColors()` Creates a `TextButtonColors` with the colors for an outlined `TextButton`- by default, a transparent background with contrasting content color.
`TextButtonColors`	`@Composable outlinedTextButtonColors( contentColor: Color, disabledContentColor: Color )` Creates a `TextButtonColors` with the colors for an outlined `TextButton`- by default, a transparent background with contrasting content color.
`TextButtonShapes`	`@Composable shapes(shape: Shape)` Creates a `TextButtonShapes` with a static `shape`.
`TextButtonColors`	`@Composable textButtonColors()` Creates a `TextButtonColors` for a text button - by default, a transparent background with contrasting content color.
`TextButtonColors`	`@Composable textButtonColors( containerColor: Color, contentColor: Color, disabledContainerColor: Color, disabledContentColor: Color )` Creates a `TextButtonColors` for a text button - by default, a transparent background with contrasting content color.

Public properties
`Dp`	`DefaultButtonSize` The default size applied for buttons.
`Dp`	`LargeButtonSize` The recommended size for a large button.
`Dp`	`SmallButtonSize` The recommended size for a small button.
`TextStyle`	`defaultButtonTextStyle` The default text style applied for buttons.
`TextStyle`	`largeButtonTextStyle` The recommended text style for a large button.
`CornerBasedShape`	`pressedShape` Recommended pressed `Shape` for `TextButton`.
`RoundedCornerShape`	`shape` Recommended `Shape` for `TextButton`.
`TextStyle`	`smallButtonTextStyle` The recommended text style for a small button.

Public functions

animatedShapes

Added in 1.0.0-alpha29

@Composable
fun animatedShapes(
    shape: CornerBasedShape = TextButtonDefaults.shape,
    pressedShape: CornerBasedShape = TextButtonDefaults.pressedShape
): TextButtonShapes

Creates a Shape with a animation between two CornerBasedShapes.

A simple text button using the default colors, animated when pressed.

import androidx.wear.compose.material3.ButtonDefaults
import androidx.wear.compose.material3.Text
import androidx.wear.compose.material3.TextButton
import androidx.wear.compose.material3.TextButtonDefaults

TextButton(
    onClick = { /* Do something */ },
    shapes = TextButtonDefaults.animatedShapes(),
) {
    Text(text = "ABC")
}

Parameters
`shape: CornerBasedShape = TextButtonDefaults.shape`	The normal shape of the TextButton.
`pressedShape: CornerBasedShape = TextButtonDefaults.pressedShape`	The pressed shape of the TextButton.

filledTextButtonColors

Added in 1.0.0-alpha29

@Composable
fun filledTextButtonColors(): TextButtonColors

Creates a TextButtonColors with the colors for a filled TextButton- by default, a colored background with a contrasting content color. If the text button is disabled then the colors will default to ColorScheme.onSurface with suitable alpha values applied.

filledTextButtonColors

@Composable
fun filledTextButtonColors(
    containerColor: Color = Color.Unspecified,
    contentColor: Color = Color.Unspecified,
    disabledContainerColor: Color = Color.Unspecified,
    disabledContentColor: Color = Color.Unspecified
): TextButtonColors

Example of TextButton with filledTextButtonColors:

import androidx.wear.compose.material3.ButtonDefaults
import androidx.wear.compose.material3.Text
import androidx.wear.compose.material3.TextButton
import androidx.wear.compose.material3.TextButtonDefaults

TextButton(
    onClick = { /* Do something */ },
    colors = TextButtonDefaults.filledTextButtonColors()
) {
    Text(text = "ABC")
}

Parameters
`containerColor: Color = Color.Unspecified`	The background color of this text button when enabled
`contentColor: Color = Color.Unspecified`	The content color of this text button when enabled
`disabledContainerColor: Color = Color.Unspecified`	the background color of this text button when not enabled
`disabledContentColor: Color = Color.Unspecified`	the content color of this text button when not enabled

filledTonalTextButtonColors

Added in 1.0.0-alpha29

@Composable
fun filledTonalTextButtonColors(): TextButtonColors

Creates a TextButtonColors with the colors for a filled, tonal TextButton- by default, a muted colored background with a contrasting content color. If the text button is disabled then the colors will default to ColorScheme.onSurface with suitable alpha values applied.

filledTonalTextButtonColors

@Composable
fun filledTonalTextButtonColors(
    containerColor: Color = Color.Unspecified,
    contentColor: Color = Color.Unspecified,
    disabledContainerColor: Color = Color.Unspecified,
    disabledContentColor: Color = Color.Unspecified
): TextButtonColors

Example of TextButton with filledTonalTextButtonColors:

import androidx.wear.compose.material3.ButtonDefaults
import androidx.wear.compose.material3.Text
import androidx.wear.compose.material3.TextButton
import androidx.wear.compose.material3.TextButtonDefaults

TextButton(
    onClick = { /* Do something */ },
    colors = TextButtonDefaults.filledTonalTextButtonColors()
) {
    Text(text = "ABC")
}

Parameters
`containerColor: Color = Color.Unspecified`	The background color of this text button when enabled
`contentColor: Color = Color.Unspecified`	The content color of this text button when enabled
`disabledContainerColor: Color = Color.Unspecified`	the background color of this text button when not enabled
`disabledContentColor: Color = Color.Unspecified`	the content color of this text button when not enabled

filledVariantTextButtonColors

Added in 1.0.0-alpha29

@Composable
fun filledVariantTextButtonColors(): TextButtonColors

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

Example of creating a TextButton with filledVariantTextButtonColors:

import androidx.wear.compose.material3.ButtonDefaults
import androidx.wear.compose.material3.Text
import androidx.wear.compose.material3.TextButton
import androidx.wear.compose.material3.TextButtonDefaults

TextButton(
    onClick = { /* Do something */ },
    colors = TextButtonDefaults.filledVariantTextButtonColors()
) {
    Text(text = "ABC")
}

filledVariantTextButtonColors

@Composable
fun filledVariantTextButtonColors(
    containerColor: Color = Color.Unspecified,
    contentColor: Color = Color.Unspecified,
    disabledContainerColor: Color = Color.Unspecified,
    disabledContentColor: Color = Color.Unspecified
): TextButtonColors

Example of creating a TextButton with filledVariantTextButtonColors:

import androidx.wear.compose.material3.ButtonDefaults
import androidx.wear.compose.material3.Text
import androidx.wear.compose.material3.TextButton
import androidx.wear.compose.material3.TextButtonDefaults

TextButton(
    onClick = { /* Do something */ },
    colors = TextButtonDefaults.filledVariantTextButtonColors()
) {
    Text(text = "ABC")
}

Parameters
`containerColor: Color = Color.Unspecified`	The background color of this text button when enabled
`contentColor: Color = Color.Unspecified`	The content color of this text button when enabled
`disabledContainerColor: Color = Color.Unspecified`	the background color of this text button when not enabled
`disabledContentColor: Color = Color.Unspecified`	the content color of this text button when not enabled

outlinedTextButtonColors

Added in 1.0.0-alpha29

@Composable
fun outlinedTextButtonColors(): TextButtonColors

Creates a TextButtonColors with the colors for an outlined TextButton- by default, a transparent background with contrasting content color. If the button is disabled, then the colors will default to ColorScheme.onSurface with suitable alpha values applied.

outlinedTextButtonColors

@Composable
fun outlinedTextButtonColors(
    contentColor: Color = Color.Unspecified,
    disabledContentColor: Color = Color.Unspecified
): TextButtonColors

Example of TextButton with outlinedTextButtonColors and ButtonDefaults.outlinedButtonBorder:

import androidx.wear.compose.material3.ButtonDefaults
import androidx.wear.compose.material3.Text
import androidx.wear.compose.material3.TextButton
import androidx.wear.compose.material3.TextButtonDefaults

TextButton(
    onClick = { /* Do something */ },
    colors = TextButtonDefaults.outlinedTextButtonColors(),
    border = ButtonDefaults.outlinedButtonBorder(enabled = true)
) {
    Text(text = "ABC")
}

Parameters
`contentColor: Color = Color.Unspecified`	The content color of this text button when enabled
`disabledContentColor: Color = Color.Unspecified`	The content color of this text button when not enabled

shapes

Added in 1.0.0-alpha29

@Composable
fun shapes(shape: Shape = TextButtonDefaults.shape): TextButtonShapes

Creates a TextButtonShapes with a static shape.

Parameters
`shape: Shape = TextButtonDefaults.shape`	The normal shape of the TextButton.

textButtonColors

Added in 1.0.0-alpha29

@Composable
fun textButtonColors(): TextButtonColors

Creates a TextButtonColors for a text button - by default, a transparent background with contrasting content color. If the button is disabled then the colors default to ColorScheme.onSurface with suitable alpha values applied.

textButtonColors

@Composable
fun textButtonColors(
    containerColor: Color = Color.Transparent,
    contentColor: Color = Color.Unspecified,
    disabledContainerColor: Color = Color.Transparent,
    disabledContentColor: Color = Color.Unspecified
): TextButtonColors

Parameters
`containerColor: Color = Color.Transparent`	the background color of this text button when enabled
`contentColor: Color = Color.Unspecified`	the content color of this text button when enabled
`disabledContainerColor: Color = Color.Transparent`	the background color of this text button when not enabled
`disabledContentColor: Color = Color.Unspecified`	the content color of this text button when not enabled