本页面介绍如何在Flutter应用程序中输入文本
TextField
是最常用的文本输入widget.
默认情况下,TextField
有一个下划线装饰(decoration)。您可以通过提供给decoration
属性设置一个InputDecoration
来添加一个标签、一个图标、提示文字和错误文本。
要完全删除装饰(包括下划线和为标签保留的空间),将decoration明确设置为空即可。
TextFormField
包裹一个TextField
并将其集成在Form
中。你要提供一个验证函数来检查用户的输入是否满足一定的约束(例如,一个电话号码)或当你想将TextField
与其他FormField
集成时,使用TextFormField
。
有两种获取用户输入的主要方法::
onChanged
回调TextEditingController
.每当用户输入时,TextField会调用它的onChanged
回调。
您可以处理此回调以查看用户输入的内容。例如,如果您正在输入搜索字段,则可能需要在用户输入时更新搜索结果。
一个更强大(但更精细)的方法是提供一个TextEditingController
作为TextField
的controller
属性。
在用户输入时,controller的text
和selection
属性不断的更新。要在这些属性更改时得到通知,请使用controller的addListener
方法监听控制器 。
(如果你添加了一个监听器,记得在你的State对象的dispose方法中删除监听器 )。
该TextEditingController
还可以让您控制TextField
的内容。如果修改controller的text
或selection
的属性,TextField
将更新,以显示修改后的文本或选中区间。
例如,您可以使用此功能来实现推荐内容的自动补全。
以下是使用一个TextEditingController
读取TextField中用户输入的值的示例:
/// Opens an [AlertDialog] showing what the user typed.
class ExampleWidget extends StatefulWidget {
ExampleWidget({Key key}) : super(key: key);
@override
_ExampleWidgetState createState() => new _ExampleWidgetState();
}
/// State for [ExampleWidget] widgets.
class _ExampleWidgetState extends State<ExampleWidget> {
final TextEditingController _controller = new TextEditingController();
@override
Widget build(BuildContext context) {
return new Column(
mainAxisAlignment: MainAxisAlignment.center,
children: <Widget>[
new TextField(
controller: _controller,
decoration: new InputDecoration(
hintText: 'Type something',
),
),
new RaisedButton(
onPressed: () {
showDialog(
context: context,
child: new AlertDialog(
title: new Text('What you typed'),
content: new Text(_controller.text),
),
);
},
child: new Text('DONE'),
),
],
);
}
}