Swift中TableView背景渐变效果不生效问题求助

问题根源 #

1. tableView.backgroundView 默认值为 nil，调用 tableView.backgroundView?.aplicarDegradadoDeportes() 时，可选链直接跳过，渐变方法根本没执行。
2. 即便后续给 backgroundView 赋值，原代码中渐变层的 frame 仅在初始化时设置一次，当视图尺寸变化（如屏幕旋转）时，渐变无法自动适配新尺寸。

修复方案 #

方案一：扩展UIView并适配尺寸变化 #

先修改 viewDidLoad 中的代码，先创建背景视图再添加渐变：

override func viewDidLoad() {
    super.viewDidLoad()
    self.title = "Menú Principal"
    
    // 初始化背景视图并设置自动适配
    let bgView = UIView(frame: tableView.bounds)
    bgView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
    bgView.aplicarDegradadoDeportes()
    tableView.backgroundView = bgView
    
    self.navigationItem.setHidesBackButton(true, animated: true)
}

然后更新渐变方法，添加尺寸变化监听，确保渐变层始终适配视图边界：

extension UIView {
    func aplicarDegradadoDeportes() {
        // 移除已存在的渐变层，避免重复添加
        layer.sublayers?.filter { $0 is CAGradientLayer }.forEach { $0.removeFromSuperlayer() }
        
        let colorInicio = UIColor(red: 255/255, green: 59/255, blue: 0/255, alpha: 1.0).cgColor
        let colorFin = UIColor(red: 255/255, green: 255/255, blue: 0/255, alpha: 1.0).cgColor
        
        let gradientLayer = CAGradientLayer()
        gradientLayer.colors = [colorInicio, colorFin]
        gradientLayer.startPoint = CGPoint(x: 0.0, y: 0.5)
        gradientLayer.endPoint = CGPoint(x: 1.0, y: 0.5)
        gradientLayer.frame = bounds
        
        layer.insertSublayer(gradientLayer, at: 0)
        
        // 监听视图边界变化，更新渐变层frame
        NotificationCenter.default.addObserver(forName: UIView.boundsDidChangeNotification, object: self, queue: .main) { [weak self] _ in
            guard let self = self, let gradientLayer = self.layer.sublayers?.first(where: { $0 is CAGradientLayer }) as? CAGradientLayer else { return }
            gradientLayer.frame = self.bounds
        }
    }
}

方案二：自定义渐变视图（更优雅） #

创建一个继承自 UIView 的渐变视图，其layer直接使用 CAGradientLayer，自动适配尺寸变化：

class GradientView: UIView {
    override class var layerClass: AnyClass {
        return CAGradientLayer.self
    }
    
    func configurarDegradadoDeportes() {
        guard let gradientLayer = layer as? CAGradientLayer else { return }
        let colorInicio = UIColor(red: 255/255, green: 59/255, blue: 0/255, alpha: 1.0).cgColor
        let colorFin = UIColor(red: 255/255, green: 255/255, blue: 0/255, alpha: 1.0).cgColor
        
        gradientLayer.colors = [colorInicio, colorFin]
        gradientLayer.startPoint = CGPoint(x: 0.0, y: 0.5)
        gradientLayer.endPoint = CGPoint(x: 1.0, y: 0.5)
    }
}

然后在 viewDidLoad 中使用这个自定义视图：

override func viewDidLoad() {
    super.viewDidLoad()
    self.title = "Menú Principal"
    
    let bgView = GradientView(frame: tableView.bounds)
    bgView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
    bgView.configurarDegradadoDeportes()
    tableView.backgroundView = bgView
    
    self.navigationItem.setHidesBackButton(true, animated: true)
}

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