跨平台开发 / 系统课时
用 TextField 接收文本输入
用 TextField 接收文本输入
本节解决 Flutter 应用中接收用户文字输入的问题。你将学习如何使用 TextField 创建输入框,通过 controller 获取内容,并使用 keyboardType 与 decoration 调整输入体验。
学习目标
- 理解 TextField 的核心属性和输入流程。
- 掌握 TextEditingController 的创建、读取和释放方式。
- 能够构建满足基本业务需求的文本输入区域。
认识 TextField 的输入模型
TextField 是 Flutter 中最常用的文本输入组件。它负责绘制输入区域、接收键盘事件,并通过内部状态维护当前文本内容。
实际开发中通常不会直接读取 TextField 内部状态,而是通过 TextEditingController 管理文本。这种方式便于初始化默认值、读取用户输入以及在提交后清空内容。
使用 controller 获取输入内容
创建 controller 后,需要将它绑定到 TextField 的 controller 属性。用户输入的内容会同步保存到 controller 的 text 字段中。
下面示例实现一个简单的姓名输入页面:
dart
import 'package:flutter/material.dart';
void main() {
runApp(const MaterialApp(home: InputPage()));
}
class InputPage extends StatefulWidget {
const InputPage({super.key});
@override
State<InputPage> createState() => _InputPageState();
}
class _InputPageState extends State<InputPage> {
final TextEditingController _nameController = TextEditingController();
void _submit() {
final name = _nameController.text.trim();
print('输入内容: $name');
}
@override
void dispose() {
// controller 持有资源,需要在页面销毁时释放
_nameController.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Scaffold(
body: Padding(
padding: const EdgeInsets.all(16),
child: Column(
children: [
TextField(
controller: _nameController,
decoration: const InputDecoration(
labelText: '姓名',
hintText: '请输入姓名',
),
),
ElevatedButton(
onPressed: _submit,
child: const Text('提交'),
),
],
),
),
);
}
}预期输出
text
用户输入 Flutter 后点击提交
控制台输出:
输入内容: Flutter配置键盘类型和输入装饰
TextField 默认提供普通文本键盘,但不同业务需要不同输入方式。例如手机号、邮箱、数字输入都应该选择对应的键盘类型。
常用配置如下:
| 属性 | 作用 | 示例 |
|---|---|---|
| keyboardType | 控制系统键盘类型 | TextInputType.phone |
| obscureText | 隐藏输入内容 | 密码输入 |
| decoration | 设置边框、提示文字等外观 | InputDecoration |
例如手机号输入框可以这样配置:
dart
TextField(
keyboardType: TextInputType.phone,
decoration: const InputDecoration(
labelText: '手机号',
border: OutlineInputBorder(),
),
)这种配置不会改变数据处理逻辑,但可以降低用户输入错误的概率。
处理输入边界问题
TextField 只负责收集输入,不会自动完成业务校验。例如注册页面需要判断手机号格式、密码长度或输入是否为空,这些逻辑应该在提交事件中处理。
常见错误包括忘记释放 controller、在 StatelessWidget 中保存需要变化的输入状态,以及把复杂校验逻辑直接写在输入组件内部。
当输入框只用于展示和简单输入时,可以使用 onChanged 获取变化事件;当页面需要反复读取、修改输入内容时,优先选择 TextEditingController。
按自己的节奏,确认真正理解。