实现UINavigationBar滚动背景色渐变动画遇阻求助

1. 初始化导航栏Appearance（配置正确的透明初始状态） #

你之前用configureWithOpaqueBackground()会强制导航栏不透明，这是导致透明度无法平滑过渡的核心问题。替换成以下代码，初始化透明背景的导航栏样式：

let appearance = UINavigationBarAppearance()
appearance.configureWithTransparentBackground()
// 设置初始背景色，透明度为0（完全透明）
appearance.backgroundColor = Color.background?.withAlphaComponent(0)
// 可选：固定标题、按钮的文字颜色，避免受背景变化影响
appearance.titleTextAttributes = [.foregroundColor: UIColor.black]
appearance.buttonAppearance.normal.titleTextAttributes = [.foregroundColor: UIColor.systemBlue]

// 同时设置standardAppearance和scrollEdgeAppearance，保证滚动全程样式一致
navigationController?.navigationBar.standardAppearance = appearance
navigationController?.navigationBar.scrollEdgeAppearance = appearance
// 开启半透明适配，这是实现透明导航栏的必要设置
navigationController?.navigationBar.isTranslucent = true

2. 修改滚动监听逻辑，更新背景透明度 #

不要直接修改导航栏的alpha或barTintColor，而是通过更新UINavigationBarAppearance的背景色来实现渐变，这样只会影响导航栏背景，不会干扰内部按钮：

func scrollViewDidScroll(_ scrollView: UIScrollView) {
    var offset = scrollView.contentOffset.y / 350
    offset = min(offset, 1.0) // 限制透明度最大值为1
    
    // 复制当前Appearance并修改背景透明度
    let updatedAppearance = navigationController?.navigationBar.standardAppearance.copy()
    updatedAppearance?.backgroundColor = Color.background?.withAlphaComponent(offset)
    
    // 同步更新两个Appearance配置
    navigationController?.navigationBar.standardAppearance = updatedAppearance ?? UINavigationBarAppearance()
    navigationController?.navigationBar.scrollEdgeAppearance = updatedAppearance ?? UINavigationBarAppearance()
    
    // 处理返回按钮的显示/隐藏，添加动画更贴合系统效果
    navigationItem.setHidesBackButton(offset < 1.0, animated: true)
}

关键说明 #

• iOS13+必须通过UINavigationBarAppearance管理导航栏样式，直接修改导航栏的backgroundColor会被Appearance配置覆盖，导致无平滑过渡。
• 同时设置standardAppearance和scrollEdgeAppearance，可以避免滚动到顶部时导航栏样式跳变。
• isTranslucent = true不能省略，否则系统会自动给导航栏添加不透明遮罩，导致透明效果失效。

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