跨平台开发 / 系统课时

用 TextTheme 统一文字层级

用 TextTheme 统一文字层级

本篇解决 Flutter 页面中文字大小、粗细和间距不一致的问题,通过 TextTheme 建立标题、正文、标签和辅助信息的排版规则,让多个页面保持统一视觉层级。

学习目标

  • 理解 TextTheme 如何描述文字层级。
  • 学会在组件中读取并复用文本样式。
  • 掌握避免页面文字样式失控的方法。

为什么需要 TextTheme

在页面开发中,如果每个 Text 都手动设置 fontSize、fontWeight 和颜色,短期内可以快速完成界面,但长期维护会产生大量重复代码。

TextTheme 将文字样式按用途分类,例如大标题、正文、标签等。组件只需要选择合适的语义样式,不需要关心具体字体大小。

定义应用级文字体系

Flutter 的主题通过 ThemeData.textTheme 管理全局文字样式。通常可以基于 Material 默认样式进行调整。

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(
        textTheme: const TextTheme(
          headlineLarge: TextStyle(
            fontSize: 32,
            fontWeight: FontWeight.bold,
          ),
          bodyLarge: TextStyle(
            fontSize: 16,
          ),
          labelMedium: TextStyle(
            fontSize: 12,
          ),
        ),
      ),
      home: const TextDemoPage(),
    );
  }
}

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

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

    return Scaffold(
      body: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          Text('页面标题', style: textTheme.headlineLarge),
          Text('正文内容', style: textTheme.bodyLarge),
          Text('辅助标签', style: textTheme.labelMedium),
        ],
      ),
    );
  }
}

预期结果

text
页面显示三个不同层级的文本。
标题使用 headlineLarge,正文使用 bodyLarge,标签使用 labelMedium。
修改 textTheme 后,所有使用对应样式的组件会同步变化。

常用文字层级选择

TextTheme 的样式名称体现用途,而不是页面位置。常见选择方式如下:

样式 适合场景
headlineLarge 页面主标题、重要信息
titleLarge 卡片标题、区域标题
bodyLarge 普通正文内容
bodyMedium 次要说明文字
labelMedium 按钮文字、标签文字

例如卡片标题不应该因为它位于页面顶部就使用最大的标题样式,而应该根据信息重要程度选择 titleLarge 或其他合适样式。

让组件依赖语义而不是具体数值

统一文字体系的关键不是减少代码,而是建立稳定规则。业务组件只表达“这里是一段标题”或“这里是一段说明”,具体字体大小、粗细和颜色交给主题控制。

当产品需要调整整体视觉风格时,只需要修改 TextTheme 配置,而不需要逐个搜索 Text 组件。对于包含大量页面的 Flutter 应用,这种方式可以显著降低维护成本。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 TextTheme 统一文字层级

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

登录哪都通