React Native TextInput同时显示换行与完成按钮的技术问询

React Native 系统键盘本身没有内置同时显示换行和完成按钮的配置，要实现这个需求，最优雅的方式是利用原生支持的inputAccessoryViewID属性给TextInput绑定自定义工具栏，既保留换行功能，又能通过顶部按钮收起键盘。

核心实现方案 #

通过给TextInput设置inputAccessoryViewID，关联一个自定义的工具栏组件，这个工具栏会自动附着在键盘顶部，和系统数字键盘的顶部按钮体验一致。

完整代码示例 #

import React, { useRef } from 'react';
import { View, TextInput, TouchableOpacity, Text, Keyboard, StyleSheet, Platform } from 'react-native';

const MultiLineInputWithDone = () => {
  const inputRef = useRef(null);

  const handleDone = () => {
    Keyboard.dismiss();
    inputRef.current?.blur();
  };

  return (
    <View style={styles.container}>
      <TextInput
        ref={inputRef}
        style={styles.input}
        multiline
        returnKeyType="default" // 多行模式下显示换行按钮
        inputAccessoryViewID="input-toolbar"
        placeholder="请输入内容..."
        textAlignVertical="top" // Android 下让输入内容从顶部开始
      />
      
      {/* 绑定到TextInput的自定义工具栏 */}
      <View 
        style={[styles.toolbar, Platform.OS === 'android' && styles.androidToolbar]} 
        id="input-toolbar"
      >
        <TouchableOpacity onPress={handleDone} style={styles.doneBtn}>
          <Text style={styles.doneBtnText}>完成</Text>
        </TouchableOpacity>
      </View>
    </View>
  );
};

const styles = StyleSheet.create({
  container: {
    flex: 1,
    padding: 20,
    justifyContent: 'center',
  },
  input: {
    height: 160,
    borderWidth: 1,
    borderColor: '#e0e0e0',
    borderRadius: 8,
    padding: 12,
    fontSize: 16,
  },
  toolbar: {
    flexDirection: 'row',
    justifyContent: 'flex-end',
    paddingHorizontal: 16,
    paddingVertical: 8,
    backgroundColor: '#f8f8f8',
    borderTopWidth: 1,
    borderTopColor: '#e0e0e0',
  },
  androidToolbar: {
    // Android 下调整样式适配系统键盘
    elevation: 2,
  },
  doneBtn: {
    paddingHorizontal: 12,
    paddingVertical: 6,
  },
  doneBtnText: {
    color: '#0066cc',
    fontSize: 16,
    fontWeight: '500',
  },
});

export default MultiLineInputWithDone;

关键细节说明 #

• multiline：必须开启，否则TextInput无法换行，returnKeyType="default"在单行模式下是返回按钮，多行模式下才会显示换行按钮。
• inputAccessoryViewID：将自定义工具栏与TextInput绑定，键盘弹出时工具栏自动显示在顶部，无需手动处理键盘高度变化。
• 完成按钮逻辑：调用Keyboard.dismiss()收起键盘，同时让输入框失去焦点，避免后续误触发输入。
• 跨平台适配：通过Platform API调整Android下的工具栏样式，解决系统差异问题。

这个方案不需要依赖第三方库，完全基于React Native原生API实现，布局稳定且体验流畅，是目前最优雅的解决方式。

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