Flutter实战】文本组件及五大案例

时间  2020-06-22
标签 flutter 实战 文本 组件 五大 案例 繁體版
原文   原文链接

老孟导读：你们好，这是【Flutter实战】系列文章的第二篇，这一篇讲解文本组件，文本组件包括文本展现组件（Text和RichText）和文本输入组件（TextField），基础用法和五个案例助你快速掌握。
第一篇连接： 【Flutter实战】移动技术发展史

Text

Text是显示文本的组件，最经常使用的组件，没有之一。基本用法以下：前端

Text('老孟')

注意：Text组件必定要包裹在Scaffold组件下，不然效果以下：android

文本的样式在style中设置，类型为TextStyle，TextStyle中包含不少文本样式属性，下面介绍一些经常使用的。ios

设置文本大小和颜色：git

Text('老孟',style: TextStyle(color: Colors.red,fontSize: 20),),

上面黑色的字体为没有设置的效果，做为对比。github

设置字体粗细：api

Text('老孟',style: TextStyle(fontWeight: FontWeight.bold))

字体粗细共有9个级别，为w100至w900，FontWeight.bold是w700。微信

设置斜体：ide

Text('老孟',style: TextStyle(fontStyle: FontStyle.italic,))

设置自定义的字体：post

  1. 首先下载字体库（好比中华字体库）
  2. 将字体文件拷贝的项目中，通常目录是：assets/fonts/，assets和fonts都须要手动建立，此目录不是必须的，而是约定俗成，资源通常都放在assets目录下。
  3. 配置pubspec.yaml：
fonts:
  - family: maobi 
    fonts:
      - asset: assets/fonts/maobi.ttf

maobi：是本身对当前字体的命名，有意义便可。字体

asset：字体文件的目录。

使用：

Text('老孟', style: TextStyle(fontFamily: 'maobi',)),

设置对齐方式：

Container(
  height: 100,
  width: 200,
  color: Colors.blue.withOpacity(.4),
  child: Text('老孟', textAlign: TextAlign.center),
),

textAlign只是控制水平方向的对齐方式，值说明以下：

  • left：左对齐
  • right：右对齐
  • center：居中
  • justify：两端对齐，此属性中文存在bug（Flutter版本：1.17.3）也能够在官方issue中关注此问题
  • start：前端对齐，和TextDirection属性有关，若是设置TextDirection.ltr，则左对齐，设置TextDirection.rtl则右对齐。
  • end：末端对齐，和TextDirection属性有关，若是设置TextDirection.ltr，则右对齐，设置TextDirection.rtl则左对齐。

设置文本自动换行：

Container(
  height: 100,
  width: 200,
  color: Colors.blue.withOpacity(.4),
  child: Text('老孟，专一分享Flutter技术和应用实战',softWrap: true,),
)

文本超出范围时的处理：

Container(
  height: 100,
  width: 200,
  color: Colors.blue.withOpacity(.4),
  child: Text('老孟，专一分享Flutter技术和应用实战',overflow: TextOverflow.ellipsis,),
)

溢出的处理方式：

  • clip：直接裁剪。
  • fade：愈来愈透明。
  • ellipsis：省略号结尾。
  • visible：依然显示，此时将会溢出父组件。

设置全局字体样式：

在MaterialApp的theme中设置以下

MaterialApp(
  title: 'Flutter Demo',
  theme: ThemeData(
   ...
    textTheme: TextTheme(
        bodyText2: TextStyle(color: Colors.red,fontSize: 24),
    )
  ),
  home: Scaffold(
    body: TextDemo(),
  ),
)

Text组件默认为红色，

Text('老孟'),

Text('老孟',style: TextStyle(color: Colors.blue,fontSize: 20),),

RichText

RichText的属性和Text基本同样，使用以下：

RichText(
  text: TextSpan(
      style: DefaultTextStyle.of(context).style,
      children: <InlineSpan>[
        TextSpan(text: '老孟', style: TextStyle(color: Colors.red)),
        TextSpan(text: '，'),
        TextSpan(text: '专一分享Flutter技术和应用实战'),
      ]),
)

TextField

TextField是文本输入组件，即输入框，经常使用组件之一。基本用法：

TextField()

不须要任何参数，一个最简单的文本输入组件就出来了，效果以下：

decoration是TextField组件的装饰（外观）参数，类型是InputDecoration。

icon显示在输入框的前面，用法以下：

TextField(
  decoration: InputDecoration(
    icon: Icon(Icons.person),
  ),
)

当输入框是空并且没有焦点时，labelText显示在输入框上边，当获取焦点或者不为空时labelText往上移动一点，labelStyle参数表示文本样式，具体参考TextStyle， 用法以下：

TextField(
  decoration: InputDecoration(
    labelText: '姓名：',
    labelStyle: TextStyle(color:Colors.red)
  ),
)

hasFloatingPlaceholder参数控制当输入框获取焦点或者不为空时是否还显示labelText，默认为true，显示。

helperText显示在输入框的左下部，用于提示用户，helperStyle参数表示文本样式，具体参考TextStyle用法以下：

TextField(
  decoration: InputDecoration(
    helperText: '用户名长度为6-10个字母',
    helperStyle: TextStyle(color: Colors.blue),
    helperMaxLines: 1
  ),
)

hintText是当输入框为空时的提示，不为空时不在显示，用法以下：

TextField(
  decoration: InputDecoration(
    hintText: '请输入用户名',
    hintStyle: TextStyle(color: Colors.grey),
    hintMaxLines: 1
  ),
)

errorText显示在输入框的左下部，默认字体为红色，用法以下：

TextField(
  decoration: InputDecoration(
    errorText: '用户名输入错误',
    errorStyle: TextStyle(fontSize: 12),
    errorMaxLines: 1,
    errorBorder: OutlineInputBorder(borderSide: BorderSide(color: Colors.red)),
  ),
)

prefix系列的组件是输入框前面的部分，用法以下：

TextField(
  decoration: InputDecoration(
    prefixIcon: Icon(Icons.person)
  ),
)

注意prefix和icon的区别，icon是在输入框边框的外部，而prefix在里面。

suffix和prefix相反，suffix在输入框的尾部，用法以下：

TextField(
  decoration: InputDecoration(
      suffixIcon: Icon(Icons.person)
  ),
)

counter组件统计输入框文字的个数，counter仅仅是展现效果，不具有自动统计字数的功能， 自动统计字数代码以下：

var _textFieldValue = '';
TextField(
  onChanged: (value){
    setState(() {
      _textFieldValue = value;
    });
  },
  decoration: InputDecoration(
    counterText: '${_textFieldValue.length}/32'
  ),
)

filled为true时，输入框将会被fillColor填充，仿QQ登陆输入框代码以下：

Container(
  height: 60,
  width: 250,
  child: TextField(
    decoration: InputDecoration(
      fillColor: Color(0x30cccccc),
      filled: true,
      enabledBorder: OutlineInputBorder(
          borderSide: BorderSide(color: Color(0x00FF0000)),
          borderRadius: BorderRadius.all(Radius.circular(100))),
      hintText: 'QQ号/手机号/邮箱',
      focusedBorder: OutlineInputBorder(
          borderSide: BorderSide(color: Color(0x00000000)),
          borderRadius: BorderRadius.all(Radius.circular(100))),
    ),
  ),
)

controller是输入框文本编辑的控制器，能够获取TextField的内容、设置TextField的内容，下面将输入的英文变为大写：

TextEditingController _controller;

@override
void initState() {
  super.initState();
  _controller = TextEditingController()
    ..addListener(() {
      //获取输入框的内容，变为大写
      _controller.text = _controller.text.toUpperCase();

    });
}

@override
Widget build(BuildContext context) {
  return TextField(
    controller: _controller,
  );
}

@override
dispose() {
  super.dispose();
  _controller.dispose();
}

有时输入框后面带有“清除”功能，须要controller来实现。若是须要2个TextField的内容进行同步，只须要给2个TextField设置同一个controller便可实现。

keyboardType参数控制软键盘的类型，说明以下：

  • text：通用键盘。
  • multiline：当TextField为多行时（maxLines设置大于1），右下角的为“换行” 按键。
  • number：数字键盘。
  • phone：手机键盘，比数字键盘多"*"和 "#"。
  • datetime：在ios上和text同样，在android上出现数字键盘、":"和 "-"。
  • emailAddress：邮箱键盘，有"@" 和 "."按键。
  • url：url键盘，有"/" 和 "."按键。
  • visiblePassword：既有字幕又有数字的键盘。

textInputAction参数控制软键盘右下角的按键，说明以下：

  • none：android上显示返回键，ios不支持。
  • unspecified：让操做系统本身决定哪一个合适，通常状况下，android显示“完成”或者“返回”。
  • done：android显示表明“完成”的按钮，ios显示“Done”（中文：完成）。
  • go：android显示表达用户去向目的地的图标，好比向右的箭头，ios显示“Go”（中文：前往）。
  • search：android显示表达搜索的按钮，ios显示"Search"（中文：搜索）。
  • send：android显示表达发送意思的按钮，好比“纸飞机”按钮，ios显示"Send"（中文：发送）。
  • next：android显示表达“前进”的按钮，好比“向右的箭头”,ios显示"Next"（中文：下一项）。
  • previous：android显示表达“后退”的按钮，好比“向左的箭头”,ios不支持。
  • continueAction：android 不支持，ios仅在ios9.0+显示"Continue"（中文：继续）。
  • join：Android和ios显示"Join"（中文：加入）。
  • route：android 不支持，ios显示"Route"（中文：路线）。
  • emergencyCall：android 不支持，ios显示"Emergency Call"（中文：紧急电话）。
  • newline：android显示表达“换行”的按钮，ios显示”换行“。

你们可能发现了，Android上显示的按钮大部分是不肯定的，好比next有的显示向右的箭头，有的显示前进，这是由于各大厂商对Android ROM定制引起的。

textCapitalization参数是配置键盘是大写仍是小写，仅支持键盘模式为text，其余模式下忽略此配置，说明以下：

  • words：每个单词的首字母大写。
  • sentences：每一句话的首字母大写。
  • characters：每一个字母都大写
  • none：都小写

这里仅仅是控制软键盘是大写模式仍是小写模式，你也能够切换大小写，系统并不会改变输入框内的内容。

textAlignVertical表示垂直方向的对齐方式，textDirection表示文本方向，用法以下：

TextField(
  textAlignVertical: TextAlignVertical.center,
  textDirection: TextDirection.rtl,
)

toolbarOptions表示长按时弹出的菜单，有copy、cut、paste、selectAll，用法以下：

TextField(
  toolbarOptions: ToolbarOptions(
    copy: true,
    cut: true,
    paste: true,
    selectAll: true
  ),
)

cursor表示光标，用法以下：

TextField(
  showCursor: true,
  cursorWidth: 3,
  cursorRadius: Radius.circular(10),
  cursorColor: Colors.red,
)

效果以下：

将输入框设置为密码框，只需obscureText属性设置true便可，用法以下：

TextField(
  obscureText: true,
)

经过inputFormatters能够限制用户输入的内容，好比只想让用户输入字符，设置以下：

TextField(
  inputFormatters: [
    WhitelistingTextInputFormatter(RegExp("[a-zA-Z]")),
  ],
)

这时用户是没法输入数字的。

onChanged是当内容发生变化时回调，onSubmitted是点击回车或者点击软键盘上的完成回调，onTap点击输入框时回调，用法以下：

TextField(
  onChanged: (value){
    print('onChanged:$value');
  },
  onEditingComplete: (){
    print('onEditingComplete');
  },
  
  onTap: (){
    print('onTap');
  },
)

输入框右下角常常须要字数统计，除了使用上面介绍的方法外，还可使用buildCounter，建议使用此方法，用法以下：

TextField(
  maxLength: 100,
  buildCounter: (
    BuildContext context, {
    int currentLength,
    int maxLength,
    bool isFocused,
  }) {
    return Text(
      '$currentLength/$maxLength',
    );
  },
)

动态获取焦点

FocusScope.of(context).requestFocus(_focusNode);

_focusNode为TextField的focusNode：

_focusNode = FocusNode();

TextField(
    focusNode: _focusNode,
    ...
)

动态失去焦点

_focusNode.unfocus();

过渡颜色的文字

Builder(
  builder: (BuildContext context) {
    RenderBox box = context.findRenderObject();
    final Shader linearGradient = LinearGradient(
      colors: <Color>[Colors.purple, Colors.blue],
    ).createShader(
        Rect.fromLTWH(0.0, 0.0, box?.size?.width, box?.size?.height));

    return Text(
      '老孟，专一分享Flutter技术和应用实战',
      style: new TextStyle(
          fontSize: 18.0,
          fontWeight: FontWeight.bold,
          foreground: Paint()..shader = linearGradient),
    );
  },
)

Builder组件是为了计算当前Text组件大小，生成LinearGradient。

带先后置标签的文本

RichText(
  text: TextSpan(
      style: DefaultTextStyle.of(context).style,
      children: <InlineSpan>[
        WidgetSpan(
            child: Container(
              margin: EdgeInsets.only(right: 10),
              padding: EdgeInsets.symmetric(horizontal: 10),
              decoration: BoxDecoration(
                  shape: BoxShape.rectangle,
                  borderRadius: BorderRadius.all(Radius.circular(20)),
                  color: Colors.blue),
              child: Text(
                '判断题',
                style: TextStyle(color: Colors.white),
              ),
            )),
        TextSpan(text: '泡沫灭火器可用于带电灭火'),

      ]),
)

“服务协议”

一般在登陆页面的底部会出现登陆即表明赞成并阅读 《服务协议》，其中《服务协议》为蓝色且可点击：

Text.rich(
  TextSpan(
      text: '登陆即表明赞成并阅读',
      style: TextStyle(fontSize: 11, color: Color(0xFF999999)),
      children: [
        TextSpan(
          text: '《服务协议》',
          style: TextStyle(color: Colors.blue, fontWeight: FontWeight.bold),
          recognizer: TapGestureRecognizer()
            ..onTap = () {
              print('onTap');
            },
        ),
      ]),
)

登陆密码输入框

TextField(
  decoration: InputDecoration(
    fillColor: Color(0x30cccccc),
    filled: true,
    enabledBorder: OutlineInputBorder(
        borderSide: BorderSide(color: Color(0x00FF0000)),
        borderRadius: BorderRadius.all(Radius.circular(100))),
    hintText: '输入密码',
    focusedBorder: OutlineInputBorder(
        borderSide: BorderSide(color: Color(0x00000000)),
        borderRadius: BorderRadius.all(Radius.circular(100))),

  ),
  textAlign: TextAlign.center,
  obscureText: true,
  onChanged: (value) {

  },
)

评论回复

Text.rich(
  TextSpan(
      text: '回复',
      style: TextStyle(fontSize: 11, color: Color(0xFF999999)),
      children: [
        TextSpan(
          text: '@老孟：',
          style: TextStyle(color: Colors.blue, fontWeight: FontWeight.bold),
          recognizer: TapGestureRecognizer()
            ..onTap = () {
              print('onTap');
            },
        ),
        TextSpan(
          text: '你好，想知道Flutter发展前景如何？',
        ),
      ]),
)

交流

老孟Flutter博客地址（330个控件用法）：http://laomengit.com

欢迎加入Flutter交流群（微信：laomengit）、关注公众号【老孟Flutter】：
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程