Flutter TextField 文本输入框的基本属性及详解

源码分析：

为白沙黎族等地区用户提供了全套网页设计制作服务，及白沙黎族网站建设行业解决方案。主营业务为做网站、成都网站设计、白沙黎族网站设计，以传统方式定制建设网站，并提供域名空间备案等一条龙服务，秉承以专业、用心的态度为用户提供真诚的服务。我们深信只要达到每一位用户的要求，就会得到认可，从而选择与我们长期合作。这样，我们也可以走得更远！

分析源码可得，TextField 是有状态 StatefulWidget，有丰富的属性，自定义化较高，实践中需要合理利用各种回调；

1、光标的相关属性；cursorColor 为光标颜色，cursorWidth 为光标宽度，cursorRadius 为光标圆角；其中 Radius 提供了 circle 圆角和 elliptical 非圆角两种；

2、textAlign 为文字起始位置，可根据业务光标居左/居右/居中等；注意只是文字开始方向；textDirection 问文字内容方向，从左向右或从右向左；

3、maxLength 为字符长度，设置时默认是展示一行，且右下角有编辑长度与整体长度对比；与 maxLengthEnforced 配合，maxLengthEnforced 为 true 时达到最大字符长度后不可编辑；为 false 时可继续编辑展示有差别；

4、设置 maxLength 之后右下角默认有字符计数器，设置 TextField.noMaxLength 即可只展示输入字符数；

5、maxLines 为允许展现的最大行数，在使用 maxLength 时内容超过一行不会自动换行，因为默认 maxLines=1，此时设置为 null 或固定展示行数即可自动换行；区别在于 null 会展示多行，而 maxLines 最多只展示到设置行数；

6、obscureText 是否隐藏编辑内容，常见的密码格式；

7、enableInteractiveSelection 长按是否出现【剪切/复制/粘贴】菜单；不可为空；

8、keyboardAppearance 为键盘亮度，包括 Brightness.dark/light 两种，但仅限于 iOS 设备；

9、textCapitalization 文字大小写；理论上 sentences 为每句话第一个字母大写；characters为每个字母大写；words 为每个单词首字母大写；但该属性仅限于 text keybord，和尚在本地更换多种方式并未实现，有待研究；

10、keyboardType 为键盘类型，和尚理解整体分为数字键盘和字母键盘等；根据设置的键盘类型，键盘会有差别；

a. 数字键盘

--1-- datetime 键盘上可随时访问 : 和 /；

--2-- phone 键盘上可随时访问 # 和 *；

--3-- number 键盘上可随时访问 + - * /

b. 字母键盘

--1-- emailAddress 键盘上可随时访问 @ 和 .；

--2-- url 键盘上可随时访问 / 和 .；

--3-- multiline 适用于多行文本换行；

--4-- text 默认字母键盘；

11、textInputAction 通常为键盘右下角操作类型，类型众多，建议多多尝试；

12、autofocus 是否自动获取焦点，进入页面优先获取焦点，并弹出键盘，若页面中有多个 TextField 设置 autofocus 为 true 则优先获取第一个焦点；

13、focusNode 手动获取焦点，可配合键盘输入等减少用户操作次数，直接获取下一个 TextField 焦点；

14、enabled 设为 false 之后 TextField 为不可编辑状态；

15、decoration 为边框修饰，可以借此来调整 TextField 展示效果；可以设置前置图标，后置图片，边框属性，内容属性等，会在后续集中尝试；若要完全删除装饰，将 decoration 设置为空即可；

16、inputFormatters 为格式验证，例如原生 Android 中通常会限制输入手机号或其他特殊字符，在 Flutter 中也可以借此来进行格式限制，包括正则表达式；使用时需要引入 package:flutter/services.dart；

a. LengthLimitingTextInputFormatter 限制最长字符；

b. WhitelistingTextInputFormatter 仅允许输入白名单中字符；如 digitsOnly 仅支持数字 [0-9]；

c. BlacklistingTextInputFormatter 防止输入黑名单中字符；如 singleLineFormatter 强制输入单行；

分析源码 RegExp("[/]") 可以设置正则表达式；

17、onChanged 文本内容变更时回调，可实时监听 TextField 输入内容；

18、controller 文本控制器，监听输入内容回调；

19、onTap 点击 TextField时回调；

20、onEditingComplete 在提交内容时回调，通常是点击回车按键时回调；

21、onSubmit 在提交时回调，不可与 onEditingComplete 同时使用，区别在于 onSubmit 是带返回值的回调；

问题小结：

当 TextField 设置 enableInteractiveSelection 属性后长按会出现菜单，默认为英文，可通过设置 Flutter 国际化来处理；

（1）在 pubspec.yaml 中集成 flutter_localizations；

2）在 MaterialApp 中设置本地化代理和支持的语言类型；

（1）将 maxLength 设置为 null 仅使用 LengthLimitingTextInputFormatter 限制最长字符；

（2）设置 InputDecoration 中 decoration 属性为空；但是底部有空余，只是隐藏而并非消失；

3、Flutter中ThemeData与AppBar

本次主要是记录Fultter Theme主题的设备与AppBar中的一些属性的使用及说明。目前项目开发有了四个界面。前期主题没太注意，今天看来要好好总结一下近期所学。

首先，Android主题沉浸式设置，Flutter篇：

根据字面意思就能看出来是对状态懒得设置，其中用到了 dart:io 与 flutter/services.dart 这两个重点Mark一下，有时间深入探究一下用法跟能力。回归正题。

主题数据，其中最常用的是 primarySwatch 、 primaryColor 、 accentColor 。

primarySwatch:UI右下角的FloatingActionButton的颜色就是默认取值MaterialColor，

默认是蓝色的，如果修改成primarySwatch，就会变成这个颜色值。只支持MaterialColor。

primaryColor：顶部导航栏和状态栏的颜色修改，需要用到这个属性，类型 Color。

accentColor：前景色（文本、按钮、覆盖边缘效果等)。

看一下项目中的使用

其中 brightness 主题设置较为关键，它是设置状态栏图标与字体颜色的。

brightness: Brightness.dark 状态栏图标与字体颜色为白色。

brightness: Brightness.light 状态栏图标与字体颜色为黑色。

iconTheme ：设置appbar icon的颜色，appbar中icon的颜色会根据primaryColor的改变来确定自身的颜色，这里可以在iconTheme中指定icon的颜色。

默认不做修改前：

英语小短诗3篇，不要关于恋爱的！！！快啊！！！

这些诗歌很简单又美好：

夏天的飞鸟，飞到我的窗前唱歌，又飞去了。

秋天的黄叶，它们没有什么可唱，只叹息一声，飞落在那里。

Stray

birds

of

summer

come

to

my

window

to

sing

and

fly

away.

And

yellow

leaves

of

autumn,

which

have

no

songs,

flutter

and

fall

there

with

a

sign.

[泰戈尔飞鸟集]

“海水呀，你说的是什么？”

　“是永恒的疑问。”　

　“天空呀，你回答的话是什么？”

“是永恒的沉默。”　

What

language

is

thine,

O

sea?

The

language

of

eternal

question.

What

language

is

thy

answer,

O

sky?

The

language

of

eternal

silence.

[泰戈尔]

在这个黄昏的朦胧里，好些东西看来都仿佛是幻象一般－－尖塔

的底层在黑暗里消失了，树顶象是墨水的模糊的斑点似的。我将等待着黎明，而

当我醒来的时候，就会看到在光明里的您的城市。

Things

look

phantastic

in

this

dimness

of

the

dusk---the

spires

whose

bases

are

lost

in

the

dark

and

tree

tops

like

blots

of

ink.

I

shall

wait

for

the

morning

and

wake

up

to

see

thy

city

in

the

light.

当前文章：关于flutterdark的信息
网站地址：http://myzitong.com/article/dsdjope.html