Swift技术问询：无需Storyboard全局创建顶部响应提示视图的方案

当然可以！我在项目里经常用这种全局提示组件，完全不用依赖Storyboard，也不用在每个ViewController里重复写代码，完美适配导航栏位置。下面是完整的实现方案：

核心思路 #

我们可以做一个单例管理类，把提示视图直接添加到当前的UIWindow上（或iOS 13+的UIWindowScene），这样就能保证它在所有页面的最上层（导航栏下方）。同时通过监听当前页面的导航栏状态，自动调整提示视图的Y轴位置，不用手动计算高度。

完整代码实现 #

1. 定义提示视图样式枚举 #

先区分不同的提示类型，方便对应不同的视觉样式：

enum TopAlertType {
    case error    // 错误提示，比如无网络
    case warning  // 警告提示
    case success  // 成功提示
}

2. 实现顶部提示视图类 #

纯代码写一个自定义的TopAlertView，负责承载内容和基础样式：

import UIKit

class TopAlertView: UIView {
    private let messageLabel: UILabel = {
        let label = UILabel()
        label.textColor = .white
        label.font = UIFont.systemFont(ofSize: 14)
        label.textAlignment = .center
        label.numberOfLines = 0
        return label
    }()
    
    init(message: String, type: TopAlertType) {
        super.init(frame: .zero)
        setupUI(message: message, type: type)
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    private func setupUI(message: String, type: TopAlertType) {
        // 根据类型设置背景色
        switch type {
        case .error: backgroundColor = .systemRed
        case .warning: backgroundColor = .systemOrange
        case .success: backgroundColor = .systemGreen
        }
        
        addSubview(messageLabel)
        messageLabel.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            messageLabel.leadingAnchor.constraint(equalTo: leadingAnchor, constant: 16),
            messageLabel.trailingAnchor.constraint(equalTo: trailingAnchor, constant: -16),
            messageLabel.topAnchor.constraint(equalTo: topAnchor, constant: 12),
            messageLabel.bottomAnchor.constraint(equalTo: bottomAnchor, constant: -12)
        ])
        messageLabel.text = message
    }
}

3. 实现全局提示管理类（单例） #

这个类是核心，负责处理提示的显示、隐藏，以及自动适配导航栏位置：

class TopAlertManager {
    static let shared = TopAlertManager()
    private var currentAlertView: TopAlertView?
    private let window: UIWindow?
    
    private init() {
        // 适配iOS 13+多场景，获取当前活跃的主窗口
        if #available(iOS 13.0, *) {
            window = UIApplication.shared.connectedScenes
                .filter({$0.activationState == .foregroundActive})
                .map({$0 as? UIWindowScene})
                .compactMap({$0})
                .first?.windows
                .filter({$0.isKeyWindow}).first
        } else {
            window = UIApplication.shared.keyWindow
        }
    }
    
    // 显示提示方法
    func show(message: String, type: TopAlertType, duration: TimeInterval = 3.0) {
        // 先隐藏之前的提示，避免重叠
        hide()
        
        // 创建提示视图
        let alertView = TopAlertView(message: message, type: type)
        currentAlertView = alertView
        window?.addSubview(alertView)
        alertView.translatesAutoresizingMaskIntoConstraints = false
        
        // 计算顶部偏移：状态栏高度 + （导航栏存在时的导航栏高度）
        let statusBarHeight = window?.windowScene?.statusBarManager?.statusBarFrame.height ?? 0
        var topOffset = statusBarHeight
        
        if let topVC = getTopViewController(), 
           let navBar = topVC.navigationController?.navigationBar, 
           !navBar.isHidden {
            topOffset += navBar.frame.height
        }
        
        // 设置约束
        NSLayoutConstraint.activate([
            alertView.leadingAnchor.constraint(equalTo: window!.leadingAnchor),
            alertView.trailingAnchor.constraint(equalTo: window!.trailingAnchor),
            alertView.topAnchor.constraint(equalTo: window!.topAnchor, constant: topOffset),
            alertView.heightAnchor.constraint(greaterThanOrEqualToConstant: 44) // 保证最小高度
        ])
        
        // 滑入动画
        alertView.transform = CGAffineTransform(translationX: 0, y: -alertView.frame.height)
        UIView.animate(withDuration: 0.3) {
            alertView.transform = .identity
        }
        
        // 自动隐藏
        DispatchQueue.main.asyncAfter(deadline: .now() + duration) {
            self.hide()
        }
    }
    
    // 手动隐藏提示方法
    func hide() {
        guard let alertView = currentAlertView else { return }
        UIView.animate(withDuration: 0.3, animations: {
            alertView.transform = CGAffineTransform(translationX: 0, y: -alertView.frame.height)
        }) { _ in
            alertView.removeFromSuperview()
            self.currentAlertView = nil
        }
    }
    
    // 获取当前最顶层的ViewController，用于判断导航栏状态
    private func getTopViewController() -> UIViewController? {
        guard let rootVC = window?.rootViewController else { return nil }
        return getTopViewController(from: rootVC)
    }
    
    private func getTopViewController(from vc: UIViewController) -> UIViewController? {
        if let navVC = vc as? UINavigationController {
            return getTopViewController(from: navVC.visibleViewController ?? navVC)
        } else if let tabVC = vc as? UITabBarController {
            return getTopViewController(from: tabVC.selectedViewController ?? tabVC)
        } else if let presentedVC = vc.presentedViewController {
            return getTopViewController(from: presentedVC)
        }
        return vc
    }
}

使用方式 #

在任何地方直接调用即可，比如无网络提示：

// 显示错误提示，默认3秒后自动消失
TopAlertManager.shared.show(message: "No Internet Connection", type: .error)

// 自定义显示时长的成功提示
TopAlertManager.shared.show(message: "操作成功！", type: .success, duration: 2.0)

// 手动提前隐藏提示
TopAlertManager.shared.hide()

优化建议 #

• 可以给TopAlertView添加更多自定义属性，比如圆角、阴影、自定义字体/颜色；
• 加入暗黑模式适配，根据系统模式调整样式；
• 添加队列机制，当多个提示同时触发时，按顺序依次显示；
• 支持点击提示视图手动关闭的交互。

这样就完全满足你的需求了——不用Storyboard，不用每个VC重复写代码，自动适配导航栏位置，全局可调用！

内容的提问来源于stack exchange，提问作者Kárpáti András