跨平台开发 / 系统课时

配置 Text 的样式和溢出

配置 Text 的样式和溢出

本文解决 Flutter 中文本展示不可控的问题,学习如何通过 Text 的样式、布局和溢出配置,让标题、描述等内容在不同屏幕尺寸下保持稳定显示。

学习目标

  • 掌握 Text 常用样式参数的配置方式。
  • 理解文本换行、截断和省略号显示的关系。
  • 能够处理移动端常见的长文本展示场景。

设置 Text 的基础样式

Flutter 中的 Text 组件通过 style 参数控制字体相关效果,常见配置包括字号、粗细、颜色、字体间距和行高。

下面示例展示一个标题文本的常用配置方式:

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

void main() {
  runApp(const MaterialApp(home: TextDemo()));
}

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

  @override
  Widget build(BuildContext context) {
    return const Scaffold(
      body: Center(
        child: Text(
          'Flutter 内容展示标题',
          style: TextStyle(
            fontSize: 24,
            fontWeight: FontWeight.bold,
            color: Colors.blue,
            letterSpacing: 1.2,
          ),
        ),
      ),
    );
  }
}

预期结果

text
页面中央显示蓝色、加粗、字号为 24 的标题文本。

TextStyle 只负责文字外观,不负责控制文本占用多少空间。文本是否换行、截断,需要结合布局约束处理。

控制文本对齐和行数

单个 Text 默认根据内容大小绘制。如果需要控制多行文本,可以使用 textAlign 和 maxLines。

dart
Text(
  '这是一段可能比较长的商品描述文本,需要限制显示范围。',
  textAlign: TextAlign.center,
  maxLines: 2,
)

textAlign 决定多行文本在可用区域中的水平排列方式,常用值包括:

参数 作用
left 左对齐
center 居中对齐
right 右对齐
justify 两端对齐

maxLines 限制最多显示的行数,但不会自动决定超出后的处理方式。

处理文本溢出

当文本长度超过布局允许空间时,需要通过 overflow 指定处理方式。

dart
Text(
  '这是一段非常长的标题内容,用于测试文本超出显示区域后的效果。',
  maxLines: 1,
  overflow: TextOverflow.ellipsis,
)

预期结果

text
文本超过一行宽度后显示省略号,例如:这是一段非常长的标题内容...

常用溢出策略如下:

类型 行为
clip 裁剪超出的内容
fade 使用渐隐效果隐藏尾部
ellipsis 使用省略号表示省略内容

移动端列表中的标题通常使用 maxLines: 1 配合 TextOverflow.ellipsis,避免长标题撑开布局。

Text 使用中的常见边界

Text 的溢出处理依赖父组件提供的宽度约束。例如,在 Row 中直接放置长文本时,如果没有限制宽度,Flutter 可能无法判断文本应该如何压缩。

常见处理方式是使用 Expanded 或 Flexible 给文本分配剩余空间:

dart
Row(
  children: [
    const Icon(Icons.title),
    Expanded(
      child: Text(
        '很长的列表标题内容',
        maxLines: 1,
        overflow: TextOverflow.ellipsis,
      ),
    ),
  ],
)

预期结果

text
图标固定显示,标题占用剩余空间,超长部分显示省略号。

实际开发中,先确认文本所在布局是否提供明确宽度,再配置 maxLines 和 overflow,通常比单独调整字体大小更可靠。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置 Text 的样式和溢出

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

登录哪都通