theme-material/com.softartdev.theme.material

Package-level declarations

Types

class MaterialThemePrefs(preferenceHelper: PreferenceHelper, darkColorPalette: Colors = darkColors(), lightColorPalette: Colors = lightColors()) : ThemePrefs

ThemePrefs implementation for Material (v1) theming. Provides colors that switch based on ThemeEnum (light/dark/system).

Properties

colors

@get:Composable

@get:ReadOnlyComposable

val ThemePrefs.colors: Colors

Returns Colors when this ThemePrefs is a MaterialThemePrefs; use inside Material theme scope.

Functions

MaterialAlertDialogContent

@Composable

fun MaterialAlertDialogContent(modifier: Modifier = Modifier, title: @Composable () -> Unit? = null, text: @Composable () -> Unit? = null, confirmButton: @Composable () -> Unit, dismissButton: @Composable () -> Unit? = null, shape: Shape = MaterialTheme.shapes.medium, backgroundColor: Color = MaterialTheme.colors.surface, contentColor: Color = contentColorFor(backgroundColor))

Material Design alert dialog content

PreferableMaterialTheme

@Composable

fun PreferableMaterialTheme(preferHelper: PreferenceHelper = rememberPreferenceHelper(), darkColorPalette: Colors = darkColors(), lightColorPalette: Colors = lightColors(), content: @Composable PreferableMaterialTheme.() -> Unit)

Material (v1) 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 (icon + title in secondary 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: icon, title, optional secondary/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(): MaterialThemePrefs

Returns a MaterialThemePrefs remembered across recompositions using default rememberPreferenceHelper.

@Composable

fun rememberThemePrefs(preferHelper: PreferenceHelper = rememberPreferenceHelper(), darkColorPalette: Colors = darkColors(), lightColorPalette: Colors = lightColors()): MaterialThemePrefs

Returns a MaterialThemePrefs with the given PreferenceHelper and color palettes.

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