跨平台开发 / 系统课时

用 ColorScheme 管理界面颜色

用 ColorScheme 管理界面颜色

本篇解决 Flutter 应用中颜色分散、主题难维护的问题,通过 ColorScheme 建立主色、背景色、容器色和语义色之间的统一关系,让界面能够稳定适配明暗主题。

学习目标

  • 理解 ColorScheme 在 Flutter Material 主题中的作用。
  • 学会使用 ColorScheme 定义和读取界面颜色。
  • 掌握统一颜色体系在实际页面开发中的使用方式。

为什么需要统一颜色体系

在简单页面中,直接给组件设置颜色看起来很方便,例如按钮使用蓝色、标题使用黑色、卡片使用浅灰色。但随着页面数量增加,颜色散落在各个 Widget 中,会导致主题调整困难。

ColorScheme 的作用是把颜色角色提前定义,例如主操作颜色、背景颜色、表面颜色、错误提示颜色等。组件不关心具体是什么颜色,只使用对应角色,从而保持整个应用的一致性。

使用 ColorScheme 定义主题颜色

Flutter 的 Material 主题通过 ThemeData 管理全局样式,其中 colorScheme 是颜色系统的核心入口。

下面示例创建一个包含主色和语义色的主题,并在页面中读取颜色:

dart
import 'package:flutter/material.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(
          seedColor: Colors.blue,
        ),
      ),
      home: const ColorDemoPage(),
    );
  }
}

class ColorDemoPage extends StatelessWidget {
  const ColorDemoPage({super.key});

  @override
  Widget build(BuildContext context) {
    final colors = Theme.of(context).colorScheme;

    return Scaffold(
      backgroundColor: colors.surface,
      body: Center(
        child: Card(
          color: colors.primaryContainer,
          child: Padding(
            padding: const EdgeInsets.all(24),
            child: Text(
              '统一颜色体系',
              style: TextStyle(color: colors.onPrimaryContainer),
            ),
          ),
        ),
      ),
    );
  }
}

预期结果

text
应用启动后显示一个使用主题颜色生成的卡片。
卡片背景来自 primaryContainer,文字颜色来自 onPrimaryContainer。
修改主题 seedColor 后,相关颜色会自动变化。

常用颜色角色如何选择

ColorScheme 中的颜色不是按照组件名称命名,而是按照设计语义命名。常见角色如下:

颜色角色 使用场景
primary 主要操作按钮、品牌强调区域
secondary 次级操作和辅助强调
surface 页面背景、卡片等表面区域
error 错误提示、危险操作
onPrimary primary 背景上的文字和图标
primaryContainer 更柔和的强调背景

使用时应优先选择语义颜色,而不是直接写固定颜色值。例如错误提示使用 error,不要直接指定红色,因为不同主题下错误色可能不同。

在组件中复用主题颜色

当页面需要多个组件共享颜色时,通过 Theme.of(context).colorScheme 获取主题配置即可。这样组件不会依赖某个具体颜色,未来切换深色模式或品牌主题时无需逐个修改。

实际开发中,页面级组件通常只负责布局,颜色决策应该尽量交给主题层管理。这样可以避免大量 Colors.xxx 散落在业务代码中。

如果一个颜色只代表某个业务状态,也可以扩展主题配置,但应该先确认它是否属于整个应用的通用语义,而不是单个页面的临时需求。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 ColorScheme 管理界面颜色

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

登录哪都通