Stylish UI/com.segnities007.stylishui.components.models/StylishConnectedCardItem

StylishConnectedCardItem

data class StylishConnectedCardItem(val title: String = "", val supportingText: String = "", val onClick: () -> Unit? = null, val onLongClick: () -> Unit? = null, val enabled: Boolean = true, val leadingContent: @Composable () -> Unit? = null, val trailingContent: @Composable () -> Unit? = null, val content: @Composable () -> Unit? = null)

Immutable data describing a single card within a Connected Card layout.

Connected Card layouts stack cards vertically with shared corner geometry (see com.segnities007.stylishui.foundation.ConnectedCorners) and a narrow gap (com.segnities007.stylishui.tokens.StylishDimensions.connectedSpacing). The consuming composable iterates over a List<StylishConnectedCardItem> and applies position-aware shapes, outlines, and elevation.

Two rendering modes

Structured mode (default) — when content is null, the card renders a fixed three-slot row: leadingContent | title column (title + supportingText) | trailingContent.

Content mode — when content is non-null, it completely replaces the structured row, giving the caller full control over the card's inner layout. title, supportingText, leadingContent, and trailingContent are ignored in this mode.

Constructors

StylishConnectedCardItem

constructor(title: String = "", supportingText: String = "", onClick: () -> Unit? = null, onLongClick: () -> Unit? = null, enabled: Boolean = true, leadingContent: @Composable () -> Unit? = null, trailingContent: @Composable () -> Unit? = null, content: @Composable () -> Unit? = null)

Properties

content

val content: @Composable () -> Unit?

When non-null, replaces the entire structured row with caller-supplied content, enabling fully custom card layouts. When null (default), the structured three-slot row is rendered.

enabled

val enabled: Boolean

Whether the card is enabled. When false, the card is visually dimmed and non-interactive regardless of click handlers.

leadingContent

val leadingContent: @Composable () -> Unit?

Composable slot rendered at the start of the card in structured mode. Ignored in content mode.

onClick

val onClick: () -> Unit?

The action invoked on tap. When null, the card is display-only per the com.segnities007.stylishui.foundation.isActionable contract — no ripple, no elevation lift, no click handling.

onLongClick

val onLongClick: () -> Unit?

The action invoked on long-press. When null, long-press is not handled. A card is actionable if either onClick or onLongClick is non-null.

supportingText

val supportingText: String

Secondary text shown below title in structured mode. An empty string (the default) hides the supporting-text region entirely. Ignored in content mode.

title

val title: String

The primary text displayed prominently on the card in structured mode. Ignored in content mode. Defaults to "".

trailingContent

val trailingContent: @Composable () -> Unit?

Composable slot rendered at the end of the card in structured mode. Ignored in content mode.

StylishConnectedCardItem

Two rendering modes

See also

Constructors

Properties