theme-material3/com.softartdev.theme.material3

Package-level declarations

Types

class Material3ThemePrefs(preferenceHelper: PreferenceHelper, darkColorScheme: ColorScheme = darkColorScheme(), lightColorScheme: ColorScheme = lightColorScheme()) : ThemePrefs

ThemePrefs implementation for Material 3 theming. Provides colorScheme that switches based on ThemeEnum (light/dark/system).

Properties

colorScheme

@get:Composable

@get:ReadOnlyComposable

val ThemePrefs.colorScheme: ColorScheme

Returns ColorScheme when this ThemePrefs is a Material3ThemePrefs; use inside Material 3 theme scope.

Functions

Material3AlertDialogContent

@Composable

fun Material3AlertDialogContent(modifier: Modifier = Modifier, title: @Composable BoxScope.() -> Unit? = null, text: @Composable BoxScope.() -> Unit? = null, confirmButton: @Composable () -> Unit, dismissButton: @Composable () -> Unit? = null, shape: Shape = AlertDialogDefaults.shape, containerColor: Color = AlertDialogDefaults.containerColor, titleContentColor: Color = AlertDialogDefaults.titleContentColor, textContentColor: Color = AlertDialogDefaults.textContentColor, tonalElevation: Dp = AlertDialogDefaults.TonalElevation)

Material Design basic dialog content

PreferableMaterialTheme

@Composable

fun PreferableMaterialTheme(preferHelper: PreferenceHelper = rememberPreferenceHelper(), darkColorScheme: ColorScheme = darkColorScheme(), lightColorScheme: ColorScheme = lightColorScheme(), content: @Composable PreferableMaterialTheme.() -> Unit)

Material 3 theme that respects stored light/dark preference and provides ThemePrefs via LocalThemePrefs.

PreferenceCategory

@Composable

fun PreferenceCategory(title: String, vector: ImageVector)

Non-clickable list item used as a section header (leading icon + headline in tertiary style).

PreferenceItem

@Composable

fun PreferenceItem(title: String, vector: ImageVector, onClick: () -> Unit = {}, secondaryText: @Composable () -> Unit? = null, trailing: @Composable () -> Unit? = null)

Clickable list row for a preference: leading icon, headline, optional supporting/trailing content.

RadioDialogContent

@Composable

fun RadioDialogContent(themeState: MutableState<ThemeEnum>)

Radio group for selecting a ThemeEnum (Light, Dark, System default). Use inside theme dialogs.

rememberThemePrefs

@Composable

fun rememberThemePrefs(): Material3ThemePrefs

Returns a Material3ThemePrefs remembered across recompositions using default rememberPreferenceHelper.

@Composable

fun rememberThemePrefs(preferHelper: PreferenceHelper = rememberPreferenceHelper(), darkColorScheme: ColorScheme = darkColorScheme(), lightColorScheme: ColorScheme = lightColorScheme()): Material3ThemePrefs

Returns a Material3ThemePrefs with the given PreferenceHelper and color schemes.

SettingsScaffold

@Composable

fun SettingsScaffold(onBackClick: () -> Unit = {}, actions: @Composable RowScope.() -> Unit = {}, content: @Composable (PaddingValues) -> Unit)

Scaffold with a top app bar suitable for settings screens (back navigation + optional actions).

SettingsScaffoldPreview

@Preview

@Composable

fun SettingsScaffoldPreview()

SettingsTopAppBar

@Composable

fun SettingsTopAppBar(onBackClick: () -> Unit = {}, actions: @Composable RowScope.() -> Unit = {}, localizedText: String = stringResource(Res.string.settings), backVector: ImageVector = Icons.AutoMirrored.Filled.ArrowBack)

Top app bar with back button and title for settings screens.

ThemeAlertDialog

@Composable

fun ThemeAlertDialog(themeState: MutableState<ThemeEnum> = themePrefs.themeState, writePref: (ThemeEnum) -> Unit = themePrefs.preferenceHelper.let { it::themeEnum::set }, dismissDialog: () -> Unit = {})

AlertDialog for selecting a theme. Should use directly in the composable destination that wants to show that dialog.

ThemeDialogContent

@Composable

fun ThemeDialogContent(themeState: MutableState<ThemeEnum> = themePrefs.themeState, writePref: (ThemeEnum) -> Unit = themePrefs.preferenceHelper.let { it::themeEnum::set }, dismissDialog: () -> Unit = {})

Dialog layout for selecting a theme. Represents a separate screen. Should use in the dialog destination that will be hosted within a androidx.compose.ui.window.Dialog.

ThemeDialogContentPreview

@Preview

@Composable

fun ThemeDialogContentPreview()

ThemeDialogPreview

@Preview

@Composable

fun ThemeDialogPreview()

ThemePreferenceItem

@Composable