Flutter Text 参数详解
1.继承关系
Object > Diagnosticable > DiagnosticableTree > Widget > StatelessWidget > Text
2.介绍
显示“ 文本”单个样式的文本字符串小组件。
3.创建Text
创建有三种,效果如下:
new Text() |
构造方法创建,只能生成一种style |
Text.rich() |
静态方法创建,能够生成多种style |
new RichText() |
与Text.rich()一样 |
构造方法源码:
/// Creates a text widget./// If the [style] argument is null, the text will use the style from the closest enclosing [DefaultTextStyle].const Text(this.data, {Key key,this.style,this.textAlign,this.textDirection,this.locale,this.softWrap,this.overflow,this.textScaleFactor,this.maxLines,this.semanticsLabel,}) : assert(data != null), textSpan = null, super(key: key);/// Creates a text widget with a [TextSpan].const Text.rich(this.textSpan, {Key key,this.style,this.textAlign,this.textDirection,this.locale,this.softWrap,this.overflow,this.textScaleFactor,this.maxLines,this.semanticsLabel,}): assert(textSpan != null), data = null, super(key: key);/// Creates a paragraph of rich text.const RichText({Key key,@required this.text,this.textAlign = TextAlign.start,this.textDirection,this.softWrap = true,this.overflow = TextOverflow.clip,this.textScaleFactor = 1.0,this.maxLines,this.locale,}) : assert(text != null) ,assert(textAlign != null), assert(softWrap != null), assert(overflow != null),assert(textScaleFactor != null), assert(maxLines == null || maxLines > 0), super(key: key);
4.参数讲解
参数Key key:官方解释:https://flutterchina.club/widgets-intro/#key
4.1 String data
要显示的字符串
4.2 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背景设定(边框、圆角、阴影、形状、渐变、背景图像等) |
该 style 参数可选。省略时,文本将使用最接近的DefaultTextStyle的样式。如果给定样式的TextStyle.inherit属性为true(默认值),则给定样式将与最接近的DefaultTextStyle合并。例如,这种合并行为很有用,可以在使用默认字体系列和大小时使文本变为粗体。
4.3 TextAlign textAlign
文本应如何水平对齐enum
值 | 说明 |
TextAlign.center |
将文本对齐容器的中心。 |
TextAlign.end |
对齐容器后缘上的文本。 |
TextAlign.justify |
拉伸以结束的文本行以填充容器的宽度。即使用了decorationStyle才起效 |
TextAlign.left |
对齐容器左边缘的文本。 |
TextAlign.right |
对齐容器右边缘的文本。 |
TextAlign.start |
对齐容器前缘上的文本。 |
4.4 TextDirection textDirection
这个属性估计是给外国人习惯使用,
相对TextAlign中的start、end而言有用(当start使用了ltr相当于end使用了rtl,也相当于TextAlign使用了left)
对于从左到右的文本(TextDirection.ltr),文本从左向右流动;
对于从右到左的文本(TextDirection.rtl),文本从右向左流动。
4.5 Locale locale
此属性很少设置,用于选择区域特定字形的语言环境
4.6 bool softWrap
某一行中文本过长,是否需要换行。默认为true,如果为false,则文本中的字形将被定位为好像存在无限的水平空间。
4.7 TextOverflow overflow
如何处理视觉溢出:
TextOverflow.clip |
剪切溢出的文本以修复其容器。 |
TextOverflow.ellipsis |
使用省略号表示文本已溢出。 |
TextOverflow.fade |
将溢出的文本淡化为透明。 |
4.8 double textScaleFactor
每个逻辑像素的字体像素数
例如,如果文本比例因子为1.5,则文本将比指定的字体大小大50%。
作为textScaleFactor赋予构造函数的值。如果为null,将使用从环境MediaQuery获取的MediaQueryData.textScaleFactor 即手机的像素密度(1.0、1.5、2.0、3.0)
4.9 int maxLines
文本要跨越的可选最大行数,
为1,则文本不会换行。否则,文本将被包裹在框的边缘。
4.10 String semanticsLabel
图像的语义描述,用于向Andoid上的TalkBack和iOS上的VoiceOver提供图像描述
talkback是一款由谷歌官方开发的系统软件,它的定位是帮助盲人或者视力有障碍的用户提供语言辅助
Voiceover功能是APPLE公司在2009年4月新推出的一种语音辅助程序
5.参考:
https://docs.flutter.io/flutter/widgets/Text-class.html
https://docs.flutter.io/flutter/painting/TextStyle-class.html
sdk源码
6.代码示例:
import 'package:flutter/material.dart';void main() {runApp(new MaterialApp(title: 'My app', // used by the OS task switcherhome: new MyStartUI(),));
}// Image
class MyStartUI extends StatelessWidget {@overrideWidget build(BuildContext context) {return new Scaffold(appBar: new AppBar(leading: new IconButton(icon: new Icon(Icons.menu),onPressed: null,),),body: new Column(mainAxisAlignment: MainAxisAlignment.center,children: [new Expanded(flex: 1, child: getTextRich()),new Expanded(flex: 1, child: getText()),
// new Expanded(flex: 1, child: getImage()),
// new Expanded(flex: 1, child: getRow()),],));}Widget getText() {Paint pg = Paint();pg.color = Color(0xFF3344FF);Paint pf = Paint();pf.color = Color(0xFF7243FF);return Text('Text\nTe\nxt ---- Style -------------',style: TextStyle(color: Color(0xFFFF00FF),decoration: TextDecoration.underline,decorationColor: Color(0xFF334433),decorationStyle: TextDecorationStyle.double,fontWeight: FontWeight.w500,fontStyle: FontStyle.italic,textBaseline: TextBaseline.alphabetic,fontSize: 50,letterSpacing: 2,wordSpacing: 10,height: 1.2,background: pg,
// foreground: pf,),textAlign: TextAlign.start,textDirection: TextDirection.ltr,softWrap: false,semanticsLabel: "Text semanticsLabel",
// overflow: TextOverflow.ellipsis,);}Widget getTextRich() {List children = new List<TextSpan>();children.add(TextSpan(text: "Chen", style: TextStyle(color: Colors.black)));children.add(TextSpan(text: "Ying", style: TextStyle(color: Colors.red)));children.add(TextSpan(text: "you", style: TextStyle(color: Colors.blue)));List children1 = new List<TextSpan>();children1.add(TextSpan(text: " Is ", style: TextStyle(color: Colors.blueAccent)));children1.add(TextSpan(text: "Androider", style: TextStyle(color: Colors.amber)));children.add(TextSpan(children: children1, style: TextStyle(color: Colors.blue)));TextSpan textSpan = new TextSpan(children: children);return Text.rich(textSpan,);}
Flutter Text 参数详解相关推荐
- Flutter Container 参数详解
1 基本内容 1.1 继续关系 Object > Diagnosticable > DiagnosticableTree > Widget > StatelessWidget ...
- Flutter Scaffold 参数详解
1.Scaffold 1.1 继承关系 Object > Diagnosticable > DiagnosticableTree > Widget > StatefulWidg ...
- spring boot 实战 / 可执行war启动参数详解
概述 上一篇文章<spring boot 实战 / mvn spring-boot:run 参数详解>主要讲解了spring boot 项目基于maven插件启动过程中借助profil ...
- Android 系统Dimension和间距参数详解
Android作为一个开放性的手持装置作业系统,势必面对终端显示器有多种不同规格的情况,这对程式开发者会有一定程度的困扰. 意图成为"云端的微软"的Google自然不会傻到任由开 ...
- stylecloud.gen_stylecloud() 参数详解
参数详解: def gen_stylecloud(text=None,file_path=None, # 输入文本/CSV 的文件路径size=512, # stylecloud 的大小(长度和宽度) ...
- 【Nginx】Nginx配置文件参数/启动参数详解;启动/停止/重新加载配置命令
nginx配置文件 nginx及其模块的工作方式是由配置文件指定,默认情况下配置文件被命名为nginx.conf并且存放在/usr/local/nginx/conf或者 /etc/nginx或者 /u ...
- nginx下gzip配置参数详解
这篇文章主要介绍了nginx下gzip配置参数详解,本文同时给出了配置例子,以及一些注意事项,需要的朋友可以参考下 Nginx自带的有gzip模块 http://wiki.nginx.org/Ngin ...
- 布局中文件中【控件间距参数详解以及单位选择】
注意:例如:android:layout_gravity和android:gravity的区别: android:layout_gravity:此控件相对父控件的相对位置 android:gravit ...
- PHP curl 参数详解
PHP curl参数详解,分享一下. curl_setopt (PHP 4 >= 4.0.2) curl_setopt -- 为CURL调用设置一个选项 描述 bool curl_setopt ...
最新文章
- python语音翻译软件下载_python软件翻译
- 半导体到底靠什么导电?
- 面向对象三大特征——继承
- 深入理解编译注解(四)常用接口介绍
- java 数据结构 快速入门_Java 数据结构快速入门
- 深入浅出百亿请求高可用Redis(codis)分布式集群揭秘
- 3009基于二叉链表的二叉树结点个数的统计(附思路)
- 解决SQLPLUS无法使用上下箭头
- 远程采集Linux硬盘信息,关关采集器利用远程SFTP采集 Linux放主站+windows采集教程...
- 大学物理2-2笔记(5)麦克斯韦电磁场理论
- Unity 中实现 打击感的物理
- 方舟服务器建家位置,《方舟生存进化》五种建家位置!每一种都能暴露建造者的种类!...
- vim下区块的复制与黏贴
- Mac相关配置(本地host,端口被占用)
- Go云原生高性能编程技法,值得观看
- matlab读入stl文件,matlab读取stl文件
- 卫星影像免费下载地址
- macbook pro 700自己换SSD 开启AHC
- Day 07-常用Composition API_watch监听器 和 watchEffect高级监听器
- 【音视频】弱网下实时视频的极限通信