iOS 16自定义返回按钮图标错位：兼容iOS15的修复方案问询

问题分析 #

iOS 16中UINavigationBar的自定义返回按钮图标会被推至容器底部，文本位置正常但图标偏移，而iOS 15布局无异常，核心原因是iOS 16对导航栏按钮的布局约束逻辑做了调整。

兼容修复方法 #

方法1：针对iOS 16单独调整图标内边距（推荐） #

通过版本判断设置不同内边距，不影响iOS 15原有布局：

let backButton = UIBarButtonItem(
    image: UIImage(named: "custom-back-icon"),
    style: .plain,
    target: self,
    action: #selector(backAction)
)

if #available(iOS 16.0, *) {
    // iOS 16下调整图标顶部内边距，抵消底部偏移
    backButton.imageInsets = UIEdgeInsets(top: -4, left: 0, bottom: 4, right: 0)
} else {
    // iOS 15及之前保持原有内边距
    backButton.imageInsets = UIEdgeInsets(top: 0, left: 0, bottom: 0, right: 0)
}

navigationItem.leftBarButtonItem = backButton

注：内边距数值可根据实际图标大小微调，确保跨版本对齐一致。

方法2：自定义UIView统一管理按钮元素 #

通过自定义View封装图标和文本，绕过系统导航栏的布局差异：

class CustomBackButtonView: UIView {
    private let iconImageView = UIImageView(image: UIImage(named: "custom-back-icon"))
    private let titleLabel = UILabel(text: "返回", font: UIFont.systemFont(ofSize: 17))
    
    override init(frame: CGRect) {
        super.init(frame: frame)
        setupLayout()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    private func setupLayout() {
        addSubview(iconImageView)
        addSubview(titleLabel)
        
        iconImageView.translatesAutoresizingMaskIntoConstraints = false
        titleLabel.translatesAutoresizingMaskIntoConstraints = false
        
        // 强制图标和文本垂直居中对齐
        NSLayoutConstraint.activate([
            iconImageView.centerYAnchor.constraint(equalTo: self.centerYAnchor),
            titleLabel.centerYAnchor.constraint(equalTo: self.centerYAnchor),
            iconImageView.trailingAnchor.constraint(equalTo: titleLabel.leadingAnchor, constant: -8),
            iconImageView.widthAnchor.constraint(equalToConstant: 24),
            iconImageView.heightAnchor.constraint(equalToConstant: 24)
        ])
    }
}

// 使用自定义View创建返回按钮
let customBackView = CustomBackButtonView()
let backButton = UIBarButtonItem(customView: customBackView)
backButton.customView?.addGestureRecognizer(UITapGestureRecognizer(target: self, action: #selector(backAction)))
navigationItem.leftBarButtonItem = backButton

这种方式完全脱离系统导航栏按钮的布局逻辑，跨版本表现一致，但需自行处理点击事件和样式适配。

方法3：调整系统按钮约束优先级 #

iOS 16中系统对按钮图标的底部约束优先级更高，可通过代码调整约束优先级：

if #available(iOS 16.0, *) {
    navigationItem.leftBarButtonItem?.customView?.subviews.forEach { subview in
        if let imageView = subview as? UIImageView {
            imageView.constraints.forEach { constraint in
                if constraint.firstAttribute == .bottom {
                    constraint.priority = UILayoutPriority(rawValue: 750)
                }
                if constraint.firstAttribute == .centerY {
                    constraint.priority = UILayoutPriority(rawValue: 999)
                }
            }
        }
    }
}

注：该方法依赖系统视图层级，后续iOS版本可能失效，需谨慎使用。

验证建议 #

• 在iOS 15和iOS 16真机/模拟器分别测试，确保布局一致
• 覆盖不同尺寸设备（如iPhone SE、iPhone 14 Pro）验证适配效果

内容的提问来源于stack exchange，提问作者JanMensch