文本组件(Text)负责显示文本和定义显示样式,常用属性如下:
属性名 | 类型 | 默认值 | 说明 |
data | String | 数据为要显示的文本 | |
maxLines | int | 文本显示的最大行数 | |
style | TextStyle | null | 文本样式,可定义文本的字体大小、颜色、粗细等 |
textAlign | TextAlign | TextAlign.center | 文本水平方向对齐方式,取值有center、end、justify、left、right、start、values |
textDirection | TextDirection | TextDirection.ltr | 有些文本书写的方向是从左到右,比如英语、泰米尔语、中文,有些则是从右到左,比如亚拉姆语、希伯来语、乌尔都语。从左到右使用TextDirection.ltr,从右到左使用TextDirection.rtl |
textScaleFactor | double | 1.0 | 字体缩放系数,比如,如果此属性设置的值为1.5,那么字体会放大150%,也就是说比原来的大了50% |
textSpan | TextSpan | null | 文本块,TextSpan里可以包含文本内容及样式 |
softWrap | bool | TRUE | 某一行中文本过长,是否需要换行。默认为true,如果为false,则文本中的字形将被定位为好像存在无限的水平空间。 |
overflow | TextOverflow | TextOverflow.clip | TextOverflow.clip:剪切溢出的文本以修复其容器。 TextOverflow.ellipsis:使用省略号表示文本已溢出。 TextOverflow.fade:将溢出的文本淡化为透明。 |
TextStyle style
属性名 | 说明 |
Color color | 文本颜色。 如果指定了foreground,则此值必须为null。 |
TextDecoration decoration | 绘制文本装饰: 下划线(TextDecoration.underline) 上划线(TextDecoration.overline) 删除线(TextDecoration.lineThrough) 无(TextDecoration.none) |
Color decorationColor | 绘制文本装饰的颜色。 |
TextDecorationStyle decorationStyle | 绘制文本装饰的样式: 画一条虚线 TextDecorationStyle.dashed 画一条虚线 TextDecorationStyle.dotted 画两条线 TextDecorationStyle.double 画一条实线 TextDecorationStyle.solid 画一条正弦线(波浪线) TextDecorationStyle.wavy |
FontWeight fontWeight | 绘制文本时使用的字体粗细: FontWeight.bold 常用的字体重量比正常重。即w700 FontWeight.normal 默认字体粗细。即w400 FontWeight.w100 薄,最薄 FontWeight.w200 特轻 FontWeight.w300 轻 FontWeight.w400 正常/普通/平原 FontWeight.w500 较粗 FontWeight.w600 半粗体 FontWeight.w700 加粗 FontWeight.w800 特粗 FontWeight.w900 最粗 |
FontStyle fontStyle | 字体变体: FontStyle.italic 使用斜体 FontStyle.normal 使用直立 |
TextBaseline textBaseline | 对齐文本的水平线: TextBaseline.alphabetic:文本基线是标准的字母基线 TextBaseline.ideographic:文字基线是表意字基线;如果字符本身超出了alphabetic 基线,那么ideograhpic基线位置在字符本身的底部。 |
String fontFamily | 使用的字体名称(例如,Roboto)。如果字体是在包中定义的,那么它将以'packages / package_name /'为前缀(例如'packages / cool_fonts / Roboto') |
double fontSize | 字体大小(pt、sp),默认为14个逻辑像素(14pt、14sp) |
double letterSpacing | 水平字母之间的空间间隔(逻辑像素为单位)。可以使用负值来让字母更接近。 |
double wordSpacing | 单词之间添加的空间间隔(逻辑像素为单位)。可以使用负值来使单词更接近。 |
double height | 文本行与行的高度,作为字体大小的倍数(取值1~2,如1.2) |
Locale locale | 此属性很少设置,用于选择区域特定字形的语言环境 |
Paint background | 文本背景色 |
Paint foreground | 文本的前景色,不能与color共同设置(比文本颜色color区别在Paint功能多,后续会讲解) |
List<Shadow> shadows | 详解:Flutter Decoration背景设定(边框、圆角、阴影、形状、渐变、背景图像等) |
TextAlign textAlign
属性名 | 说明 |
TextAlign.center | 将文本对齐容器的中心。 |
TextAlign.end | 对齐容器后缘上的文本。 |
TextAlign.justify | 拉伸以结束的文本行以填充容器的宽度。即使用了decorationStyle才起效 |
TextAlign.left | 对齐容器左边缘的文本。 |
TextAlign.right | 对齐容器右边缘的文本。 |
TextAlign.start | 对齐容器前缘上的文本。 |