iOS – 文本字段（Text Field）（长文解析）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
• 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言

在 iOS 开发中，文本字段（Text Field） 是用户与应用程序交互的核心组件之一。无论是登录界面、表单提交，还是搜索功能，开发者都需要通过 UITextField 收集用户输入的信息。对于编程初学者而言，掌握文本字段的使用是构建交互式应用的基础；而中级开发者则需要深入理解其高级功能，如键盘管理、委托机制和样式自定义。本文将从基础概念出发，结合代码示例和实际案例，系统性地讲解 iOS – 文本字段（Text Field） 的核心知识点，并提供可直接复用的解决方案。

一、基础概念：什么是文本字段？

1.1 文本字段与文本视图的区别

在 iOS 开发中，UITextField 和 UITextView 常被混淆。简单来说：

• UITextField：用于单行文本输入，适合短文本（如用户名、密码）。
• UITextView：支持多行文本输入，适合长文本（如评论、说明）。

可以将 UITextField 比喻为餐厅点餐时的条形码扫描器——它专注于接收单一、明确的信息，而 UITextView 则像一张空白的便签纸，允许用户自由书写。

1.2 创建文本字段的两种方式

开发者可以通过 Storyboard 或 代码 创建 UITextField。以下是一个代码示例：

// 在视图控制器中创建文本字段  
let textField = UITextField()  
textField.frame = CGRect(x: 20, y: 100, width: 300, height: 40)  
textField.borderStyle = .roundedRect  
view.addSubview(textField)  

通过设置 borderStyle 属性，可以快速为文本字段添加边框样式，如 roundedRect（默认的矩形边框）或 none（无边框）。

二、核心属性与样式自定义

2.1 常用属性解析

UITextField 提供了丰富的属性，用于控制文本内容、外观和交互行为。以下是一些关键属性的总结：

案例：自定义登录框样式
假设需要创建一个带有圆角边框和占位符的登录文本字段：

let usernameField = UITextField()  
usernameField.placeholder = "用户名"  
usernameField.borderStyle = .roundedRect  
usernameField.layer.cornerRadius = 8 // 添加圆角  
usernameField.backgroundColor = .white  
view.addSubview(usernameField)  

2.2 高级样式技巧

通过 CALayer，可以进一步自定义文本字段的外观：

• 边框颜色与宽度：

  textField.layer.borderColor = UIColor.gray.cgColor  
  textField.layer.borderWidth = 1.0  
  

• 阴影效果：

  textField.layer.shadowOffset = CGSize(width: 2, height: 2)  
  textField.layer.shadowOpacity = 0.3  
  

比喻：这就像为文本字段穿上一件“定制外套”，通过调整颜色、边框和阴影，可以让界面更加美观和专业。

三、委托机制：监听文本输入状态

3.1 UITextFieldDelegate 的作用

UITextField 通过 委托模式 提供事件监听功能。开发者需要让视图控制器遵守 UITextFieldDelegate 协议，并实现相关方法。

class ViewController: UIViewController, UITextFieldDelegate {  
    // ...  
}  

3.2 常用委托方法解析

以下是一些常用的委托方法及其实用场景：

案例：登录界面的键盘跳转
当用户在密码字段输入完成后，自动跳转到登录按钮：

func textFieldShouldReturn(_ textField: UITextField) -> Bool {  
    if textField == passwordField {  
        loginButton.sendActions(for: .touchUpInside) // 模拟点击登录按钮  
        textField.resignFirstResponder() // 隐藏键盘  
    }  
    return true  
}  

四、键盘管理：优化输入体验

4.1 防止键盘遮挡内容

当文本字段位于屏幕底部时，键盘弹出可能导致输入框被遮挡。可以通过 UIScrollView 自动调整内容区域：

// 在视图控制器中添加滚动视图  
let scrollView = UIScrollView()  
view.addSubview(scrollView)  

// 监听键盘显示/隐藏事件  
NotificationCenter.default.addObserver(self, selector: #selector(keyboardWillShow), name: UIResponder.keyboardWillShowNotification, object: nil)  

@objc func keyboardWillShow(notification: Notification) {  
    if let keyboardSize = (notification.userInfo?[UIResponder.keyboardFrameEndUserInfoKey] as? NSValue)?.cgRectValue {  
        scrollView.contentInset.bottom = keyboardSize.height  
    }  
}  

比喻：这就像在下雨时自动升起的天窗，确保用户始终能看到输入内容。

4.2 自定义键盘类型

通过 keyboardType 属性，可以指定文本字段的键盘类型，例如：

• UIKeyboardType.emailAddress：显示带“@”符号的键盘
• UIKeyboardType.numberPad：仅显示数字键盘

phoneField.keyboardType = .numberPad  

五、高级技巧与常见问题

5.1 密码可见性切换

通过添加一个“显示/隐藏密码”按钮，可以动态切换文本字段的 isSecureTextEntry 属性：

@IBAction func togglePasswordVisibility(_ sender: UIButton) {  
    passwordField.isSecureTextEntry.toggle()  
    sender.isSelected = !sender.isSelected // 切换按钮的选中状态  
}  

5.2 实时输入验证

在 shouldChangeCharactersIn 方法中，可以实时校验用户输入。例如，限制手机号格式：

func textField(_ textField: UITextField, shouldChangeCharactersIn range: NSRange, replacementString string: String) -> Bool {  
    let currentText = textField.text ?? ""  
    let newText = (currentText as NSString).replacingCharacters(in: range, with: string)  
    // 使用正则表达式验证手机号  
    let regex = try! NSRegularExpression(pattern: "^\\d{11}$")  
    return regex.firstMatch(in: newText, options: [], range: NSRange(location: 0, length: newText.count)) != nil  
}  

5.3 常见问题与解决方案

• 问题：占位符颜色无法修改？
  解决：通过 defaultTextAttributes 设置属性：

  textField.attributedPlaceholder = NSAttributedString(string: "请输入...", attributes: [.foregroundColor: UIColor.gray])  
  

• 问题：委托方法未触发？
  解决：确保已将 delegate = self 并且视图控制器遵守 UITextFieldDelegate 协议。

结论

iOS – 文本字段（Text Field） 是构建交互式应用的基础组件，其功能远不止于简单的文本输入。通过掌握核心属性、委托机制和键盘管理，开发者可以实现高效、友好的输入体验。本文提供的代码示例和案例（如登录表单、密码可见性切换）均为可直接复用的解决方案。

对于希望进一步提升技能的开发者，建议深入研究 UITextField 的子类化（如自定义绘制边框）和与 UITextView 的结合使用场景。记住，优秀的输入设计不仅能提升用户体验，更是应用程序专业度的直观体现。

（字数：约 1800 字）