企业🤖AI智能体构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
## 文本及样式 ### Text Text用于显示简单样式文本,它包含一些控制文本显示样式的一些属性,一个简单的例子如下: ``` Text("Hello world", textAlign: TextAlign.center, ); Text("Hello world! I'm Jack. "*4, maxLines: 1, overflow: TextOverflow.ellipsis, ); Text("Hello world", textScaleFactor: 1.5, ); ``` 运行效果如下: ![](https://box.kancloud.cn/e95eb7479ba3c0b9a0ec867d0d4ebee6_502x210.png) - `textAlign`:文本的对齐方式;可以选择左对齐、右对齐还是居中。注意,对齐的参考系是Text widget本身。本例中虽然是指定了居中对齐,但因为Text文本内容宽度不足一行,Text的宽度和文本内容长度相等,那么这时指定对齐方式是没有意义的,只有Text宽度大于文本内容长度时指定此属性才有意义。下面我们指定一个较长的字符串: ``` Text("Hello world "*6, //字符串重复六次 textAlign: TextAlign.center, ); ``` 运行效果如下: ![](https://box.kancloud.cn/eccc3a0c2a5f5cebd32493b8c41cea52_478x60.png) 字符串内容超过一行,Text宽度等于屏幕宽度,第二行文本便会居中显示。 - `maxLines`、`overflow`:指定文本显示的最大行数,默认情况下,文本是自动折行的,如果指定此参数,则文本最多不会超过指定的行。如果有多余的文本,可以通过`overflow`来指定截断方式,默认是直接截断,本例中指定的截断方式`TextOverflow.ellipsis`,它会将多余文本截断后以省略符“...”表示;TextOverflow的其它截断方式请参考SDK文档。 - `textScaleFactor`:代表文本相对于当前字体大小的缩放因子,相对于去设置文本的样式`style`属性的`fontSize`,它是调整字体大小的一个快捷方式。该属性的默认值可以通过`MediaQueryData.textScaleFactor`获得,如果没有`MediaQuery`,那么会默认值将为1.0。 ### TextStyle TextStyle用于指定文本显示的样式如颜色、字体、粗细、背景等。我们看一个示例: ``` Text("Hello world", style: TextStyle( color: Colors.blue, fontSize: 18.0, height: 1.2, fontFamily: "Courier", background: new Paint()..color=Colors.yellow, decoration:TextDecoration.underline, decorationStyle: TextDecorationStyle.dashed ), ); ``` 效果如下: ![](https://box.kancloud.cn/f4143207e8bc5409b91e5dd021dd8f1a_202x40.png) 此示例只展示了TextStyle的部分属性,它还有一些其它属性,属性名基本都是自解释的,在此不再赘述,读者可以查阅SDK文档。值得注意的是: - `height`:该属性用于指定行高,但它并不是一个绝对值,而是一个因子,具体的行高等于`fontSize`\*`height`。 - `fontFamily` :由于不同平台默认支持的字体集不同,所以在手动指定字体时一定要先在不同平台测试一下。 - `fontSize`:该属性和Text的`textScaleFactor`都用于控制字体大小。但是有两给主要区别: - `fontSize`可以精确指定字体大小,而`textScaleFactor`只能通过缩放比例来控制。 - `textScaleFactor`主要是用于系统字体大小设置改变时对Flutter应用字体进行全局调整,而`fontSize`通常用于单个文本。 ### TextSpan 在上面的例子中,Text的所有文本内容只能按同一种样式,如果我们需要对一个Text内容的不同部分按照不同的样式显示,这时就可以使用`TextSpan`,它代表文本的一个“片段”。我们看看TextSpan的定义: ``` const TextSpan({ TextStyle style, Sting text, List<TextSpan> children, GestureRecognizer recognizer, }); ``` 其中`style` 和 `text`属性代表该文本片段的样式和内容。 `children`是一个`TextSpan`的数组,也就是说`TextSpan`可以包括其他`TextSpan`。而`recognizer`用于对该文本片段上用于手势进行识别处理。下面我们看一个效果,然后用`TextSpan`实现它。 ![](https://box.kancloud.cn/cc415da2ed3d3cc497c43a667a2d1303_296x54.png) 源码: ``` Text.rich(TextSpan( children: [ TextSpan( text: "Home: " ), TextSpan( text: "https://flutterchina.club", style: TextStyle( color: Colors.blue ), recognizer: _tapRecognizer ), ] )) ``` - 上面代码中,我们通过TextSpan实现了一个基础文本片段和一个链接片段,然后通过`Text.rich` 方法将`TextSpan` 添加到Text中,之所以可以这样做,是因为Text其实就是RichText的一个包装,而RichText是可以显示多种样式(富文本)的widget。 - `_tapRecognizer`,它是点击链接后的一个处理器(代码已省略),关于手势识别的更多内容我们将在后面单独介绍。 ### DefaultTextStyle 在widget树中,文本的样式默认是可以被继承的,因此,如果在widget树的某一个节点处设置一个默认的文本样式,那么该节点的子树中所有文本都会默认使用这个样式,而DefaultTextStyle正是用于设置默认文本样式的。下面我们看一个例子: ``` DefaultTextStyle( //1.设置文本默认样式 style: TextStyle( color:Colors.red, fontSize: 20.0, ), textAlign: TextAlign.start, child: Column( crossAxisAlignment: CrossAxisAlignment.start, children: <Widget>[ Text("hello world"), Text("I am Jack"), Text("I am Jack", style: TextStyle( inherit: false, //2.不继承默认样式 color: Colors.grey ), ), ], ), ); ``` 上面代码中,我们首先设置了一个默认的文本样式,即字体为20像素(逻辑像素)、颜色为红色。然后通过`DefaultTextStyle` 设置给了子树Column节点处,这样一来Column的所有子孙Text默认都会继承该样式,除非Text显示指定不继承样式,如代码中注释2。示例运行效果如下: ![](https://box.kancloud.cn/bb214e702e73b8eac48fcd63bdc249dd_346x122.png) ### 使用字体 可以在Flutter应用程序中使用不同的字体。例如,我们可能会使用设计人员创建的自定义字体,或者其它第三方的字体,如[Google Fonts](https://fonts.google.com/)中的字体。本节将介绍如何为Flutter应用配置字体,并在渲染文本时使用它们。 在Flutter中使用字体分两步完成。首先在`pubspec.yaml`中声明它们,以确保它们会打包到应用程序中。然后通过[`TextStyle`](https://docs.flutter.io/flutter/painting/TextStyle-class.html)属性使用字体。 #### 在asset中声明 要将字体打文件打包到应用中,和使用其它资源一样,要先在`pubspec.yaml`中声明它。然后将字体文件复制到在`pubspec.yaml`中指定的位置。如: ``` flutter: fonts: - family: Raleway fonts: - asset: assets/fonts/Raleway-Regular.ttf - asset: assets/fonts/Raleway-Medium.ttf weight: 500 - asset: assets/fonts/Raleway-SemiBold.ttf weight: 600 - family: AbrilFatface fonts: - asset: assets/fonts/abrilfatface/AbrilFatface-Regular.ttf ``` #### 使用字体 ``` // 声明文本样式 const textStyle = const TextStyle( fontFamily: 'Raleway', ); // 使用文本样式 var buttonText = const Text( "Use the font for this text", style: textStyle, ); ``` #### Package中的字体 要使用Package中定义的字体,必须提供`package`参数。例如,假设上面的字体声明位于`my_package`包中。然后创建TextStyle的过程如下: ``` const textStyle = const TextStyle( fontFamily: 'Raleway', package: 'my_package', //指定包名 ); ``` 如果在package包内部使用它自己定义的字体,也应该在创建文本样式时指定`package`参数,如上例所示。 一个包也可以只提供字体文件而不需要在pubspec.yaml中声明。 这些文件应该存放在包的`lib/`文件夹中。字体文件不会自动绑定到应用程序中,应用程序可以在声明字体时有选择地使用这些字体。假设一个名为my\_package的包中有一个字体文件: ``` lib/fonts/Raleway-Medium.ttf ``` 然后,应用程序可以声明一个字体,如下面的示例所示: ``` flutter: fonts: - family: Raleway fonts: - asset: assets/fonts/Raleway-Regular.ttf - asset: packages/my_package/fonts/Raleway-Medium.ttf weight: 500 ``` `lib/`是隐含的,所以它不应该包含在asset路径中。 在这种情况下,由于应用程序本地定义了字体,所以在创建TextStyle时可以不指定`package`参数: ``` const textStyle = const TextStyle( fontFamily: 'Raleway', ); ```