UIButton使用Configuration后，徽章子视图始终被标题和图片覆盖

问题背景 #

重构按钮为UIButton.Configuration实现后，添加的未读通知徽章始终渲染在按钮图标和标题下方，调用bringSubviewToFront(_:)也无法解决层级问题。

• 期望布局：徽章悬浮在按钮的铃铛图标右上角
• 实际效果：徽章被图标和标题遮挡，显示在下方

问题原因 #

使用UIButton.Configuration时，按钮的图标、标题等核心内容会被包裹在内部的contentView容器中，这个contentView的层级默认高于直接添加到UIButton的子视图，因此徽章会被它遮挡，单纯调整徽章在按钮视图层级中的顺序无效。

解决方案 #

1. 将徽章添加到contentView而非按钮本身 #

修改showBadge(withCount:)方法，把徽章添加到按钮的contentView中，同时在容器内调整层级：

private func showBadge(withCount count: Int) {
    // 先移除已存在的旧徽章，避免重复叠加
    notificationButton.contentView.subviews.forEach {
        if $0.tag == 9830384 {
            $0.removeFromSuperview()
        }
    }
    
    let badge = UILabel.badgeLabel(withCount: count)
    badge.tag = 9830384
    notificationButton.contentView.addSubview(badge) // 改为添加到contentView
    
    let size: CGSize = (badge.text! as NSString).size(withAttributes: [NSAttributedString.Key.font: UIFont.sansBold(size: 12)])
    
    badge.snp.makeConstraints { make in
        // 调整约束到contentView坐标系，定位在铃铛图标右上角（匹配期望布局）
        make.centerX.equalTo(notificationButton.imageView!.snp.trailing)
        make.centerY.equalTo(notificationButton.imageView!.snp.top)
        make.width.equalTo(size.width + 10)
        make.height.equalTo(16)
    }
    
    // 在contentView容器内将徽章置于最上层
    notificationButton.contentView.bringSubviewToFront(badge)
}

2. 修正约束逻辑 #

原代码中make.trailing.equalTo(notificationButton.snp.leading).offset(25)会将徽章定位在按钮外部左侧，与期望布局不符。改为基于按钮的imageView定位，确保徽章落在图标右上角区域。

3. 额外注意事项 #

确保在调用showBadge前，按钮的图标已完成设置（即notificationButton.imageView不为nil），可以在按钮初始化并设置图片后再触发徽章渲染逻辑。

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