iPhone keyboard, Done button and resignFirstResponder

This is probably a dumb question, but I can't find the answer in the docs. Did the "Done" button on the pop-up keyboard always cause the keyboard to disappear? I see a lot of code around the web like this:

- (BOOL)textFieldShouldReturn:(UITextField *)theTextField {
    [theTextField resignFirstResponder];
    return YES;
}

When I press the "Done" button, the keyboard pops down and the UITextField resigns first responder.

I'm presuming that pressing the "Done" button didn't used to cause a UITextField to resignFirstResponder, but that behavior changed at some time.

I'm debugging on OS 3.0 - 3.1.3

I made a small test project with just a UITextField and this code

#import <UIKit/UIKit.h>
@interface TextFieldTestViewController : UIViewController
<UITextFieldDelegate>
{
	UITextField *textField;
}
@property (nonatomic, retain) IBOutlet UITextField *textField;
@end

#import "TextFieldTestViewController.h"
@implementation TextFieldTestViewController
@synthesize textField;

- (void)viewDidLoad
{
	[self.textField setDelegate:self];
	[self.textField setReturnKeyType:UIReturnKeyDone];
	[self.textField addTarget:self
				  action:@selector(textFieldFinished:)
		forControlEvents:UIControlEventEditingDidEndOnExit];
    [super viewDidLoad];
}
- (IBAction)textFieldFinished:(id)sender
{
	// [sender resignFirstResponder];
}

- (void)dealloc {
    [super dealloc];
}
@end

The text field is an unmodified UITextField dragged onto the NIB, with the outlet connected.
After loading the app, clicking in the text field brings up the keyboard. Pressing the "Done" button makes the text field lose focus and animates out the keyboard. Note that the advice around the web is to always use [sender resignFirstResponder] but this works without it.

In Xcode 5.1

Enable Done Button

• In Attributes Inspector for the UITextField in Storyboard find the field "Return Key" and select "Done"

Hide Keyboard when Done is pressed

• In Storyboard make your ViewController the delegate for the UITextField

• Add this method to your ViewController

   -(BOOL)textFieldShouldReturn:(UITextField *)textField
   {
       [textField resignFirstResponder];
       return YES;
   }
  

From the documentation (any version):

> It is your application’s > responsibility to dismiss the keyboard > at the time of your choosing. You > might dismiss the keyboard in response > to a specific user action, such as the > user tapping a particular button in > your user interface. You might also > configure your text field delegate to > dismiss the keyboard when the user > presses the “return” key on the > keyboard itself. To dismiss the > keyboard, send the > resignFirstResponder message to the > text field that is currently the first > responder. Doing so causes the text > field object to end the current > editing session (with the delegate > object’s consent) and hide the > keyboard.

So, you have to send resignFirstResponder somehow. But there is a possibility that textfield loses focus another way during processing of textFieldShouldReturn: message. This also will cause keyboard to disappear.

One line code for Done button:-

[yourTextField setReturnKeyType:UIReturnKeyDone];

And add action method on valueChanged of TextField and add this line-

[yourTextField resignFirstResponder];

I used this method to change choosing Text Field

- (BOOL)textFieldShouldReturn:(UITextField *)textField {

if ([textField isEqual:self.emailRegisterTextField]) {
    
    [self.usernameRegisterTextField becomeFirstResponder];
    
} else if ([textField isEqual:self.usernameRegisterTextField]) {
    
    [self.passwordRegisterTextField becomeFirstResponder];
    
} else {
    
    [textField resignFirstResponder];
    
    // To click button for registration when you clicking button "Done" on the keyboard
    [self createMyAccount:self.registrationButton];
}

return YES;

}