699

If I tap onto a textinput, I want to be able to tap somewhere else in order to dismiss the keyboard again (not the return key though). I haven't found the slightest piece of information concerning this in all the tutorials and blog posts that I read.

This basic example is still not working for me with react-native 0.4.2 in the Simulator. Couldn't try it on my iPhone yet.

<View style={styles.container}>
  <Text style={styles.welcome}>
    Welcome to React Native!
  </Text>
  <Text style={styles.instructions}>
    To get started, edit index.ios.js
  </Text>
  <Text style={styles.instructions}>
    Press Cmd+R to reload,{'\n'}
    Cmd+D or shake for dev menu
  </Text>
  <TextInput
    style={{height: 40, borderColor: 'gray', borderWidth: 1}}
    onEndEditing={this.clearFocus}
  />
</View>
6

38 Answers 38

897

The problem with keyboard not dismissing gets more severe if you have keyboardType='numeric', as there is no way to dismiss it.

Replacing View with ScrollView is not a correct solution, as if you have multiple textInputs or buttons, tapping on them while the keyboard is up will only dismiss the keyboard.

Correct way is to encapsulate View with TouchableWithoutFeedback and calling Keyboard.dismiss()

EDIT: You can now use ScrollView with keyboardShouldPersistTaps='handled' to only dismiss the keyboard when the tap is not handled by the children (ie. tapping on other textInputs or buttons)

If you have

<View style={{flex: 1}}>
    <TextInput keyboardType='numeric'/>
</View>

Change it to

<ScrollView contentContainerStyle={{flexGrow: 1}}
  keyboardShouldPersistTaps='handled'
>
  <TextInput keyboardType='numeric'/>
</ScrollView>

or

import {Keyboard} from 'react-native'

<TouchableWithoutFeedback onPress={Keyboard.dismiss} accessible={false}>
    <View style={{flex: 1}}>
        <TextInput keyboardType='numeric'/>
    </View>
</TouchableWithoutFeedback>

EDIT: You can also create a Higher Order Component to dismiss the keyboard.

import React from 'react';
import { TouchableWithoutFeedback, Keyboard, View } from 'react-native';

const DismissKeyboardHOC = (Comp) => {
  return ({ children, ...props }) => (
    <TouchableWithoutFeedback onPress={Keyboard.dismiss} accessible={false}>
      <Comp {...props}>
        {children}
      </Comp>
    </TouchableWithoutFeedback>
  );
};
const DismissKeyboardView = DismissKeyboardHOC(View)

Simply use it like this

...
render() {
    <DismissKeyboardView>
        <TextInput keyboardType='numeric'/>
    </DismissKeyboardView>
}

NOTE: the accessible={false} is required to make the input form continue to be accessible through VoiceOver. Visually impaired people will thank you!

20
  • 40
    This is great, the only comment I have is that you could have used the official Keyboard api in RN, and called Keyboard.dismiss() instead of calling some RN internal utility dismissKeyboard(). But both work fine currently. Dec 9, 2016 at 9:04
  • 3
    This works great. I had to change the syntax a little for the definition of the arrow function, to remove an unexpected token error in RN: const DismissKeyboardHOC = (Comp) => {
    – jwinn
    Sep 26, 2017 at 20:47
  • 3
    I can't get onPress for TouchableWithoutFeedback to fire no matter what I try
    – Bradley
    Nov 1, 2017 at 20:30
  • 2
    This solution works, but please keep in mind that you can not use swipe gestures in children of a Touchable component.
    – Hobbyist
    Apr 15, 2018 at 14:34
  • 2
    Why create an HoC and just add this in the root of your app tree / Apr 26, 2020 at 15:52
409

This just got updated and documented! No more hidden tricks.

import { Keyboard } from 'react-native'

// Hide that keyboard!
Keyboard.dismiss()

Github link

6
  • 6
    Thanks for adding this. I hope your answer bubbles up to the top. I almost missed it and used an outdated solution.
    – sheepdog
    Jan 2, 2017 at 3:07
  • 2
    Pinging @MrMuetze to change this as the correct answer
    – jehna1
    Jan 10, 2017 at 13:54
  • 33
    This shouldn't be the selected as the best answer. The question asks how to dismiss the keyboard when tapping outside of it. This answer simply provides an API for doing so, whilst the actual best answer provides a workable implementation.
    – jskidd3
    Nov 6, 2018 at 12:06
  • you can use the next library : KeyboardAwareScrollView Jan 7, 2020 at 13:49
  • @jehna1 this is not the correct answer according to the question
    – Ashad
    Jul 19, 2020 at 9:28
117

Use React Native's Keyboard.dismiss()

Updated Answer

React Native exposed the static dismiss() method on the Keyboard, so the updated method is:

import { Keyboard } from 'react-native'; 

Keyboard.dismiss()

Original Answer

Use React Native's dismissKeyboard Library.

I had a very similar problem and felt like I was the only one that didn't get it.

ScrollViews

If you have a ScrollView, or anything that inherits from it like a ListView, you can add a prop that will automatically dismiss the keyboard based on press or dragging events.

The prop is keyboardDismissMode and can have a value of none, interactive or on-drag. You can read more on that here.

Regular Views

If you have something other than a ScrollView and you'd like any presses to dismiss the keyboard, you can use a simple TouchableWithoutFeedback and have the onPress use React Native's utility library dismissKeyboard to dismiss the keyboard for you.

In your example, you could do something like this:

var DismissKeyboard = require('dismissKeyboard'); // Require React Native's utility library.

// Wrap your view with a TouchableWithoutFeedback component like so.

<View style={styles.container}>

  <TouchableWithoutFeedback onPress={ () => { DismissKeyboard() } }>

    <View>

      <Text style={styles.welcome}>
        Welcome to React Native!
      </Text>

      <Text style={styles.instructions}>
        To get started, edit index.ios.js
      </Text>

      <Text style={styles.instructions}>
        Press Cmd+R to reload,{'\n'}
        Cmd+D or shake for dev menu
      </Text>

      <TextInput style={{height: 40, borderColor: 'gray', borderWidth: 1}} />

    </View>

  </TouchableWithoutFeedback>

</View>

Note: TouchableWithoutFeedback can only have a single child so you need to wrap everything below it in a single View as shown above.

5
  • 5
    React Native exposed the static dismiss() method on the Keyboard, so the updated method is: import { Keyboard } from 'react-native'; Keyboard.dismiss(). Feb 21, 2017 at 19:25
  • 1
    i have a keyboard that is hanging around since i did a reload while focused on an input field. in this case Keyboard.dismiss() does nothing since its implementation is dependent on being focused on an input, which I no longer am.
    – pstanton
    Jun 16, 2018 at 0:36
  • @pstanton What did you have to do to dismiss the keyboard, then? Jun 17, 2018 at 0:44
  • There was no way I could find, so I force closed!
    – pstanton
    Jun 17, 2018 at 22:52
  • What to do if I want to restrict keyboard (don't want to close ) keyboard
    – Anuj
    Aug 20, 2020 at 8:20
106

use this for custom dismissal

var dismissKeyboard = require('dismissKeyboard');

var TestView = React.createClass({
    render: function(){
        return (
            <TouchableWithoutFeedback 
                onPress={dismissKeyboard}>
                <View />
            </TouchableWithoutFeedback>
        )
    }
})
4
49

The simple answer is to use a ScrollView instead of View and set the scrollable property to false (might need to adjust some styling though).

This way, the keyboard gets dismissed the moment I tap somewhere else. This might be an issue with react-native, but tap events only seem to be handled with ScrollViews which leads to the described behaviour.

Edit: Thanks to jllodra. Please note that if you tap directly into another Textinput and then outside, the keyboard still won't hide.

5
  • 1
    It works with scrollview but still there are some cases i'm experiencing where I can click button to change the view using navigator and keyboard still sticks at the bottom and have to manually click return key to close it :( Jun 10, 2015 at 7:45
  • 1
    Keyboard hides when you tap outside the TextInput, but if (instead of tapping outside) you tap into another TextInput, and finally tap outside, the keyboard does not hide. Tested on 0.6.0.
    – jllodra
    Jun 17, 2015 at 19:28
  • I'm seeing different behavior now. Tapping outside the TextInput hides the keyboard, even if I tap directly onto another TextInput--which is a problem because you have to tap twice on another TextInput to be able to type into it! Sigh. (with RN 0.19) Feb 4, 2016 at 22:22
  • 1
    You can set scrollable to true and use keyboardShouldPersistTaps={'handled'} and keyboardDismissMode={'on-drag'} to achieve the same effect Aug 16, 2018 at 22:06
  • only scrollview worked for me I don't know why,the accepted answer when i input a number keyboard dismisses
    – Yvon Huynh
    Apr 15, 2020 at 7:02
40

You can import keyboard from react-native like below:

import { Keyboard } from 'react-native';

and in your code could be something like this:

render() {
    return (
      <TextInput
        onSubmit={Keyboard.dismiss}
      />
    );
  }

static dismiss()

Dismisses the active keyboard and removes focus.

1
  • I did not need static dismiss(). I just added Keyboard.dismiss() to my onSubmit method (where onSubmitEditing={() => {this.onSubmit()}}) Apr 30, 2018 at 7:49
39

I'm brand new to React, and ran into the exact same issue while making a demo app. If you use the onStartShouldSetResponder prop (described here), you can grab touches on a plain old React.View. Curious to hear more experienced React-ers' thoughts on this strategy / if there's a better one, but this is what worked for me:

containerTouched(event) {
  this.refs.textInput.blur();
  return false;
}

render() {
  <View onStartShouldSetResponder={this.containerTouched.bind(this)}>
    <TextInput ref='textInput' />
  </View>
}

2 things to note here. First, as discussed here, there's not yet a way to end editing of all subviews, so we have to refer to the TextInput directly to blur it. Second, the onStartShouldSetResponder is intercepted by other touchable controls on top of it. So clicking on a TouchableHighlight etc (including another TextInput) within the container view will not trigger the event. However, clicking on an Image within the container view will still dismiss the keyboard.

2
  • It definitely works. But as you said, Im curious as well if this is the right way. Hope they solve it soon (github.com/facebook/react-native/issues/113 )
    – mutp
    Aug 22, 2015 at 9:35
  • Great this worked for me. My scroll view was not working with the touchable methods! Thanks! Feb 21, 2018 at 2:10
35

Use ScrollView instead of View and set the keyboardShouldPersistTaps attribute to false.

<ScrollView style={styles.container} keyboardShouldPersistTaps={false}>
    <TextInput
        placeholder="Post Title"
        onChange={(event) => this.updateTitle(event.nativeEvent.text)}
        style={styles.default}/>
 </ScrollView>
4
  • According to the documentation, the keyboardShouldPersistTaps attribute defaults to false when using a ScrollView. I just updated my react-native to the latest version and the problem with switching to a second TextInput still persists. The keyboard then is not dismissible. Have you found a solution for this specific problem?
    – TurboFish
    Jul 20, 2015 at 12:46
  • 1
    The docs were incorrect, but have now been updated, see this PR: github.com/facebook/react-native/issues/2150 Oct 9, 2015 at 16:24
  • What does keyboardShouldPersistTaps do? Why is it relevant here? Thanks Feb 4, 2016 at 22:24
  • 1
    Warning: 'keyboardShouldPersistTaps={false}' is deprecated. Use 'keyboardShouldPersistTaps="never"' instead Apr 4, 2018 at 8:05
26

Wrapping your components in a TouchableWithoutFeedback can cause some weird scroll behavior and other issues. I prefer to wrap my topmost app in a View with the onStartShouldSetResponder property filled in. This will allow me to handle all unhandled touches and then dismiss the keyboard. Importantly, since the handler function returns false the touch event is propagated up like normal.

 handleUnhandledTouches(){
   Keyboard.dismiss
   return false;
 }

 render(){
    <View style={{ flex: 1 }} onStartShouldSetResponder={this.handleUnhandledTouches}>
       <MyApp>
    </View>
  }
2
  • 1
    Thanks for your answer @Scottmas. I ended up using it instead of TouchableWithoutFeedback, because of your "weird scroll behavior and other issues" comment. But if I wasn't blindly trusting your words, can you elaborate on your comment? :)
    – kuhr
    Mar 17, 2020 at 10:53
23

The simplest way to do this

import {Keyboard} from 'react-native'

and then use the function Keyboard.dismiss()

That's all.

Here is a screenshot of my code so you can understand faster.

Import Keyboard from react native. Also import TouchableWithoutFeedback

Now wrap the entire view with TouchableWithoutFeedback and onPress function is keyboard.dismiss()

Here is the example TouchableWithoutFeedback and Keyboard.dismiss()

In this way if user tap on anywhere of the screen excluding textInput field, keyboard will be dismissed.

20

There are a few ways, if you control of event like onPress you can use:

import { Keyboard } from 'react-native'

onClickFunction = () => {
     Keyboard.dismiss()
}

if you want to close the keyboard when the use scrolling:

<ScrollView keyboardDismissMode={'on-drag'}>
     //content
</ScrollView>

More option is when the user clicks outside the keyboard:

<KeyboardAvoidingView behavior='padding' style={{ flex: 1}}>
    //inputs and other content
</KeyboardAvoidingView>
1
  • 1
    Guys, the question is still actual but question is 4 years old(end of 2019 now). RN now is soo simple and easy to use. We have to review all abilities with help of we can achieve solution for this question. Let upvote this comment!
    – Link
    Nov 1, 2019 at 10:56
19

If any one needs a working example of how to dismiss a multiline text input here ya go! Hope this helps some folks out there, the docs do not describe a way to dismiss a multiline input at all, at least there was no specific reference on how to do it. Still a noob to actually posting here on the stack, if anyone thinks this should be a reference to the actual post this snippet was written for let me know.

import React, { Component } from 'react'
import {
  Keyboard,
  TextInput,
  TouchableOpacity,
  View,
  KeyboardAvoidingView,
} from 'react-native'

class App extends Component {
  constructor(props) {
    super(props)
    this.state = {
      behavior: 'position',
    }
    this._keyboardDismiss = this._keyboardDismiss.bind(this)
  }

  componentWillMount() {
    this.keyboardDidHideListener = Keyboard.addListener('keyboardDidHide', this._keyboardDidHide);
  }

  componentWillUnmount() {
    this.keyboardDidHideListener.remove()
  }

  _keyboardDidHide() {
    Keyboard.dismiss()
  }

  render() {
    return (
      <KeyboardAvoidingView
        style={{ flex: 1 }}
        behavior={this.state.behavior}
      >
        <TouchableOpacity onPress={this._keyboardDidHide}>
          <View>
            <TextInput
              style={{
                color: '#000000',
                paddingLeft: 15,
                paddingTop: 10,
                fontSize: 18,
              }}
              multiline={true}
              textStyle={{ fontSize: '20', fontFamily: 'Montserrat-Medium' }}
              placeholder="Share your Success..."
              value={this.state.text}
              underlineColorAndroid="transparent"
              returnKeyType={'default'}
            />
          </View>
        </TouchableOpacity>
      </KeyboardAvoidingView>
    )
  }
}
1
  • What to do if I want to restrict keyboard (don't want to close ) keyboard on an event ?
    – Anuj
    Aug 20, 2020 at 8:21
16

Updated usage of ScrollView for React Native 0.39

<ScrollView scrollEnabled={false} contentContainerStyle={{flex: 1}} />

Although, there is still a problem with two TextInput boxes. eg. A username and password form would now dismiss the keyboard when switching between inputs. Would love to get some suggestions to keep keyboard alive when switching between TextInputs while using a ScrollView.

1
  • 3
    It appears that 0.40 updates keyboardShouldPersistTaps from a boolean to an enum with a possible value of 'handled` which is suppose to fix this.
    – Anshul Kai
    Jan 12, 2017 at 22:32
14
const dismissKeyboard = require('dismissKeyboard');
dismissKeyboard(); //dismisses it

Approach No# 2;

Thanks to user @ricardo-stuven for pointing this out, there is another better way to dismiss the keyboard which you can see in the example in the react native docs.

Simple import Keyboard and call it's method dismiss()

2
14

Using KeyBoard API from react-native does the trick.

import { Keyboard } from 'react-native'

// Hide the keyboard whenever you want using !
Keyboard.dismiss()
12

I just tested this using the latest React Native version (0.4.2), and the keyboard is dismissed when you tap elsewhere.

And FYI: you can set a callback function to be executed when you dismiss the keyboard by assigning it to the "onEndEditing" prop.

1
  • I was debugging the "onEndEditing" callback, but it never triggered before; I'm going to look into this with the newer version of react native, thanks for your suggestion
    – TurboFish
    May 12, 2015 at 21:36
10

If i'm not mistaken the latest version of React Native has solved this issue of being able to dismiss the keyboard by tapping out.

3
  • 4
    Would you be able to point out which part of their code/doc does that? I'm running into the same issue, and I really appreciate it pointing me the direction :) May 7, 2015 at 15:54
  • Confirmed that this is still an issue as of RN 0.19 (the latest). Feb 4, 2016 at 22:54
  • Still an issue with RN 0.28
    – hippofluff
    Aug 19, 2016 at 13:49
10

How about placing a touchable component around/beside the TextInput?

var INPUTREF = 'MyTextInput';

class TestKb extends Component {
    constructor(props) {
        super(props);
    }

    render() {
        return (
            <View style={{ flex: 1, flexDirection: 'column', backgroundColor: 'blue' }}>
                <View>
                    <TextInput ref={'MyTextInput'}
                        style={{
                            height: 40,
                            borderWidth: 1,
                            backgroundColor: 'grey'
                        }} ></TextInput>
                </View>
                <TouchableWithoutFeedback onPress={() => this.refs[INPUTREF].blur()}>
                    <View 
                        style={{ 
                            flex: 1, 
                            flexDirection: 'column', 
                            backgroundColor: 'green' 
                        }} 
                    />
                </TouchableWithoutFeedback>
            </View>
        )
    }
}
10

Wrap your whole component with:

import { TouchableWithoutFeedback, Keyboard } from 'react-native'

<TouchableWithoutFeedback onPress={() => Keyboard.dismiss()}>
...
</TouchableWithoutFeedback>

Worked for me

10

We can use keyboard and tochablewithoutfeedback from react-native

const DismissKeyboard = ({ children }) => (
  <TouchableWithoutFeedback
    onPress={() => Keyboard.dismiss()}
  >
    {children}
  </TouchableWithoutFeedback>
);

And use it in this way:

const App = () => (
  <DismissKeyboard>
    <View style={styles.container}>
      <TextInput
        style={styles.input}
        placeholder="username"
        keyboardType="numeric"
      />
      <TextInput
        style={styles.input}
        placeholder="password"
      />
    </View>
  </DismissKeyboard>
);

I also explained here with source code.

8

Keyboard module is used to control keyboard events.

  • import { Keyboard } from 'react-native'
  • Add below code in render method.

    render() { return <TextInput onSubmitEditing={Keyboard.dismiss} />; }

You can use -

Keyboard.dismiss()

static dismiss() Dismisses the active keyboard and removes focus as per react native documents.

0
7

https://facebook.github.io/react-native/docs/keyboard.html

Use

Keyboard.dismiss(0);

to hide the keyboard.

7

Wrap the View component that is the parent of the TextInput in a Pressable component and then pass Keyboard. dismiss to the onPress prop. So, if the user taps anywhere outside the TextInput field, it will trigger Keyboard. dismiss, resulting in the TextInput field losing focus and the keyboard being hidden.

<Pressable onPress={Keyboard.dismiss}>
  <View>
    <TextInput
      multiline={true}
      onChangeText={onChangeText}
      value={text}
      placeholder={...}
     />
   </View>
</Pressable>
6

Using keyboardShouldPersistTaps in the ScrollView you can pass in "handled", which deals with the issues that people are saying comes with using the ScrollView. This is what the documentation says about using 'handled': the keyboard will not dismiss automatically when the tap was handled by a children, (or captured by an ancestor). Here is where it's referenced.

1
  • This worked for me! (however I had to add it inside my 3rd party library react-native-keyboard-aware-scroll-view). Jan 13, 2018 at 12:20
6

First import Keyboard

import { Keyboard } from 'react-native'

Then inside your TextInput you add Keyboard.dismiss to the onSubmitEditing prop. You should have something that looks like this:

render(){
  return(
    <View>
      <TextInput 
        onSubmitEditing={Keyboard.dismiss}
       />
    </View>
  )  
}
1
6

Use Keyboard.dismiss() to dismiss keyboard at any time.

3

in ScrollView use

keyboardShouldPersistTaps="handled" 

This will do your job.

1
  • What to do if I want to restrict keyboard (don't want to close ) keyboard on an event ?
    – Anuj
    Aug 20, 2020 at 8:21
3

There are many ways you could handle this, the answers above don't include returnType as it was not included in react-native that time.

1: You can solve it by wrapping your components inside ScrollView, by default ScrollView closes the keyboard if we press somewhere. But incase you want to use ScrollView but disable this effect. you can use pointerEvent prop to scrollView pointerEvents = 'none'.

2: If you want to close the keyboard on a button press, You can just use Keyboard from react-native

import { Keyboard } from 'react-native' and inside onPress of that button, you can useKeyboard.dismiss()'.

3: You can also close the keyboard when you click the return key on the keyboard, NOTE: if your keyboard type is numeric, you won't have a return key. So, you can enable it by giving it a prop, returnKeyType to done. or you could use onSubmitEditing={Keyboard.dismiss},It gets called whenever we press the return key. And if you want to dismiss the keyboard when losing focus, you can use onBlur prop, onBlur = {Keyboard.dismiss}

3

2023 answer:

You can add thereturnKeyType prop to the TextInput to specify the text displayed on the return key of the keyboard. Setting it to  "done"  will display a "Done" button, which will dismiss the keyboard when pressed.

 <TextInput
    style={{height: 40, borderColor: 'gray', borderWidth: 1}}
    onEndEditing={this.clearFocus}
    returnKeyType="done"
  />

And it'll show the "done" button like this:

enter image description here

1

Keyboard.dismiss() will do it. But sometimes it may lose the focus and Keyboard will be unable to find the ref. The most consistent way to do is put a ref=_ref to the textInput, and do _ref.blur() when you need to dismiss, and _ref.focus() when you need to bring back the keyboard.

Not the answer you're looking for? Browse other questions tagged or ask your own question.