当一个 text filed 被选中并接受输入时,被称为获得了“焦点”。通常,用户能够通过点击 text filed 以使其聚焦,开发人员也可以使用本文所描述的方法来聚焦 text filed。

管理焦点是一种直观地创建表单流程的基本方法。例如,假设我们有一个带有 text field 的搜索页面。当用户导航到搜索页面时,我们可以聚焦 text filed 的搜索项。这将允许用户在搜索页面可见时能够立即开始输入,而无需手动点击 text filed!

在本文中,我们将学习如何在 text filed 可见以及点击按钮时聚焦 text filed。

一旦 text filed 可见,就将其聚焦

为了在 text filed 可见时将其聚焦,我们可以使用 autofocus 属性。

  1. TextField(
  2. autofocus: true,
  3. );

有关处理输入和创建 text filed 的更多信息,请参阅 Forms section of the cookbook

点击按钮时聚焦 text filed

我们也可能需要在之后的某个时间点聚焦特定的 text filed,而不是立即聚焦它。在这个例子中,我们将看到在用户按下按钮后如何聚焦 text filed。在实际开发中,您还可能需要聚焦特定的 text filed 以响应 api 调用或错误校验。

步骤

  • 创建一个 FocusNode

  • FocusNode 传递给 TextField

  • 通过点击按钮聚焦 TextField

1. 创建一个 FocusNode

首先,我们需要创建一个 FocusNode。我们将使用 FocusNode 来识别 Flutter 的“focus tree”中的特定的 TextField。这将允许我们能够在接下来的步骤中聚焦 TextField

由于 focus node 是长寿命对象,我们需要使用 State 类来管理生命周期。为此,需要在 State 类的 initState 方法中创建 FocusNode 实例,并在 dispose 方法中清除它们。

  1. // Define a Custom Form Widget
  2. class MyCustomForm extends StatefulWidget {
  3. @override
  4. _MyCustomFormState createState() => _MyCustomFormState();
  5. }
  6. // Define a corresponding State class. This class will hold the data related to
  7. // the form.
  8. class _MyCustomFormState extends State<MyCustomForm> {
  9. // Define the focus node. To manage the lifecycle, create the FocusNode in
  10. // the initState method, and clean it up in the dispose method
  11. FocusNode myFocusNode;
  12. @override
  13. void initState() {
  14. super.initState();
  15. myFocusNode = FocusNode();
  16. }
  17. @override
  18. void dispose() {
  19. // Clean up the focus node when the Form is disposed
  20. myFocusNode.dispose();
  21. super.dispose();
  22. }
  23. @override
  24. Widget build(BuildContext context) {
  25. // We will fill this out in the next step!
  26. }
  27. }

2. 将 FocusNode 传递给 TextField

现在既然已经有了 FocusNode,我们就可以将它传递给 build 方法中特定的 TextField

  1. class _MyCustomFormState extends State<MyCustomForm> {
  2. // Code to create the Focus node...
  3. @override
  4. Widget build(BuildContext context) {
  5. return TextField(
  6. focusNode: myFocusNode,
  7. );
  8. }
  9. }

3. 通过点击按钮聚焦 TextField

最后,当用户点击 floating action button 时,我们将要聚焦 text filed!为此我们将要使用 requestFocus 方法来完成此操作。

  1. FloatingActionButton(
  2. // When the button is pressed, ask Flutter to focus our text field using
  3. // myFocusNode.
  4. onPressed: () => FocusScope.of(context).requestFocus(myFocusNode),
  5. );

一个完整的示例

  1. import 'package:flutter/material.dart';
  2. void main() => runApp(MyApp());
  3. class MyApp extends StatelessWidget {
  4. @override
  5. Widget build(BuildContext context) {
  6. return MaterialApp(
  7. title: 'Text Field Focus',
  8. home: MyCustomForm(),
  9. );
  10. }
  11. }
  12. // Define a Custom Form Widget
  13. class MyCustomForm extends StatefulWidget {
  14. @override
  15. _MyCustomFormState createState() => _MyCustomFormState();
  16. }
  17. // Define a corresponding State class. This class will hold the data related to
  18. // the form.
  19. class _MyCustomFormState extends State<MyCustomForm> {
  20. // Define the focus node. To manage the lifecycle, create the FocusNode in
  21. // the initState method, and clean it up in the dispose method
  22. FocusNode myFocusNode;
  23. @override
  24. void initState() {
  25. super.initState();
  26. myFocusNode = FocusNode();
  27. }
  28. @override
  29. void dispose() {
  30. // Clean up the focus node when the Form is disposed
  31. myFocusNode.dispose();
  32. super.dispose();
  33. }
  34. @override
  35. Widget build(BuildContext context) {
  36. return Scaffold(
  37. appBar: AppBar(
  38. title: Text('Text Field Focus'),
  39. ),
  40. body: Padding(
  41. padding: const EdgeInsets.all(16.0),
  42. child: Column(
  43. children: [
  44. // The first text field will be focused as soon as the app starts
  45. TextField(
  46. autofocus: true,
  47. ),
  48. // The second text field will be focused when a user taps on the
  49. // FloatingActionButton
  50. TextField(
  51. focusNode: myFocusNode,
  52. ),
  53. ],
  54. ),
  55. ),
  56. floatingActionButton: FloatingActionButton(
  57. // When the button is pressed, ask Flutter to focus our text field using
  58. // myFocusNode.
  59. onPressed: () => FocusScope.of(context).requestFocus(myFocusNode),
  60. tooltip: 'Focus Second Text Field',
  61. child: Icon(Icons.edit),
  62. ), // This trailing comma makes auto-formatting nicer for build methods.
  63. );
  64. }
  65. }

Text Field Focus Demo