Flutter中如何仅禁用系统键盘但保留TextFormField可用？

问题拆解与解答 #

1. TextFormField通过RFID获取输入是否必须保持启用状态？

不需要必须保持启用状态，但需要确保组件能接收焦点并捕获文本输入事件。RFID设备本质是模拟系统键盘的输入行为，只要当前有焦点的组件能处理文本输入，就能捕获到RFID的数据——哪怕组件是只读状态，甚至用非输入类组件配合焦点监听也能实现。

2. 无需启用TextFormField的替代方案

如果不想使用启用状态的TextFormField，可以尝试以下两种方案：

• 方案一：展示类组件+全局键盘监听
  用Container或Text展示RFID数据，通过RawKeyboardListener监听全局键盘输入事件，捕获RFID的模拟按键数据并更新展示内容。示例代码：

  class _CheckBalanceState extends State<CheckBalance> {
    String rfidData = "";
    late FocusNode focusNode;
  
    @override
    void initState() {
      super.initState();
      focusNode = FocusNode();
      WidgetsBinding.instance.addPostFrameCallback((_) => focusNode.requestFocus());
    }
  
    @override
    void dispose() {
      focusNode.dispose();
      super.dispose();
    }
  
    @override
    Widget build(BuildContext context) {
      return Scaffold(
        appBar: AppBar(
          backgroundColor: UseColors.textColor,
          title: const Text(
            'Check Balance',
            style: TextStyle(color: UseColors.baseColor),
          ),
          leading: IconButton(
            icon: const Icon(
              Icons.arrow_back_ios_new,
              color: UseColors.baseColor,
            ),
            onPressed: () {
              Navigator.of(context).pop();
            },
          ),
        ),
        body: Padding(
          padding: const EdgeInsets.all(20.0),
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              const Text('RFID Data:', style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold)),
              const SizedBox(height: 10),
              RawKeyboardListener(
                focusNode: focusNode,
                onKey: (RawKeyEvent event) {
                  if (event is RawKeyDownEvent) {
                    final key = event.logicalKey.keyLabel;
                    // 过滤回车等结束键，可根据RFID输出格式调整
                    if (key != 'Enter') {
                      setState(() => rfidData += key);
                    } else {
                      // 处理完整的RFID数据
                      print("完整RFID数据：$rfidData");
                    }
                  }
                },
                child: Container(
                  padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 12),
                  decoration: BoxDecoration(
                    border: Border.all(color: UseColors.textColor),
                    borderRadius: BorderRadius.circular(4),
                  ),
                  child: Text(rfidData.isEmpty ? 'Place RFID here' : rfidData),
                ),
              ),
            ],
          ),
        ),
      );
    }
  }
  

• 方案二：隐藏的只读TextField
  使用一个完全透明的只读TextField来接收焦点和RFID输入，同时用单独的文本组件展示数据，视觉上完全替代TextFormField。

3. 必须启用TextFormField时，禁用系统键盘的方法

如果一定要保留启用状态的TextFormField，以下几种方法可以阻止系统键盘弹出：

• 方法一：设置readOnly + 主动隐藏键盘
  给TextFormField添加readOnly: true，并在焦点获取时主动隐藏键盘：

  TextFormField(
    focusNode: rfidFocusNode,
    controller: rfidController,
    obscureText: true,
    readOnly: true,
    onTap: () {
      // 主动隐藏键盘
      FocusManager.instance.primaryFocus?.unfocus();
      // 重新获取焦点确保能接收RFID输入
      WidgetsBinding.instance.addPostFrameCallback((_) => rfidFocusNode.requestFocus());
    },
    decoration: const InputDecoration(
      border: OutlineInputBorder(),
      enabledBorder: OutlineInputBorder(
          borderSide: BorderSide(color: UseColors.textColor)),
      focusedBorder: OutlineInputBorder(
          borderSide: BorderSide(color: UseColors.textColor)),
      hintText: 'Place RFID here',
      hintStyle: TextStyle(
        fontStyle: FontStyle.normal,
      ),
    ),
  )
  

• 方法二：指定TextInputType.none
  设置keyboardType: TextInputType.none，部分系统会直接不弹出键盘：

  TextFormField(
    focusNode: rfidFocusNode,
    controller: rfidController,
    obscureText: true,
    keyboardType: TextInputType.none,
    decoration: const InputDecoration(
      border: OutlineInputBorder(),
      enabledBorder: OutlineInputBorder(
          borderSide: BorderSide(color: UseColors.textColor)),
      focusedBorder: OutlineInputBorder(
          borderSide: BorderSide(color: UseColors.textColor)),
      hintText: 'Place RFID here',
      hintStyle: TextStyle(
        fontStyle: FontStyle.normal,
      ),
    ),
  )
  

• 方法三：监听焦点变化隐藏键盘
  在初始化FocusNode时添加监听，当获取焦点时立即隐藏键盘：

  import 'package:flutter/services.dart';
  
  @override
  void initState() {
    super.initState();
    rfidController = TextEditingController();
    rfidFocusNode = FocusNode();
    rfidFocusNode.addListener(() {
      if (rfidFocusNode.hasFocus) {
        // 隐藏系统键盘
        SystemChannels.textInput.invokeMethod('TextInput.hide');
      }
    });
    WidgetsBinding.instance.addPostFrameCallback((_) => rfidFocusNode.requestFocus());
  }
  

内容的提问来源于stack exchange，提问作者Muhammad Osama