UI 视觉设计 / 系统课时

核对 Compose 的主题与组件

核对 Compose 的主题与组件

设计稿交付给 Android 工程后,常见偏差是组件颜色没有接入主题、标题被单独写死字号,或者输入错误与按钮禁用仍显示正常态。这里用一页可运行的任务编辑界面,核对 Material 3 的主题来源、组件参数和最终显示效果。

学习目标

  • 找到 MaterialTheme 中颜色、排版与形状令牌的实际消费位置。
  • 运行任务编辑页,分别触发深色、错误、禁用和成功状态。
  • 使用可复查的验收清单定位设计稿与 Compose 实现的差异。

区分主题令牌与组件状态

使用 androidx.compose.material3.MaterialTheme 包裹页面,子组件才能读取该作用域的主题值。主题负责跨页面的一致性,组件参数负责单个控件的内容与交互状态;局部覆盖应有明确理由。

设计项 Compose 核对位置 本例验收值
主按钮配色 colorScheme.primary / onPrimary 浅色 #2057A5 / 白色
页面背景 colorScheme.background 取当前浅色或深色方案
页面标题 typography.titleLarge 22sp、行高 28sp
卡片圆角 shapes.medium 12dp,卡片显式引用
表单错误状态 OutlinedTextField(isError) 空内容显示错误
按钮禁用状态 Button(enabled) 空内容不可点击

Button 默认按 Material 3 规则读取主题配色;标题文字通过 style = MaterialTheme.typography.titleLarge 明确指定字阶。Shapes.medium 不代表所有组件都自动使用 12dp,必须核对实际组件的默认形状或显式 shape 参数。

MaterialTheme 主题令牌、组件与局部状态的关系

运行最小核对页面

在 Android Studio 中创建启用 Jetpack Compose 的 Empty Activity 项目,确保依赖包含 androidx.compose.material3:material3 和 androidx.activity:activity-compose。下面使用 Material 3 稳定的 MaterialTheme、lightColorScheme、darkColorScheme 与值式 OutlinedTextField API;将 MainActivity.kt 替换为以下代码,包名与项目保持一致。

kotlin
package com.example.themeaudit

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.*
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.material3.*
import androidx.compose.runtime.*
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.ui.Alignment
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

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent { ThemeAudit() }
    }
}

@Composable
private fun ThemeAudit() {
    var dark by rememberSaveable { mutableStateOf(false) }
    var task by rememberSaveable { mutableStateOf("提交周报") }
    var saved by rememberSaveable { mutableStateOf(false) }

    // 深浅色分别配置主色与其前景色,避免对比度不匹配
    val scheme = if (dark) {
        darkColorScheme(
            primary = Color(0xFFB6C7FF),
            onPrimary = Color(0xFF102A57)
        )
    } else {
        lightColorScheme(
            primary = Color(0xFF2057A5),
            onPrimary = Color.White
        )
    }

    // 在统一主题作用域中提供颜色、字阶与圆角
    MaterialTheme(
        colorScheme = scheme,
        typography = Typography(
            titleLarge = TextStyle(
                fontSize = 22.sp,
                lineHeight = 28.sp,
                fontWeight = FontWeight.SemiBold
            )
        ),
        shapes = Shapes(medium = RoundedCornerShape(12.dp))
    ) {
        Surface(
            modifier = Modifier.fillMaxSize(),
            color = MaterialTheme.colorScheme.background
        ) {
            Column(
                modifier = Modifier.padding(24.dp),
                verticalArrangement = Arrangement.spacedBy(16.dp)
            ) {
                Text(
                    "任务编辑",
                    style = MaterialTheme.typography.titleLarge
                )
                Card(shape = MaterialTheme.shapes.medium) {
                    Text(
                        "待核对组件",
                        modifier = Modifier.padding(12.dp)
                    )
                }

                // 输入框错误态与按钮禁用态使用同一校验条件
                OutlinedTextField(
                    value = task,
                    onValueChange = { task = it; saved = false },
                    label = { Text("任务名称") },
                    isError = task.isBlank(),
                    supportingText = {
                        if (task.isBlank()) Text("任务名称不能为空")
                    },
                    singleLine = true
                )
                Button(
                    onClick = { saved = true },
                    enabled = task.isNotBlank()
                ) {
                    Text("保存任务")
                }
                Row(verticalAlignment = Alignment.CenterVertically) {
                    Text("深色主题")
                    Switch(
                        checked = dark,
                        onCheckedChange = { dark = it }
                    )
                }
                if (saved) Text("已保存:$task")
            }
        }
    }
}

预期结果:初次运行显示“任务编辑”、卡片、预填“提交周报”的输入框、可点击的“保存任务”按钮和深色主题开关。点击保存出现“已保存:提交周报”;清空输入时,输入框显示错误提示且保存按钮变为禁用。此示例使用完整 Activity 入口运行,不需要额外的状态管理库。

按状态核对交付效果

按照以下顺序在模拟器或真机操作,记录每个状态的截图,并与设计稿按同一窗口宽度对齐:

  1. 浅色正常态:标题应使用 22sp 字号与 28sp 行高;保存按钮容器使用 #2057A5,按钮文字使用白色;卡片圆角为 12dp。
  2. 错误与禁用态:删除任务名称全部字符;输入框应出现错误样式与“任务名称不能为空”,保存按钮应禁用,点击后不会显示保存成功。
  3. 恢复与成功态:输入“整理会议纪要”,按钮重新启用;点击后显示“已保存:整理会议纪要”。
  4. 深色态:开启“深色主题”;按钮使用深色方案的 primary 与 onPrimary,背景和输入框也应切换到当前主题角色,而不是仅把页面底色改黑。

除了颜色,还应检查点击、聚焦、错误和禁用时是否出现合理的状态反馈。对于 OutlinedTextField,错误状态由 isError 控制,提示文案由 supportingText 提供,两者必须基于同一条校验规则,避免出现红色边框但没有错误说明的情况。

修正组件与设计稿的偏差

发现的问题 优先检查 修正方式
改主题后按钮仍保持旧色 ButtonDefaults.buttonColors 删除不必要的固定色覆盖,或成对使用 primary 与 onPrimary
标题大小与设计稿不一致 Text(style)、单独传入的 fontSize 统一引用 MaterialTheme.typography.titleLarge
输入为空却没有错误态 isError 与 supportingText 根据同一个校验结果同时驱动边框状态和提示文案
卡片圆角不符合设计值 Card(shape) 显式传入 MaterialTheme.shapes.medium,不要假设默认值一致
深色模式下文字难以辨认 colorScheme 中的前景与背景色角色 核对 onPrimary、onSurface 等颜色是否与对应容器正确配对

发现差异时,先查看组件是否传入了硬编码颜色、字号或形状,再检查主题提供的令牌。不要为了修复一个页面而修改全局主题,除非已经确认该差异影响所有同类组件。

实际验收还要将系统字体比例提高到约 1.3 倍,检查标题、错误提示和按钮是否发生截断;深浅色都要核对文字对比度与可读性。必要时使用 Android Studio 的 Layout Inspector 检查 Compose 组件层级,并结合代码定位实际传入的参数。

通过标准是:颜色、字阶与形状能追溯到主题或明确的局部覆盖;正常、错误、禁用、成功和深色状态均能复现;所有设计与工程差异都有明确的修正方式和复验结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

核对 Compose 的主题与组件

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

登录哪都通