跨平台开发 / 系统课时
用 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 应用,这种方式可以显著降低维护成本。
按自己的节奏,确认真正理解。