原生移动开发 / 系统课时

主题、颜色与深色模式

主题、颜色与深色模式

这一节把 Material 3 主题接到应用根部:定义浅色与深色 ColorScheme、Typography 和 Shapes,并跟随系统深色模式切换。完成后,组件会从 MaterialTheme 继承颜色、排版和圆角。

学习目标

  • 定义并切换浅色、深色 ColorScheme,理解语义色角色的用途。
  • 配置 Typography 与 Shapes,让 Material 3 组件自动继承统一样式。
  • 使用 isSystemInDarkTheme() 跟随系统主题,并知道手动主题开关应放在哪里。

主题是组件的统一入口

Material 3 的核心主题入口是 MaterialTheme。它向下提供 colorScheme、typography 和 shapes,位于其内容树中的 Button、Card、Text 等组件会读取这些值。这样修改品牌色、字号或圆角时,不需要逐个页面替换常量。

颜色应优先按职责命名,而不是按视觉值命名。例如主按钮通常使用 primary 与 onPrimary,页面背景使用 background 与 onBackground。如果业务组件直接写死十六进制颜色,切换深色模式时往往会出现对比度不足或局部仍保持亮色的问题。

定义浅色与深色主题

下面示例可直接放入一个已启用 Compose Material 3 的 Android 项目。AppTheme 在应用根部决定颜色方案,同时把自定义排版和形状传给整棵 Compose UI。

kotlin
package com.example.theme

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.isSystemInDarkTheme
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.material3.Button
import androidx.compose.material3.Card
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Shapes
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.material3.Typography
import androidx.compose.material3.darkColorScheme
import androidx.compose.material3.lightColorScheme
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.text.TextStyle
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp

// 浅色与深色方案使用相同语义角色,组件代码无需额外颜色分支。
private val LightScheme = lightColorScheme(
    primary = Color(0xFF006C4C),
    onPrimary = Color(0xFFFFFFFF),
    primaryContainer = Color(0xFF8EF8C8),
    onPrimaryContainer = Color(0xFF002116),
    background = Color(0xFFF5FBF7),
    onBackground = Color(0xFF171D1A)
)

private val DarkScheme = darkColorScheme(
    primary = Color(0xFF72DBAF),
    onPrimary = Color(0xFF003825),
    primaryContainer = Color(0xFF005138),
    onPrimaryContainer = Color(0xFF8EF8C8),
    background = Color(0xFF0F1512),
    onBackground = Color(0xFFDEE4DF)
)

// 只覆盖本示例关心的字阶,其余字阶继续使用 Material 3 默认值。
private val AppTypography = Typography(
    titleLarge = TextStyle(
        fontSize = 24.sp,
        lineHeight = 32.sp,
        fontWeight = FontWeight.SemiBold
    ),
    bodyLarge = TextStyle(
        fontSize = 16.sp,
        lineHeight = 24.sp
    )
)

private val AppShapes = Shapes(
    small = RoundedCornerShape(8.dp),
    medium = RoundedCornerShape(12.dp),
    large = RoundedCornerShape(20.dp)
)

// 深色模式判断集中在主题层,业务组件只消费 MaterialTheme。
@Composable
fun AppTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    content: @Composable () -> Unit
) {
    MaterialTheme(
        colorScheme = if (darkTheme) DarkScheme else LightScheme,
        typography = AppTypography,
        shapes = AppShapes,
        content = content
    )
}

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            AppTheme {
                // 页面只引用主题令牌,不直接判断深色模式或复制设计常量。
                Surface(modifier = Modifier.fillMaxSize()) {
                    Column(
                        modifier = Modifier.padding(24.dp),
                        verticalArrangement = Arrangement.spacedBy(16.dp)
                    ) {
                        Text(
                            text = "主题示例",
                            style = MaterialTheme.typography.titleLarge
                        )
                        Card(shape = MaterialTheme.shapes.medium) {
                            Text(
                                text = "这张卡片继承主题的排版、颜色和圆角。",
                                modifier = Modifier.padding(16.dp)
                            )
                        }
                        Button(onClick = {}) {
                            Text("主要操作")
                        }
                    }
                }
            }
        }
    }
}

预期结果

text
浅色模式:页面使用 LightScheme,主按钮采用浅色方案的 primary 语义色。
深色模式:系统切换为深色主题后,页面自动改用 DarkScheme,无需重建 Activity。
标题使用 AppTypography.titleLarge,卡片圆角使用 AppShapes.medium(12dp)。

从主题读取样式而不是复制常量

业务组件应该读取 MaterialTheme.colorScheme、MaterialTheme.typography 和 MaterialTheme.shapes。例如同一个 primary 在浅色与深色方案中可以是不同的实际颜色,但组件代码不需要知道这个差异;它只表达“这里是主要操作”。

深色模式与手动主题开关

isSystemInDarkTheme() 适合“跟随系统”的默认策略。如果应用提供“浅色 / 深色 / 跟随系统”三态设置,应由设置层先计算最终的 darkTheme 布尔值,再传给 AppTheme。这样系统主题、用户偏好和页面组件之间只有一个主题状态来源。

深色主题并不是把所有颜色机械变暗。真正需要维护的是成对的语义角色,例如 primary/onPrimary、background/onBackground 的可读性关系。只要组件始终消费主题角色,后续替换品牌色或扩展动态颜色时,页面结构通常无需改动。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

主题、颜色与深色模式

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通