跨平台开发 / 系统课时

支持浅色和深色主题

支持浅色和深色主题

同一套页面要同时适配浅色与深色外观,关键不是在 Widget 中反复判断颜色,而是准备两套完整的 ThemeData,再由 MaterialApp 统一选择。本节会配置 light、dark 主题,并让应用自动跟随系统外观变化。

学习目标

  • 分别配置浅色与深色 ThemeData
  • 使用 ThemeMode.system 跟随系统主题切换
  • 在组件中通过主题语义取色,避免写死颜色

ThemeData 各自负责什么

Flutter 的 MaterialApp 可以同时接收 theme 和 darkTheme。前者用于浅色模式,后者用于深色模式;真正决定当前使用哪一套的是 themeMode。

如果把 themeMode 设置为 ThemeMode.system,Flutter 会读取平台提供的亮度信息。当系统从浅色切到深色时,应用会重新构建使用主题的组件,不需要自己监听设置页面或手动刷新。

浅色与深色主题跟随系统切换流程

让系统主题驱动切换

下面是一份可直接放入 lib/main.dart 的完整示例。两套主题使用相同的种子色,但分别声明不同的 brightness,因此可以保持品牌色关系一致,同时让背景、文字和组件表面适应当前模式。

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

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

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      themeMode: ThemeMode.system,
      theme: ThemeData(
        useMaterial3: true,
        colorScheme: ColorScheme.fromSeed(
          seedColor: Colors.indigo,
          brightness: Brightness.light,
        ),
      ),
      darkTheme: ThemeData(
        useMaterial3: true,
        colorScheme: ColorScheme.fromSeed(
          seedColor: Colors.indigo,
          brightness: Brightness.dark,
        ),
      ),
      home: const ThemePreviewPage(),
    );
  }
}

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

  @override
  Widget build(BuildContext context) {
    final theme = Theme.of(context);
    final isDark = theme.brightness == Brightness.dark;

    return Scaffold(
      appBar: AppBar(
        title: const Text('主题预览'),
      ),
      body: Center(
        child: Card(
          child: Padding(
            padding: const EdgeInsets.all(24),
            child: Column(
              mainAxisSize: MainAxisSize.min,
              children: [
                Text(
                  isDark ? '当前:深色主题' : '当前:浅色主题',
                  style: theme.textTheme.headlineSmall,
                ),
                const SizedBox(height: 12),
                const Text('修改系统外观后,应用会自动切换主题。'),
                const SizedBox(height: 20),
                FilledButton(
                  onPressed: () {},
                  child: const Text('示例按钮'),
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}

预期结果

text
系统为浅色模式时,页面使用浅色 ThemeData,并显示“当前:浅色主题”。
系统切换为深色模式后,无需重启应用,页面改用深色 ThemeData,并显示“当前:深色主题”。

这里的页面没有判断背景应该使用白色还是黑色。Scaffold、Card、FilledButton 和文本都从当前主题的颜色方案取得合适的视觉值,这正是集中管理主题的价值。

验证浅色与深色

保持应用运行,然后在设备或模拟器中切换系统的浅色、深色外观。重点检查页面背景、卡片、正文文字和按钮是否同时变化,并确认内容在两种模式下都有足够的可读性。

如果页面中某个区域始终保持同一种颜色,优先检查是否直接写了 Colors.white、Colors.black 或固定十六进制颜色。业务代码更适合读取 Theme.of(context).colorScheme 中的语义颜色,例如 surface、onSurface、primary 和 onPrimary。

什么时候需要手动主题模式

ThemeMode.system 适合默认跟随设备设置。如果产品允许用户在应用内固定选择浅色或深色,可以把 themeMode 改为状态变量,并在 ThemeMode.light、ThemeMode.dark 与 ThemeMode.system 之间切换。

无论选择哪种策略,页面组件都应尽量依赖主题语义而不是保存自己的颜色规则。这样新增页面或调整品牌色时,只需要修改主题配置,不必逐个寻找散落在 Widget 中的颜色常量。

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

目录与阅读设置

阅读设置

17

记录一个想法

支持浅色和深色主题

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

登录哪都通