UITextField

UITextField（文本框）

• 父类是UIControl
• UITextField与UILabel的差异：UITextField不仅可以像UILabel一样展示文字，也可以与用户交互，让用户直接编辑文本；但要注意，UITextField无法像UILabel通过富文本实现图文混批，增加图片需要使用leftView设置，并且位置在控件的左边，无法修改位置
• 使用场景：UITextField高度为1行，可以用于输入内容比屏幕宽度少的内容

UITextField常见属性

// 设置文本框文字内容
textField.text = @"文字";

// 设置占位文字内容
textField.placeholder = @"占位文字";

// 修改UITextField的光标颜色
textField.tintColor = [UIColor whiteColor];

//边缘属性（设置为圆形边框）
textField.borderStyle = UITextBorderStyleRoundedRect;

UITextField其他属性

// 设置文本框左面控件
textField.leftView = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 8, 0)];
textField.leftViewMode = UITextFieldViewModeAlways;

监听UITextField的获得焦点和失去焦点事件

• 方案一：addTarget

  // 监听编辑
  UIControlEventEditingDidBegin实现功能：
  1. 开始编辑
  2. 获得焦点
  3. 弹出键盘
  [textField addTarget:target action:@selector(editingDidBegin) forControlEvents:UIControlEventEditingDidBegin];
  
  // 监听结束编辑
  UIControlEventEditingDidEnd实现功能：
  1. 结束编辑
  2. 失去焦点
  3. 退下键盘
  [textField addTarget:target action:@selector(editingDidEnd) forControlEvents:UIControlEventEditingDidEnd];
  

• 方案二： delegate

  textField.delegate = self;
  
  #pragma mark - 
  - (void)textFieldDidBeginEditing:(UITextField *)textField
  {
      // 编辑代码
  }
  
  - (void)textFieldDidEndEditing:(UITextField *)textField
  {
      // 完成编辑代码
  }
  

• 方案三：通知

  // 注册监听器
  [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(beginEditing) name:UITextFieldTextDidBeginEditingNotification object:textField];
  [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(endEditing) name:UITextFieldTextDidEndEditingNotification object:textField];
  
  // 销毁监听器
  - (void)dealloc
  {
      [[NSNotificationCenter defaultCenter] removeObserver:self];
  }
  
  // 监听行为触发时执行的代码
  - (void)beginEditing
  {
      // 编辑代码
  }
  
  - (void)endEditing
  {
      // 完成编辑代码
  }
  

• 方案四：重写UITextField的becomeFirstResponder和resignFirstResponder方法

   // 调用时刻 : 成为第一响应者(开始编辑\弹出键盘\获得焦点)
  - (BOOL)becomeFirstResponder
  {
      // 编辑代码
      return [super becomeFirstResponder];
  }
  
  // 调用时刻 : 不做第一响应者(结束编辑\退出键盘\失去焦点)
  - (BOOL)resignFirstResponder
  {
      // 完成编辑代码
      return [super resignFirstResponder];
  }
  

修改UITextField占位文字的颜色

1. 方案一：使用attributedPlaceholder

// 设置带有属性的占位文字, 优先级 > placeholder
@property(nullable, nonatomic,copy) NSAttributedString *attributedPlaceholder;
objc
//设置占位文字属性
NSMutableDictionary *dict = [NSMutableDictionary dictionary];
dict[NSForegroundColorAttributeName] = [UIColor whiteColor]; // 文字颜色

// 生成富文本
NSAttributedString *str = [[NSAttributedString alloc]initWithString:self.placeholder attributes:dict]；

// 设置textField占位富文本
textField.attributedPlaceholder = str;
```

• 方案二：重写- (void)drawPlaceholderInRect:(CGRect)rect;

  - (void)drawPlaceholderInRect:(CGRect)rect
  {
      // 设置文字属性
      NSMutableDictionary *attrs = [NSMutableDictionary dictionary];
      attrs[NSForegroundColorAttributeName] = [UIColor whiteColor];
      attrs[NSFontAttributeName] = self.font;
  
      // 画出占位文字：
      // 方法一：drawInRect:
      CGRect placeholderRect;
      placeholderRect.size.width = rect.size.width;
      placeholderRect.size.height = self.font.lineHeight;
      placeholderRect.origin.x = 0;
      placeholderRect.origin.y = (rect.size.height - self.font.lineHeight) * 0.5;
      [self.placeholder drawInRect:placeholderRect withAttributes:attrs];
  
      // 方法二：drawAtPoint:
      CGPoint placeholderPoint = CGPointMake(0, (rect.size.height - self.font.lineHeight) * 0.5);
      [self.placeholder drawAtPoint:placeholderPoint withAttributes:attrs];
  }
  

• 方案三：修改内部占位文字Label的文字颜色（推荐）

  // 运行时查看UITextField的属性列表
  // 底层：UITextField有一个子控件"placeholderLabel"专门用于管理占位文本内容，是私有的；
  unsigned int count;
  Ivar *ivarList = class_copyIvarList([UITextField class], &count);
  for (int i = 0; i < count; i++) {
      Ivar ivar = ivarList[i];
      NSLog(@"%s", ivar_getName(ivar));
  }
  free(ivarList);
  
  // placeholderLabel是UILabel的子类
  UILabel *label = [self valueForKeyPath:@"placeholderLabel"];
  label.textColor = [UIColor whiteColor];
  
  // 最终方案:通过KVC可快速设置占位文本的属性
  [textField setValue:[UIColor grayColor] forKeyPath:@"placeholderLabel.textColor"];
  

UITextFieldDelegate协议

1. 文本框点击时调用，表示是否允许编辑，NO表示不允许编辑

   - (BOOL)textFieldShouldBeginEditing:(UITextField *)textField;
   

• 文本框点击时调用，让textField成为第一响应者，开始编辑

  - (void)textFieldDidBeginEditing:(UITextField *)textField;
  

• 文本框编辑时调用，YES允许输入，NO禁止输入。可用if设置那些允许输入，哪些不允许输入。

  • 可用于拦截用户输入

    - (BOOL)textField:(UITextField *)textField shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)string;
    

• 键盘return键点击时调用。YES结束输入(继续输入的内容是独立的），NO则无效果（继续输入的与之前内容是一个整体）

  • 收回键盘重新打开时与return NO一致，所以设置了return YES和收回键盘与return NO和收回键盘效果一致

    - (BOOL)textFieldShouldReturn:(UITextField *)textField{
        if (textField == self.nameField) {
            // 让phoneField成为第一响应者（phoneField会出聚焦）
            [self.phoneField becomeFirstResponder];
        } else if (textField == self.phoneField) {
            [self.addressField becomeFirstResponder];
        } else if (textField == self.addressField) {
            [self.view endEditing:YES];
        }
        return YES;
    }
    

• 是否结束编辑文本框，YES表示结束，NO表示不结束

  - (BOOL)textFieldShouldEndEditing:(UITextField *)textField;
  

• 文本框结束编辑时调用（强迫停止也会调用）。

  - (void)textFieldDidEndEditing:(UITextField *)textField;
  

• 清除按钮点击时调用。NO忽略清除命令

  - (BOOL)textFieldShouldClear:(UITextField *)textField;
  

UITextField与键盘

• 注意：如果一个键盘想要弹出来,必须把textField添加到一个控件上

  //设置键盘(自定义键盘）
  UIView *temp = [[UIView alloc] init];
  temp.frame = CGRectMake(0, 0, 0, 300);
  temp.backgroundColor = [UIColor redColor];
  self.nameField.inputView = temp;
  
      //收回键盘（该方法在tableView中失效）
  - (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
  {
      // 文本框不再是第一响应者，就会退出键盘
  //  [self.textField resignFirstResponder];
  
  //  [self.textField endEditing:YES];
  
      [self.view endEditing:YES];
  }
      // 设置键盘的辅助控件
      //增加按钮
  self.nameField.inputAccessoryView = [UIButton buttonWithType:UIButtonTypeContactAdd];
  
      //开关按钮
  self.phoneField.inputAccessoryView = [[UISwitch alloc] init];
  
      //分段按钮
  self.addressField.inputAccessoryView = [[UISegmentedControl alloc] initWithItems:@[@"1", @"2"]];
  
      //加载toolbar
      XMGToolbar *toolbar = [[[NSBundle mainBundle] loadNibNamed:@"XMGToolbar" owner:nil options:nil] lastObject];
  
      //设置文本框辅助控件
      self.nameField.inputAccessoryView = toolbar;
      self.phoneField.inputAccessoryView = toolbar;
      self.addressField.inputAccessoryView = toolbar;
      ```
  
  

键盘约束管理-控件跟随键盘变化，避免键盘遮挡控件信息

@interface ViewController ()

/** 输入框 */
@property (weak, nonatomic) IBOutlet UITextField *textField;
/** 文本框底部约束 */
@property (weak, nonatomic) IBOutlet NSLayoutConstraint *textConstraintBtm;

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    /** 注册监听器 */
    //接收键盘即将显示通知
    [[NSNotificationCenter defaultCenter]addObserver:self selector:@selector(keyboardWillShow:) name:UIKeyboardWillShowNotification object:nil];
    //接收键盘即将隐藏通知
    [[NSNotificationCenter defaultCenter]addObserver:self selector:@selector(keyboardWillHidden:) name:UIKeyboardWillHideNotification object:nil];

}

/** 注销监听器 */
-(void)dealloc{
    [[NSNotificationCenter defaultCenter]removeObserver:self];
}


/**
 *  监听键盘的即将显示
 */
-(void)keyboardWillShow:(NSNotification*)note{

    /** 设置约束 */
    //获取数据
    CGRect keyboard = [note.userInfo[UIKeyboardFrameBeginUserInfoKey] CGRectValue];

    //跟随键盘出现而升高
    self.textConstraintBtm.constant = keyboard.size.height;

    /** 执行动画 */
    NSTimeInterval duration = [note.userInfo[UIKeyboardAnimationDurationUserInfoKey] doubleValue];
    [UIView animateWithDuration:duration animations:^{
        [self.view layoutIfNeeded];
    }];

}

/**
 *  监听键盘的即将隐藏
 */
-(void)keyboardWillHidden:(NSNotification*)note{

    /** 设置约束 */
    //跟随键盘隐藏而降低（回复原位）
    self.textConstraintBtm.constant = 0;

    /** 执行动画 */
    NSTimeInterval duration = [note.userInfo[UIKeyboardAnimationDurationUserInfoKey] doubleValue];
    [UIView animateWithDuration:duration animations:^{
        [self.view layoutIfNeeded];
    }];
}

//IPhone没有关闭键盘的选项，是通过点击其他地方使键盘收回的
-(void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
{
    /** 关闭键盘 */
    //停止编辑
//    [self.view endEditing:YES];

    //辞去第一反应者
    [self.textField resignFirstResponder];
}

键盘管理第三方框架

• 第三方控件：IQKeyboardManager-master
• 应用举例

  // 键盘管理者
  IQKeyboardManager *mgr = [IQKeyboardManager sharedManager];
  // 当点击键盘以外的区域，会自动退出键盘
  mgr.shouldResignOnTouchOutside = YES;
  
  // 不要在toolbar上面显示占位文字
  mgr.shouldShowTextFieldPlaceholder = NO;
  
  // 关闭toolbar
  // mgr.enableAutoToolbar = NO;
  // toolbar是否要使用文本框的tintColor(光标的颜色)
  mgr.shouldToolbarUsesTextFieldTintColor = YES;
  
  // 管理return key
  self.handler = [[IQKeyboardReturnKeyHandler alloc] initWithViewController:self];
  // 设置最后一个文本框的return key为“完成”
  self.handler.lastTextFieldReturnKeyType = UIReturnKeyDone;