TextButton

Functions summary

`Unit`	`@Composable TextButton( onClick: () -> Unit, modifier: Modifier, enabled: Boolean, shape: Shape, colors: ButtonColors, elevation: ButtonElevation?, border: BorderStroke?, contentPadding: PaddingValues, interactionSource: MutableInteractionSource?, content: @Composable RowScope.() -> Unit )` Material Design text button	Cmn
`Unit`	`@ExperimentalMaterial3ExpressiveApi @Composable TextButton( onClick: () -> Unit, shapes: ButtonShapes, modifier: Modifier, enabled: Boolean, colors: ButtonColors, elevation: ButtonElevation?, border: BorderStroke?, contentPadding: PaddingValues, interactionSource: MutableInteractionSource?, content: @Composable RowScope.() -> Unit )` Material Design text button	Cmn

Functions

TextButton

Cmn

Artifact: androidx.compose.material3:material3

View Source

Added in 1.0.0

@Composable
fun TextButton(
    onClick: () -> Unit,
    modifier: Modifier = Modifier,
    enabled: Boolean = true,
    shape: Shape = ButtonDefaults.textShape,
    colors: ButtonColors = ButtonDefaults.textButtonColors(),
    elevation: ButtonElevation? = null,
    border: BorderStroke? = null,
    contentPadding: PaddingValues = ButtonDefaults.TextButtonContentPadding,
    interactionSource: MutableInteractionSource? = null,
    content: @Composable RowScope.() -> Unit
): Unit

Material Design text button

Buttons help people initiate actions, from sending an email, to sharing a document, to liking a post.

Text buttons are typically used for less-pronounced actions, including those located in dialogs and cards. In cards, text buttons help maintain an emphasis on card content. Text buttons are used for the lowest priority actions, especially when presenting multiple options.

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

TextButton(onClick = {}, shapes = ButtonDefaults.shapes()) { Text("Text Button") }

Choose the best button for an action based on the amount of emphasis it needs. The more important an action is, the higher emphasis its button should be.

See Button for a high-emphasis button without a shadow, also known as a filled button.
See ElevatedButton for a FilledTonalButton with a shadow.
See FilledTonalButton for a middle ground between OutlinedButton and Button.
See OutlinedButton for a medium-emphasis button with a border.

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

Parameters
`onClick: () -> Unit`	called when this button is clicked
`modifier: Modifier = Modifier`	the `Modifier` to be applied to this button
`enabled: Boolean = true`	controls the enabled state of this button. When `false`, this component will not respond to user input, and it will appear visually disabled and disabled to accessibility services.
`shape: Shape = ButtonDefaults.textShape`	defines the shape of this button's container, border (when `border` is not null), and shadow (when using `elevation`)
`colors: ButtonColors = ButtonDefaults.textButtonColors()`	`ButtonColors` that will be used to resolve the colors for this button in different states. See `ButtonDefaults.textButtonColors`.
`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. Additionally, when the container color is `ColorScheme.surface`, this controls the amount of primary color applied as an overlay. A TextButton typically has no elevation, and the default value is `null`. See `ElevatedButton` for a button with elevation.
`border: BorderStroke? = null`	the border to draw around the container of this button
`contentPadding: PaddingValues = ButtonDefaults.TextButtonContentPadding`	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 displayed on the button, expected to be text.

TextButton

Cmn

Artifact: androidx.compose.material3:material3

View Source

@ExperimentalMaterial3ExpressiveApi
@Composable
fun TextButton(
    onClick: () -> Unit,
    shapes: ButtonShapes,
    modifier: Modifier = Modifier,
    enabled: Boolean = true,
    colors: ButtonColors = ButtonDefaults.textButtonColors(),
    elevation: ButtonElevation? = null,
    border: BorderStroke? = null,
    contentPadding: PaddingValues = ButtonDefaults.contentPaddingFor(ButtonDefaults.MinHeight),
    interactionSource: MutableInteractionSource? = null,
    content: @Composable RowScope.() -> Unit
): Unit

Material Design text button

Buttons help people initiate actions, from sending an email, to sharing a document, to liking a post. It also morphs between the shapes provided in shapes depending on the state of the interaction with the button as long as the shapes provided our CornerBasedShapes. If a shape in shapes isn't a CornerBasedShape, then button will change between the ButtonShapes according to user interaction.

import androidx.compose.material3.Button
import androidx.compose.material3.Text
import androidx.compose.material3.TextButton

TextButton(onClick = { /* Do something! */ }) { Text("Text Button") }

Choose the best button for an action based on the amount of emphasis it needs. The more important an action is, the higher emphasis its button should be.

See Button for a high-emphasis button without a shadow, also known as a filled button.
See ElevatedButton for a FilledTonalButton with a shadow.
See FilledTonalButton for a middle ground between OutlinedButton and Button.
See OutlinedButton for a medium-emphasis button with a border.

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

Parameters
`onClick: () -> Unit`	called when this button is clicked
`shapes: ButtonShapes`	the `ButtonShapes` that this button with morph between depending on the user's interaction with the button.
`modifier: Modifier = Modifier`	the `Modifier` to be applied to this button
`enabled: Boolean = true`	controls the enabled state of this button. When `false`, this component will not respond to user input, and it will appear visually disabled and disabled to accessibility services.
`colors: ButtonColors = ButtonDefaults.textButtonColors()`	`ButtonColors` that will be used to resolve the colors for this button in different states. See `ButtonDefaults.textButtonColors`.
`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. Additionally, when the container color is `ColorScheme.surface`, this controls the amount of primary color applied as an overlay. A TextButton typically has no elevation, and the default value is `null`. See `ElevatedButton` for a button with elevation.
`border: BorderStroke? = null`	the border to draw around the container of this button
`contentPadding: PaddingValues = ButtonDefaults.contentPaddingFor(ButtonDefaults.MinHeight)`	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 displayed on the button, expected to be text.