如何通过React Native识别Android设备是否禁用软键盘？

React Native本身没有提供直接检测Android软键盘是否被禁用的API，不过可以通过原生模块扩展或间接行为判断两种方式实现需求：

一、原生Android模块扩展（最准确） #

通过编写原生Android代码，调用系统API直接检测软键盘状态，然后暴露给RN调用：

1. 编写原生模块 #

创建SoftKeyboardCheckerModule.java：

package com.yourappname;

import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.bridge.ReactContextBaseJavaModule;
import com.facebook.react.bridge.ReactMethod;
import com.facebook.react.bridge.Promise;
import android.view.inputmethod.InputMethodManager;
import android.content.Context;

public class SoftKeyboardCheckerModule extends ReactContextBaseJavaModule {
    private ReactApplicationContext reactContext;

    public SoftKeyboardCheckerModule(ReactApplicationContext reactContext) {
        super(reactContext);
        this.reactContext = reactContext;
    }

    @Override
    public String getName() {
        return "SoftKeyboardChecker";
    }

    // 检测软键盘是否被禁用（基于系统可用输入法列表）
    @ReactMethod
    public void isSoftKeyboardDisabled(Promise promise) {
        InputMethodManager imm = (InputMethodManager) reactContext.getSystemService(Context.INPUT_METHOD_SERVICE);
        // 可用输入法列表为空则判定为软键盘被禁用
        boolean isDisabled = imm.getEnabledInputMethodList().isEmpty();
        promise.resolve(isDisabled);
    }
}

2. 注册模块 #

创建SoftKeyboardCheckerPackage.java：

package com.yourappname;

import com.facebook.react.ReactPackage;
import com.facebook.react.bridge.NativeModule;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.uimanager.ViewManager;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

public class SoftKeyboardCheckerPackage implements ReactPackage {
    @Override
    public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
        List<NativeModule> modules = new ArrayList<>();
        modules.add(new SoftKeyboardCheckerModule(reactContext));
        return modules;
    }

    @Override
    public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
        return Collections.emptyList();
    }
}

3. 在RN中调用 #

import { NativeModules } from 'react-native';
const { SoftKeyboardChecker } = NativeModules;

// 检测软键盘状态
const checkKeyboardStatus = async () => {
  try {
    const isDisabled = await SoftKeyboardChecker.isSoftKeyboardDisabled();
    console.log('软键盘是否被禁用:', isDisabled);
  } catch (error) {
    console.error('检测失败:', error);
  }
};

二、间接行为判断（无原生开发成本） #

当软键盘被系统禁用时，点击输入框不会触发键盘弹出。可以通过监听输入框焦点+键盘弹出事件，间接判断：

import { Keyboard, TextInput, View, Text } from 'react-native';
import { useState, useEffect } from 'react';

const KeyboardDisabledDetector = () => {
  const [isKeyboardDisabled, setIsKeyboardDisabled] = useState(false);
  let keyboardTimeout;

  useEffect(() => {
    // 监听键盘弹出事件，取消禁用判定
    const showListener = Keyboard.addListener('keyboardDidShow', () => {
      clearTimeout(keyboardTimeout);
      setIsKeyboardDisabled(false);
    });

    return () => {
      showListener.remove();
      clearTimeout(keyboardTimeout);
    };
  }, []);

  // 输入框获焦后启动超时检测
  const handleFocus = () => {
    // 超时时间可根据设备性能调整
    keyboardTimeout = setTimeout(() => {
      setIsKeyboardDisabled(true);
    }, 600);
  };

  return (
    <View style={{ padding: 20 }}>
      <TextInput
        onFocus={handleFocus}
        placeholder="点击输入框测试"
        style={{ borderWidth: 1, padding: 10 }}
      />
      {isKeyboardDisabled && <Text style={{ marginTop: 10, color: 'red' }}>软键盘已被禁用</Text>}
    </View>
  );
};

注意事项 #

• 间接判断法存在误差：如果设备性能较差，键盘弹出延迟超过设置的超时时间，会出现误判。
• 原生模块法无需额外权限：上述核心检测逻辑基于InputMethodManager的可用输入法列表，不需要系统级权限，普通应用即可使用。

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