Flutter那些事-展示型组件篇

Text

在 Flutter 中,Text 组件是负责显示文本的核心部件,几乎出现在任何需要展示文字的地方。它非常灵活,既可以显示简单的单一样式文本,也能通过 Text.rich 构建复杂的富文本效果。

1. 核心用法与基本参数

使用 Text 最基本的方式就是创建一个 Text 实例,并传入要显示的字符串。但通过设置不同的参数,可以控制其布局和截断方式。

  • textAlign (文本对齐) :控制文本在 Text 组件内的水平对齐方式,例如 TextAlign.center(居中)、TextAlign.left(左对齐)。需要注意的是,只有当 Text 组件的宽度大于文本实际内容宽度时,对齐设置才会生效。

  • maxLines (最大行数) :限制文本最多显示的行数。默认情况下,文本会自动换行。设置此参数后,超出部分的行将不会被显示-1。

  • overflow (溢出处理) :当文本内容超出 maxLines 限制或父容器约束时,如何处理溢出。常用的有:

    • TextOverflow.ellipsis:用省略号"..."表示被截断的文本。
    • TextOverflow.clip:直接裁剪掉溢出的文本(默认行为)。
    • TextOverflow.fade:将溢出的文本边缘渐隐处理。
  • softWrap (是否软换行) :决定文本是否在换行符处自动换行。如果设为 false,文本将只占一行,可能导致水平方向溢出。

  • textScaleFactor (文本缩放因子) :一个快速放大或缩小文本的因子。例如,设为 1.5 会使所有文本放大50%。不过,官方现在更推荐使用 textScaler 来获得更精细的控制。

示例:

js 复制代码
import 'package:flutter/material.dart';

void main(List<String> args) {
  runApp(MainPage());
}

class MainPage extends StatelessWidget {
  const MainPage({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text("Text组件"),
        ),
        body: Container(
          // 文本居中方式
          alignment: Alignment.center,
          width: double.infinity,
          height: double.infinity,
          color: Colors.amber,
          child: Text.rich(TextSpan(
            text: "Hello",
            children: [
              TextSpan(
                text: "Flutter",style: TextStyle(color: Colors.green)
              ),
              TextSpan(text:"!")
            ],
            style: TextStyle(
              // 字体颜色
              color: Colors.red,
              // 字体大小
              fontSize: 40,
              // 字重
              fontWeight: FontWeight.bold

            )
          )),
          // 当字体显示数量超过对应行数时,其余文本将进行隐藏,并截断文本用...显示。
          // child: Text("今天天气很冷,今天天气很冷,今天天气很冷,今天天气很冷,今天天气很冷,今天天气很冷,今天天气很冷,今天天气很冷,今天天气很冷,今天天气很冷,今天天气很冷,今天天气很冷,",
          //   style: TextStyle(
          //     color: Colors.blue,
          //     fontSize: 30
          //   ),
          //   maxLines: 2,
          //   // 溢出隐藏 
          //   overflow: TextOverflow.ellipsis,
          // ),
          // 基础Text组件
          // child:Text("Hello Flutter!",style: TextStyle(
          //   fontSize: 30,
          //   color: Colors.blue,
          //   fontStyle: FontStyle.italic,
          //   fontWeight: FontWeight.w600,
          //   decoration: TextDecoration.underline,
          //   decorationColor: Colors.red
          // ),),
        )
      ),
    );
  }
}

2. 样式定制 (TextStyle)

Text 组件的样式主要通过 style 属性来设置,其值是一个 TextStyle 对象。TextStyle 提供了极其丰富的参数来定义文本的外观-5-10。

  • 基础样式 :如 color(颜色)、fontSize(字号)、fontWeight(字重,如粗体)、fontStyle(样式,如斜体)。

  • 间距与行高:

    • letterSpacing 和 wordSpacing 控制字符和单词的间距。
    • height 用于设置行高,它的值是 fontSize 的倍数。例如 height: 1.5 且 fontSize: 20.0,则最终行高为 30.0 逻辑像素。
  • 装饰效果:

    • decoration:添加下划线 (TextDecoration.underline)、删除线 (TextDecoration.lineThrough) 等。
    • decorationColor 和 decorationStyle 分别设置装饰的颜色和样式(如虚线、波浪线)。
  • 高级效果 :通过 background 和 foreground 属性,可以使用 Paint 对象实现更复杂的效果,比如给文本添加背景色,或使用渐变色、描边等。

示例:

less 复制代码
Text(
  'Hello World',
  style: TextStyle(
    // 字体大小
    fontSize: 24.0,
    // 字体颜色
    color: Colors.blue,
    
    fontWeight: FontWeight.bold,
    // 装饰央视
    decoration: TextDecoration.underline,
    // 字体颜色
    decorationColor: Colors.red,
    // 字符
    decorationStyle: TextDecorationStyle.wavy,
    // 字符间距
    letterSpacing: 2.0,
  ),
)

3. 富文本 (TextSpan 与 Text.rich)

如果一段文本中需要包含多种样式(例如一句话里部分文字是蓝色且可点击),就不能使用普通的 Text 了。这时需要用到 TextSpan 和 Text.rich 构造函数。

TextSpan 代表一个具有独立样式的文本"片段"。多个 TextSpan 可以组合在一起,形成复杂的富文本结构。

  • text:显示的文本。
  • style:显示文本的样式。
  • children :一个 TextSpan 列表,用于嵌套更多的片段。
  • recognizer:为这个片段添加手势识别,比如点击事件。

示例:

以下代码创建了一个带有可点击链接的富文本。

js 复制代码
import 'package:flutter/gestures.dart';
import 'package:flutter/material.dart';

Text.rich(
  TextSpan(
    text: '访问 ',
    children: <TextSpan>[
      TextSpan(
        text: 'Flutter 官网',
        style: const TextStyle(color: Colors.blue),
        recognizer: TapGestureRecognizer()
          ..onTap = () {
            // 处理点击事件,例如打开网页
            print('链接被点击了');
          },
      ),
      TextSpan(text: ' 了解更多。'),
    ],
  ),
)

4. 全局样式管理 (DefaultTextStyle)

在一个页面的多个地方使用相同的文本样式时,如果每个 Text 都单独设置 style,代码会显得冗余。Flutter 提供了 DefaultTextStyle 组件来管理全局或局部的默认文本样式。

DefaultTextStyle 可以包裹一个组件子树,并为其设置默认的 style 和 textAlign。该子树中所有未显式指定样式的 Text 组件,都会自动继承这个默认样式。

示例:

dart

复制下载

js 复制代码
// 默认文本样式
DefaultTextStyle(
  style: const TextStyle(
    color: Colors.red,
    fontSize: 20.0,
  ),
  // 文本居中方式
  textAlign: TextAlign.center,
  child: Column(
    children: const [
      Text('这段文字是红色的20号字并居中'), // 继承样式
      Text('我也是同样的样式'),
      Text(
        '但我有不同样式',
        style: TextStyle( // 局部覆盖
          inherit: false, // 可选择不继承默认样式
          color: Colors.grey,
        ),
      ),
    ],
  ),
)

通过设置 inherit: false,子 Text 可以选择完全不继承父级的默认样式。

5. 使用自定义字体

要在应用中使用自定义字体(如非系统默认的字体文件),需要完成两个步骤:

  1. 在 pubspec.yaml 中声明 :将字体文件(通常放在 fonts 或 assets 目录下)的路径和样式在配置文件中声明。

    js 复制代码
    flutter:
      fonts:
        - family: MyCustomFont  # 字体的家族名称
          fonts:
            - asset: fonts/MyCustomFont-Regular.ttf
            - asset: fonts/MyCustomFont-Bold.ttf
              weight: 700  # 指定该文件对应的字重
  2. 在 TextStyle 中使用 :通过 fontFamily 属性引用你在 pubspec.yaml 中定义的字体家族名称。

    js 复制代码
    Text(
      '这是自定义字体',
      style: TextStyle(
        fontFamily: 'MyCustomFont',
        fontSize: 30.0,
      ),
    )
相关推荐
好的佩奇4 小时前
蓝牙之设备角色与连接
android·flutter·蓝牙
SoaringHeart1 天前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
恋猫de小郭2 天前
Flutter 3.50.0 Release 的第一个崩溃,修好了,还没 hotfix
android·前端·flutter
程序员老刘2 天前
跨平台开发地图 | 2026年11月
flutter·ai编程·客户端
传奇开心果编程3 天前
【Flutter踩坑排雷】第30课:异常未捕获坑|未捕获异常直接闪退,全局兜底故障处理
android·flutter·ios·移动开发·dart·ui框架·声明式ui
恋猫de小郭3 天前
Flutter Native Interop 稳定了,Platform Channel 要退场了
android·前端·flutter
好的佩奇3 天前
Dart 之可迭代对象与生成器
android·flutter·dart
恋猫de小郭4 天前
Flutter Analyzer 系列坑推进,必看,AI 时代这玩意最吃你内存
android·前端·flutter
LinXunFeng4 天前
拿竞品 App 一扫,技术栈全暴露了
android·flutter·开源
传奇开心果编程5 天前
【Flutter踩坑排雷】第28课:平台目录缺失与修复坑|`flutter create` 的“重建”与“覆盖”边界
android·flutter·ios·移动开发·跨平台·dart·声明式ui