FilledButton

Composable Function

Android

@Composable
fun FilledButton(
    text: String,
    onClick: () -> Unit,
    modifier: GlanceModifier = GlanceModifier,
    enabled: Boolean = true,
    icon: ImageProvider? = null,
    colors: ButtonColors = ButtonDefaults.buttonColors(),
    maxLines: Int = Int.MAX_VALUE,
    key: String? = null
) =
    FilledButton(
        text = text,
        onClick = action(block = onClick, key = key),
        modifier = modifier,
        enabled = enabled,
        icon = icon,
        colors = colors,
        maxLines = maxLines,
    )

A button styled per Material3. It has a filled background. It is more opinionated than Button and suitable for uses where M3 is preferred.

Parameters


text	The text that this button will show.
onClick	The action to be performed when this button is clicked.
modifier	The modifier to be applied to this button.
enabled	If false, the button will not be clickable.
icon	An optional leading icon placed before the text.
colors	The colors to use for the background and content of the button.
maxLines	An optional maximum number of lines for the text to span, wrapping if necessary. If the text exceeds the given number of lines, it will be truncated.
key	A stable and unique key that identifies the action for this button. This ensures that the correct action is triggered, especially in cases of items that change order. If not provided we use the key that is automatically generated by the Compose runtime, which is unique for every exact code location in the composition tree.

Android

@Composable
fun FilledButton(
    text: String,
    onClick: Action,
    modifier: GlanceModifier = GlanceModifier,
    enabled: Boolean = true,
    icon: ImageProvider? = null,
    colors: ButtonColors = ButtonDefaults.buttonColors(),
    maxLines: Int = Int.MAX_VALUE,
) =
    M3TextButton(
        text = text,
        modifier = modifier,
        enabled = enabled,
        icon = icon,
        contentColor = colors.contentColor,
        backgroundTint = colors.backgroundColor,
        backgroundResource = R.drawable.glance_component_btn_filled,
        onClick = onClick,
        maxLines = maxLines,
    )

A button styled per Material3. It has a filled background. It is more opinionated than Button and suitable for uses where M3 is preferred.

Parameters


text	The text that this button will show.
onClick	The action to be performed when this button is clicked.
modifier	The modifier to be applied to this button.
enabled	If false, the button will not be clickable.
icon	An optional leading icon placed before the text.
colors	The colors to use for the background and content of the button.
maxLines	An optional maximum number of lines for the text to span, wrapping if necessary. If the text exceeds the given number of lines, it will be truncated.