Stylish
A floating page header that hosts navigation, title, and action slots.
Renders a rounded, elevated Surface bar pinned to the top of the page with automatic status-bar inset padding. The title slot is centered and tagged with heading semantics; navigation aligns to the start edge and actions to the end edge. Typically placed inside the header slot of StylishPageContent or the topBar slot of StylishScaffold.
Parameters
Optional composable rendered at the start (leading) edge, typically a StylishIconButton for back or drawer navigation. When null, no leading content is shown.
Optional composable rendered at the end (trailing) edge, typically one or more StylishIconButtons for search, settings, etc. When null, no trailing content is shown.
Modifier applied to the outer Column.
Corner shape of the header surface. Defaults to RoundedCornerShape with StylishTheme.dimensions.floatingCornerRadius radius, matching the floating aesthetic.
Background color of the header surface. Defaults to MaterialTheme.colorScheme.surfaceContainerHigh.
Default content color propagated to child composables. Defaults to MaterialTheme.colorScheme.onSurface.
Optional BorderStroke drawn around the surface. Defaults to a stroke of StylishTheme.dimensions.outlineWidth (typically 0.4.dp) in MaterialTheme.colorScheme.outlineVariant. Pass null to remove.
Tonal elevation of the surface. Defaults to 4.dp.
Drop-shadow elevation of the surface. Defaults to StylishTheme.dimensions.floatingElevation (typically 2.dp).
Fixed height of the inner content area. Defaults to 56.dp (standard app-bar height).
Space above the surface, after status-bar insets. Defaults to StylishTheme.dimensions.itemSpacing.
Space below the surface, separating it from page content. Defaults to StylishTheme.dimensions.contentSpacing.
Horizontal gap between items inside the actions slot. Defaults to StylishTheme.dimensions.inlineSpacing.
WindowInsets consumed above the surface via Modifier.windowInsetsPadding, typically the status-bar insets. Defaults to WindowInsets.statusBars so the bar clears the system status area.