HXPhotoPicker自定义导航栏标题视图指南

HXPhotoPicker是一款功能强大的iOS照片选择器框架，在使用过程中开发者可能会遇到需要自定义导航栏标题视图的需求。本文将详细介绍如何通过实现PhotoPickerNavigationTitle协议来自定义照片列表的标题样式。

为什么需要自定义标题视图

默认情况下，HXPhotoPicker的导航栏标题视图包含一个显示相册名称的标签和一个指示箭头。但在实际开发中，我们可能需要：

1. 修改字体样式以匹配应用整体设计
2. 调整箭头图标大小
3. 改变标题颜色
4. 添加额外的交互元素

实现自定义标题视图

1. 创建自定义视图类

首先需要创建一个继承自UIView的类，并实现PhotoPickerNavigationTitle协议：

class CustomAlbumTitleView: UIView, PhotoPickerNavigationTitle {
    // 实现协议要求的属性和方法
    var contentWidth: CGFloat = 0
    var selectTitleHandler: ((String, UIView) -> Void)?
    var isSelected: Bool = false
    
    // 添加自定义的UI元素
    private let titleLabel = UILabel()
    private let arrowImageView = UIImageView()
    
    override init(frame: CGRect) {
        super.init(frame: frame)
        setupViews()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    private func setupViews() {
        // 配置标题标签
        titleLabel.font = UIFont.systemFont(ofSize: 18, weight: .medium)
        titleLabel.textColor = .darkText
        titleLabel.textAlignment = .center
        
        // 配置箭头图标
        arrowImageView.image = UIImage(systemName: "chevron.down")
        arrowImageView.tintColor = .darkText
        
        // 添加子视图并设置布局
        addSubview(titleLabel)
        addSubview(arrowImageView)
        
        // 使用AutoLayout或frame布局
        // ...
    }
}

2. 实现协议方法

PhotoPickerNavigationTitle协议要求实现以下关键方法：

// 更新标题内容
func updateTitle(_ title: String?) {
    titleLabel.text = title
    // 计算内容宽度
    let titleWidth = titleLabel.sizeThatFits(CGSize(width: CGFloat.greatestFiniteMagnitude, height: CGFloat.greatestFiniteMagnitude)).width
    let arrowWidth = arrowImageView.image?.size.width ?? 0
    contentWidth = titleWidth + arrowWidth + 8 // 8为间距
}

// 更新选中状态
func updateSelectedStatus(_ isSelected: Bool) {
    self.isSelected = isSelected
    UIView.animate(withDuration: 0.25) {
        self.arrowImageView.transform = isSelected ? CGAffineTransform(rotationAngle: .pi) : .identity
    }
}

3. 配置选择器使用自定义标题

在初始化照片选择器时，设置自定义的标题视图：

let config = HXPhotoPickerConfiguration()
config.navigationTitle = CustomAlbumTitleView()
let picker = HXPhotoPickerController(with: config)

常见问题解决方案

1. 扩展方法报错：确保正确导入了HXPhotoPicker模块，并且实现了所有协议要求的方法。

2. 布局问题：自定义视图需要正确计算contentWidth，这是框架用来确定导航栏标题位置的关键值。

3. 交互问题：如果需要处理标题点击事件，可以在自定义视图中添加手势识别器，并通过selectTitleHandler回调通知框架。

最佳实践建议

1. 保持自定义标题视图的风格与应用整体设计一致
2. 考虑在不同主题模式下(如暗黑模式)的显示效果
3. 测试在不同语言环境下的布局适应性
4. 确保箭头动画流畅自然

通过实现PhotoPickerNavigationTitle协议，开发者可以完全掌控HXPhotoPicker导航栏标题的外观和行为，从而创建出更符合应用设计语言的照片选择体验。