一、UILabel基础认知

UILabel是UIKit框架中用于显示单行或多行不可编辑文本的基础控件，广泛应用于界面标题、提示信息、数据展示等场景。其核心功能包括文本内容设置、样式定制、布局控制等，支持通过代码或Interface Builder进行配置。

1.1 创建与初始化

UILabel的创建方式分为代码创建和Storyboard/XIB拖拽两种：

// 代码创建示例
let label = UILabel(frame: CGRect(x: 20, y: 100, width: 200, height: 30))
label.text = "Hello World"
view.addSubview(label)

通过init(frame:)初始化时需指定位置和尺寸，而使用Auto Layout时更推荐通过UILabel()初始化后添加约束。

1.2 核心属性体系

UILabel的属性可分为文本内容、样式、布局三大类，每个类别包含多个可配置参数，共同决定最终显示效果。

二、文本内容控制

2.1 基础文本设置

text属性是UILabel最常用的属性，用于设置显示的字符串内容：

label.text = "动态文本内容"

当需要显示包含特殊字符的文本时，可直接赋值包含换行符\n的字符串实现多行效果：

label.text = "第一行\n第二行"

2.2 占位符与空状态处理

虽然UILabel没有原生占位符属性，但可通过以下方式模拟：

// 自定义占位符实现
extension UILabel {
    var placeholderText: String? {
        get { nil }
        set {
            text = newValue ?? text
            textColor = newValue != nil ? .lightGray : .label
        }
    }
}

2.3 动态文本更新

在需要频繁更新文本的场景（如网络请求结果展示），建议：

1. 使用DispatchQueue.main.async确保UI更新在主线程
2. 结合UIView.transition实现平滑过渡效果

   DispatchQueue.main.async {
    UIView.transition(with: label, duration: 0.3, options: .transitionCrossDissolve) {
        label.text = "新内容"
    }
   }

三、文本样式定制

3.1 字体系统

font属性支持UIFont系统字体和自定义字体：

// 系统字体
label.font = .systemFont(ofSize: 16, weight: .semibold)
// 自定义字体（需先导入字体文件）
if let customFont = UIFont(name: "PingFangSC-Medium", size: 18) {
    label.font = customFont
}

动态字体适配可通过UIFontMetrics实现：

let scaledFont = UIFontMetrics(forTextStyle: .headline).scaledFont(for: customFont)

3.2 颜色体系

文本颜色通过textColor设置，支持任意UIColor：

label.textColor = .systemBlue
// 或使用RGB值
label.textColor = UIColor(red: 0.2, green: 0.6, blue: 0.8, alpha: 1)

背景色通过backgroundColor设置，注意与文本颜色的对比度需符合WCAG 2.1标准。

3.3 对齐与换行

文本对齐方式通过textAlignment控制：

label.textAlignment = .center // 左对齐.left | 右对齐.right | 自然对齐.natural

换行模式由numberOfLines和lineBreakMode共同决定：

label.numberOfLines = 0 // 0表示不限制行数
label.lineBreakMode = .byWordWrapping // 按单词换行

其他换行模式包括.byCharWrapping（按字符）、.byClipping（直接截断）等。

四、布局与尺寸控制

4.1 自动尺寸计算

通过sizeToFit()方法可使label根据内容自动调整尺寸：

label.sizeToFit() // 调用后frame会自动调整

更精确的控制可使用boundingRect方法：

let text = "待计算文本"
let size = CGSize(width: 200, height: .infinity)
let rect = (text as NSString).boundingRect(
    with: size,
    options: [.usesLineFragmentOrigin, .usesFontLeading],
    attributes: [.font: label.font!],
    context: nil
)

4.2 约束布局实践

使用Auto Layout时，建议设置以下约束：

label.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
    label.topAnchor.constraint(equalTo: view.topAnchor, constant: 20),
    label.leadingAnchor.constraint(equalTo: view.leadingAnchor, constant: 20),
    label.trailingAnchor.constraint(equalTo: view.trailingAnchor, constant: -20)
])

对于多行label，通常需要同时约束高度或设置numberOfLines = 0。

4.3 边缘控制

通过contentInset属性（iOS 15+）或自定义UIEdgeInsets实现内边距：

if #available(iOS 15.0, *) {
    label.setContentHuggingPriority(.required, for: .horizontal)
    label.directionalLayoutMargins = NSDirectionalEdgeInsets(top: 8, leading: 16, bottom: 8, trailing: 16)
}

五、高级功能实现

5.1 属性字符串

使用NSAttributedString实现富文本效果：

let attributedText = NSMutableAttributedString(string: "混合样式文本")
attributedText.addAttribute(.font, value: UIFont.boldSystemFont(ofSize: 18), range: NSRange(location: 0, length: 2))
attributedText.addAttribute(.foregroundColor, value: UIColor.red, range: NSRange(location: 3, length: 2))
label.attributedText = attributedText

5.2 动态类型适配

启用动态类型需设置：

label.font = .preferredFont(forTextStyle: .body)
label.adjustsFontForContentSizeCategory = true

并在Info.plist中添加UIContentSizeCategory相关配置。

5.3 性能优化建议

1. 避免在滚动视图中频繁创建/销毁label
2. 对于静态文本，考虑使用CATextLayer替代
3. 复杂布局时预先计算文本尺寸
4. 使用UITableView.prefetchDataSource预加载文本

六、常见问题解决方案

6.1 文本截断处理

当文本超出显示范围时，可通过以下方式处理：

label.lineBreakMode = .byTruncatingTail // 末尾显示...
// 或增加点击展开功能
let tap = UITapGestureRecognizer(target: self, action: #selector(expandLabel))
label.isUserInteractionEnabled = true
label.addGestureRecognizer(tap)

6.2 多语言适配

处理不同语言的文本显示时需注意：

1. 阿拉伯语等从右向左语言需设置semanticContentAttribute
2. 计算文本尺寸时使用NSStringDrawingOptions.usesLineFragmentOrigin
3. 避免硬编码宽度限制

6.3 暗黑模式支持

通过UIColor.label和UIColor.secondaryLabel自动适配：

label.textColor = .label // 自动适应明暗模式

或在Asset Catalog中配置不同模式的颜色变体。

七、最佳实践总结

1. 样式集中管理：将字体、颜色等样式定义在扩展或配置文件中
2. 布局解耦：使用Auto Layout时避免固定frame值
3. 性能监控：对频繁更新的label使用instruments检测布局性能
4. 可访问性：确保文本与背景色对比度≥4.5:1
5. 国际化：所有文本内容应通过本地化字符串文件管理

通过系统掌握UILabel的各项属性及其组合应用，开发者能够高效实现从简单提示到复杂富文本的各种显示需求，同时保证界面的美观性和可维护性。在实际开发中，建议结合SwiftUI的Text组件特性进行对比学习，深化对文本显示原理的理解。