文本及样式

Text

Text用于显示简单样式文本，它包含一些控制文本显示样式的一些属性，一个简单的例子如下：

  1. Text("Hello world",
  2.   textAlign: TextAlign.center,
  3. );
  5. Text("Hello world! I'm Jack. "*4,
  6.   maxLines: 1,
  7.   overflow: TextOverflow.ellipsis,
  8. );
  10. Text("Hello world",
  11.   textScaleFactor: 1.5,
  12. );

运行效果如下：

image-20180829103242552

  • textAlign：文本的对齐方式；可以选择左对齐、右对齐还是居中。注意，对齐的参考系是Text widget本身。本例中虽然是指定了居中对齐，但因为Text文本内容宽度不足一行，Text的宽度和文本内容长度相等，那么这时指定对齐方式是没有意义的，只有Text宽度大于文本内容长度时指定此属性才有意义。下面我们指定一个较长的字符串：

    1. Text("Hello world "*6,  //字符串重复六次
    2.   textAlign: TextAlign.center,
    3. )；

    运行效果如下：

    image-20180829104807535

​ 字符串内容超过一行，Text宽度等于屏幕宽度，第二行文本便会居中显示。

  • maxLines、overflow：指定文本显示的最大行数，默认情况下，文本是自动折行的，如果指定此参数，则文本最多不会超过指定的行。如果有多余的文本，可以通过overflow来指定截断方式，默认是直接截断，本例中指定的截断方式TextOverflow.ellipsis，它会将多余文本截断后以省略符“…”表示；TextOverflow的其它截断方式请参考SDK文档。
  • textScaleFactor：代表文本相对于当前字体大小的缩放因子，相对于去设置文本的样式style属性的fontSize，它是调整字体大小的一个快捷方式。该属性的默认值可以通过MediaQueryData.textScaleFactor获得，如果没有MediaQuery，那么会默认值将为1.0。

TextStyle

TextStyle用于指定文本显示的样式如颜色、字体、粗细、背景等。我们看一个示例：

  1. Text("Hello world",
  2.   style: TextStyle(
  3.     color: Colors.blue,
  4.     fontSize: 18.0,
  5.     height: 1.2,  
  6.     fontFamily: "Courier",
  7.     background: new Paint()..color=Colors.yellow,
  8.     decoration:TextDecoration.underline,
  9.     decorationStyle: TextDecorationStyle.dashed
  10.   ),
  11. );

效果如下：

image-20180829111601391

此示例只展示了TextStyle的部分属性，它还有一些其它属性，属性名基本都是自解释的，在此不再赘述，读者可以查阅SDK文档。值得注意的是：

  • height：该属性用于指定行高，但它并不是一个绝对值，而是一个因子，具体的行高等于fontSize*height。

  • fontFamily ：由于不同平台默认支持的字体集不同，所以在手动指定字体时一定要先在不同平台测试一下。

  • fontSize：该属性和Text的textScaleFactor都用于控制字体大小。但是有两给主要区别：

    • fontSize可以精确指定字体大小，而textScaleFactor只能通过缩放比例来控制。
    • textScaleFactor主要是用于系统字体大小设置改变时对Flutter应用字体进行全局调整，而fontSize通常用于单个文本。

TextSpan

在上面的例子中，Text的所有文本内容只能按同一种样式，如果我们需要对一个Text内容的不同部分按照不同的样式显示，这时就可以使用TextSpan，它代表文本的一个“片段”。我们看看TextSpan的定义:

  1. const TextSpan({
  2.   TextStyle style, 
  3.   Sting text,
  4.   List<TextSpan> children,
  5.   GestureRecognizer recognizer,
  6. });

其中style 和 text属性代表该文本片段的样式和内容。 children是一个TextSpan的数组，也就是说TextSpan可以包括其他TextSpan。而recognizer用于对该文本片段上用于手势进行识别处理。下面我们看一个效果，然后用TextSpan实现它。

image-20180829114929736

源码：

  1. Text.rich(TextSpan(
  2.     children: [
  3.      TextSpan(
  4.        text: "Home: "
  5.      ),
  6.      TextSpan(
  7.        text: "https://flutterchina.club",
  8.        style: TextStyle(
  9.          color: Colors.blue
  10.        ),  
  11.        recognizer: _tapRecognizer
  12.      ),
  13.     ]
  14. ))
  • 上面代码中，我们通过TextSpan实现了一个基础文本片段和一个链接片段，然后通过Text.rich 方法将TextSpan 添加到Text中，之所以可以这样做，是因为Text其实就是RichText的一个包装，而RichText是可以显示多种样式的(富文本)的widget。
  • _tapRecognizer，它是点击链接后的一个处理器（代码已省略），关于手势识别的更多内容我们将在后面单独介绍。

DefaultTextStyle

在widget树中，文本的样式默认是可以被继承的，因此，如果在widget树的某一个节点处设置一个默认的文本样式，那么该节点的子树中所有文本都会默认使用这个样式，而DefaultTextStyle正是用于设置默认文本样式的。下面我们看一个例子：

  1. DefaultTextStyle(
  2.   //1.设置文本默认样式  
  3.   style: TextStyle(
  4.     color:Colors.red,
  5.     fontSize: 20.0,
  6.   ),
  7.   textAlign: TextAlign.start,
  8.   child: Column(
  9.     crossAxisAlignment: CrossAxisAlignment.start,
  10.     children: <Widget>[
  11.       Text("hello world"),
  12.       Text("I am Jack"),
  13.       Text("I am Jack",
  14.         style: TextStyle(
  15.           inherit: false, //2.不继承默认样式
  16.           color: Colors.grey
  17.         ),
  18.       ),
  19.     ],
  20.   ),
  21. );

上面代码中，我们首先设置了一个默认的文本样式，即字体为20像素(逻辑像素)、颜色为红色。然后通过DefaultTextStyle 设置给了子树Column节点处，这样一来Column的所有子孙Text默认都会继承该样式，除非Text显示指定不继承样式，如代码中注释2。示例运行效果如下：

image-20180829135406156

使用字体

可以在Flutter应用程序中使用不同的字体。例如，我们可能会使用设计人员创建的自定义字体，或者其它第三方的字体，如Google Fonts中的字体。本节将介绍如何为Flutter应用配置字体，并在渲染文本时使用它们。

在Flutter中使用字体分两步完成。首先在pubspec.yaml中声明它们，以确保它们会打包到应用程序中。然后通过TextStyle属性使用字体。

在asset中声明

要将字体打文件打包到应用中，和使用其它资源一样，要先在pubspec.yaml中声明它。然后将字体文件复制到在pubspec.yaml中指定的位置。如：

  1. flutter:
  2.   fonts:
  3.     - family: Raleway
  4.       fonts:
  5.         - asset: assets/fonts/Raleway-Regular.ttf
  6.         - asset: assets/fonts/Raleway-Medium.ttf
  7.           weight: 500
  8.         - asset: assets/fonts/Raleway-SemiBold.ttf
  9.           weight: 600
  10.     - family: AbrilFatface
  11.       fonts:
  12.         - asset: assets/fonts/abrilfatface/AbrilFatface-Regular.ttf

使用字体

  1. // 声明文本样式
  2. const textStyle = const TextStyle(
  3.   fontFamily: 'Raleway',
  4. );
  6. // 使用文本样式
  7. var buttonText = const Text(
  8.   "Use the font for this text",
  9.   style: textStyle,
  10. );

Package中的字体

要使用Package中定义的字体，必须提供package参数。例如，假设上面的字体声明位于my_package包中。然后创建TextStyle的过程如下：

  1. const textStyle = const TextStyle(
  2.   fontFamily: 'Raleway',
  3.   package: 'my_package', //指定包名
  4. );

如果在package包内部使用它自己定义的字体，也应该在创建文本样式时指定package参数，如上例所示。

一个包也可以只提供字体文件而不需要在pubspec.yaml中声明。 这些文件应该包的lib/文件夹中。字体文件不会自动绑定到应用程序中，应用程序可以在声明字体时有选择地使用这些字体。假设一个名为my_package的包中有一个字体文件：

  1. lib/fonts/Raleway-Medium.ttf

然后，应用程序可以声明一个字体，如下面的示例所示：

  1.  flutter:
  2.    fonts:
  3.      - family: Raleway
  4.        fonts:
  5.          - asset: assets/fonts/Raleway-Regular.ttf
  6.          - asset: packages/my_package/fonts/Raleway-Medium.ttf
  7.            weight: 500

lib/是隐含的，所以它不应该包含在asset路径中。

在这种情况下，由于应用程序本地定义了字体，所以在创建TextStyle时可以不指定package参数：

  1. const textStyle = const TextStyle(
  2.   fontFamily: 'Raleway',
  3. );