跨平台开发 / 系统课时

用 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。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 TextField 接收文本输入

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通