ListSubheader

Component in Wear Material 3 Compose

A two slot based composable for creating a list subheader item. [ListSubheader]s offer slots for an icon and for a text label. The contents will be start and end padded.

Last updated: 2024-09-07 14:23

Installation

dependencies {
   implementation("androidx.wear.compose:compose-material3:1.0.0-alpha24")
}

Overloads

@Composable
fun ListSubheader(
    modifier: Modifier = Modifier,
    backgroundColor: Color = Color.Transparent,
    contentColor: Color = ListSubHeaderTokens.ContentColor.value,
    contentPadding: PaddingValues = ListHeaderDefaults.SubheaderContentPadding,
    icon: (@Composable BoxScope.() -> Unit)? = null,
    label: @Composable RowScope.() -> Unit,
)

Parameters

name	description
modifier	The modifier for the [ListSubheader].
backgroundColor	The background color to apply - typically Color.Transparent
contentColor	The color to apply to content.
contentPadding	The spacing values to apply internally between the container and the content.
icon	A slot for providing icon to the [ListSubheader].
label	A slot for providing label to the [ListSubheader].

Code Examples

ListSubheaderSample

@Composable
fun ListSubheaderSample() {
    ListSubheader { Text("Subheader") }
}

ListSubheaderWithIconSample

@Composable
fun ListSubheaderWithIconSample() {
    ListSubheader(
        label = { Text(text = "Subheader") },
        icon = { Icon(imageVector = Icons.Outlined.Home, "home") }
    )
}