3. Flutter - 基础组件 之 Text

1. Text 属性介绍

Text继承自StatelessWidget,Text 主要通过设置 文本布局 及 文本样式 控制显示方式。

1. 文本布局:例如文本对齐方式textAlign、文本排版方向 textDirection,文本显示最大行数maxLines、文本截断规则 overflow 等等

2 文本样式: 如字体名称fontFamily、字体大小 fontSize、文本颜色color、文本阴影 shadows等等,这些参数被统一封装到了构造函数中的参数 style(TextStyle)

以下属性介绍摘录自:flutter基础之组件基础Text
原文作者: 陌问MW

  • 文本布局 属性介绍
const Text(
  //String类型必传参数,为要显示的文本字符串
  this.data, {
  //以下为可选命名参数
  //  
  Key key,
  //TextStyle类型可选参数,用于设置文本的样式  
  this.style,
  //StrutStyle类型可选参数,用于设置文本支撑样式  
  this.strutStyle,
  //TextAlign类型可选参数,用于设置文本水平方向如何对齐
  this.textAlign,
  //TextDirection类型参数,用于设置文本的显示方向(从左到右或从右到左)  
  this.textDirection,
  //Locale类型参数,用于设置多语言,可以根据不同的区域设置以不同的方式呈现相同的 Unicode 字符。
  this.locale,
  //bool类型参数,用于设置文本是否自动换行,如果为 `true` ,自动换行显示,`false` 则不换行
  //在一行显示,超出屏幕部分不显示。默认为 `true`   
  this.softWrap,
  //TextOverflow类型参数,用于设置文本溢出时如何显示
  this.overflow,
  //double类型参数,用于设置文本的缩放倍数  
  this.textScaleFactor,
  //int类型参数,用于设置最大显示行数,如果超出限制则会根据 overflow 设置的溢出样式显示   
  this.maxLines,
  //String类型参数,于设置显示文本的替代语义标签 
  this.semanticsLabel,
  //TextWidthBasis类型参数 ,用于设置如何测量渲染文本的宽度  
  this.textWidthBasis,
})
  • 文本样式 属性介绍
 const TextStyle({
  //是否将空值替换为父级Widget文本样式中的值,也就是子Widget在没有定义样式
  //的情况下是否继承父级Widget中的文本样式
  this.inherit = true,
  //Color类型对象,用于设置文本字体颜色
  this.color,
  //Color类型对象,用于设置文本背景色
  this.backgroundColor,
  //double类型可选参数,字体大小
  this.fontSize,
  //FontWeight类型参数,粗体
  this.fontWeight,
  //FontStyle类型参数,设置字体样式,如斜体等
  this.fontStyle,
  //double类型可选参数,设置字母间距(空格)
  this.letterSpacing,
  //double类型可选参数,设置单词之间的间距
  this.wordSpacing,
  //TextBaseline类型可选参数,用于设置不同范围文本间的对齐基线
  this.textBaseline,
  //double类型可选参数,设置文本跨度的高度。当height为null或省略时,
  //行高将直接由字体的度量标准确定,这可能与fontSize不同。当height
  //为非空时,文本范围的行高将是fontSize的倍数,并且正好是fontSize * height逻辑像素高
  this.height,
  //Locale类型可选参数,多语言
  this.locale,
  //Paint类型可选参数,绘制文本的前景样式,比如描边文字等
  this.foreground,
  //Paint类型可选参数,绘制文本的背景样式,可以设置填充,描边,画笔宽度等
  this.background,
  //List<ui.Shadow>类型可选参数,用于在文字下方绘制阴影
  this.shadows,
  //List<FontFeature>类型可选参数,用于设置影响显示字体样式的列表
  this.fontFeatures,
  //TextDecoration类型可选参数,用于设置文字附近的装饰,例如下划线
  this.decoration,
  //Color类型可选参数,用于设置文字装饰的颜色
  this.decorationColor,
  //TextDecorationStyle类型参数,用于设置文字装饰的样式
  this.decorationStyle,
  //double类型可选参数,设置文字装饰的笔触的粗细诚意字体定义的粗细
  this.decorationThickness,
  //String类型可选参数,文本风格调式,调试版本可用
  this.debugLabel,
  //String类型可选参数,用于设置绘制文本时使用的字体名称
  String fontFamily,
  //list<String>类型可选参数,当在较高优先级的字体系列中找不到字形时,字体系列的有序列表将重新出现
  List<String> fontFamilyFallback,
  //String类型可选参数,要使用包中定义的字体系列,必须提供package参数
  String package,
})

2. 富文本

  在iOS中,我们可以使用NSAttributedString进行富文本设置。在Flutter中 我们可以通过Text.rich()RichText()进行富文本设置。

const Text.rich(
    InlineSpan this.textSpan, {
    Key? key,
    this.style,
    ...,
  })
RichText({
    Key? key,
    required this.text, // InlineSpan 类型
    this.textAlign = TextAlign.start,
    this.textDirection,
    ...  
  })

Text.rich 方法中的textSpan参数类型: InlineSpan
RichText构造函数的 text参数类型: InlineSpan

两者均为InlineSpan 类型,InlineSpan 为抽象类。

  • InlineSpan及其子类介绍
abstract class InlineSpan extends DiagnosticableTree {
  const InlineSpan({
    this.style,
  });

抽象类不能直接实例化。Flutter已为我们提供了

一个抽象子类:PlaceholderSpan
两个可实例化子类:WidgetSpanTextSpan

WidgetSpan 继承自 PlaceholderSpan

abstract class PlaceholderSpan extends InlineSpan {
  const PlaceholderSpan({
    this.alignment = ui.PlaceholderAlignment.bottom,
    this.baseline,
    TextStyle? style,
  })
class WidgetSpan extends PlaceholderSpan {  const WidgetSpan({
    required this.child,
    ui.PlaceholderAlignment alignment = ui.PlaceholderAlignment.bottom,
    TextBaseline? baseline,
    TextStyle? style,
  })
class TextSpan extends InlineSpan {
  const TextSpan({
    this.text,
    this.children,
    TextStyle? style,
    this.recognizer,
    this.semanticsLabel,
  }) 
  • 示例代码:

方式1 Text.rich()
//富文本设置 Text.rich()
class Text_RichDemo extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Text.rich(TextSpan(children: [
      TextSpan(
          text: "《定风波》",
          style: TextStyle(
              fontSize: 25, fontWeight: FontWeight.bold, color: Colors.black)),
      TextSpan(
          text: "苏轼", style: TextStyle(fontSize: 18, color: Colors.redAccent)),
      TextSpan(
          text: "\n莫听穿林打叶声,何妨吟啸且徐行。\n竹杖芒鞋轻胜马,谁怕?一蓑烟雨任平生。",
          style: TextStyle(color: Colors.blue, fontSize: 20))
    ]));
  }
}
方式 2 RichText()
//富文本设置 RichText()
class RishTextDemo2 extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return RichText(
      text: TextSpan(children: [
        TextSpan(
            text: "《定风波》",
            style: TextStyle(
                fontSize: 25,
                fontWeight: FontWeight.bold,
                color: Colors.black)),
        TextSpan(
            text: "苏轼",
            style: TextStyle(fontSize: 18, color: Colors.redAccent)),
        TextSpan(
            text: "\n莫听穿林打叶声,何妨吟啸且徐行。\n竹杖芒鞋轻胜马,谁怕?一蓑烟雨任平生。",
            style: TextStyle(color: Colors.blue, fontSize: 20))
      ]),
    );
  }
}
Simulator Screen Shot - iPhone 11 - 2021-03-13 at 17.59.50.png
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,837评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,551评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,417评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,448评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,524评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,554评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,569评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,316评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,766评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,077评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,240评论 1 343
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,912评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,560评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,176评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,425评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,114评论 2 366
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,114评论 2 352

推荐阅读更多精彩内容