Swift实现字段聚焦模式：解决模糊遮罩受父视图裁剪限制

这个问题我之前也遇到过！父视图开启clipsToBounds = true后，不管怎么调子视图层级，遮罩都逃不出它的边界。核心问题就是你把遮罩放在了父视图的子层级里，自然受限于父视图的裁剪规则。下面给你两个实用的解决方案，直接绕开父视图的限制：

方案一：利用KeyWindow添加全局遮罩容器 #

把遮罩和需要聚焦的输入控件直接放到App的keyWindow里，这样就完全脱离了原来的父视图层级，不受任何裁剪限制。

代码示例（Swift） #

// 全局变量记录临时状态
private var focusOverlayContainer: UIView?
private var originalInputSuperview: UIView?
private var originalInputFrame: CGRect?

// UITextFieldDelegate 方法
func textFieldDidBeginEditing(_ textField: UITextField) {
    // 1. 记录输入框的原始父视图和位置
    originalInputSuperview = textField.superview
    originalInputFrame = textField.frame
    
    // 2. 创建模糊遮罩
    let blurEffect = UIBlurEffect(style: .dark)
    let blurView = UIVisualEffectView(effect: blurEffect)
    blurView.frame = UIScreen.main.bounds
    blurView.autoresizingMask = [.flexibleWidth, .flexibleHeight] // 适配旋转
    
    // 3. 创建容器视图，把遮罩和输入框放在一起
    let containerView = UIView(frame: UIScreen.main.bounds)
    containerView.addSubview(blurView)
    
    // 4. 转换输入框坐标到容器视图，保证位置正确
    let convertedFrame = textField.convert(textField.bounds, to: containerView)
    textField.frame = convertedFrame
    containerView.addSubview(textField)
    
    // 5. 将容器添加到keyWindow最顶层
    if let keyWindow = UIApplication.shared.connectedScenes
        .filter({ $0.activationState == .foregroundActive })
        .compactMap({ $0 as? UIWindowScene })
        .first?.windows.first(where: { $0.isKeyWindow }) {
        keyWindow.addSubview(containerView)
        focusOverlayContainer = containerView
    }
}

func textFieldDidEndEditing(_ textField: UITextField) {
    // 1. 把输入框移回原始父视图
    if let originalSuperview = originalInputSuperview, let originalFrame = originalInputFrame {
        textField.frame = originalFrame
        originalSuperview.addSubview(textField)
    }
    
    // 2. 清理遮罩容器
    focusOverlayContainer?.removeFromSuperview()
    focusOverlayContainer = nil
    originalInputSuperview = nil
    originalInputFrame = nil
}

方案二：使用独立的UIWindow #

创建一个层级高于主窗口的独立UIWindow，把遮罩和输入控件放在这个窗口里。这种方式更彻底，甚至能覆盖系统弹窗（如果需要的话）。

代码示例（Swift） #

private var focusWindow: UIWindow?

func textFieldDidBeginEditing(_ textField: UITextField) {
    guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene else { return }
    
    // 1. 创建新窗口，设置更高层级
    let newWindow = UIWindow(windowScene: windowScene)
    newWindow.frame = windowScene.coordinateSpace.bounds // 适配分屏场景
    newWindow.windowLevel = UIWindow.Level.alert + 1 // 层级高于系统alert
    newWindow.backgroundColor = .clear
    
    // 2. 添加模糊遮罩
    let blurEffect = UIBlurEffect(style: .dark)
    let blurView = UIVisualEffectView(effect: blurEffect)
    blurView.frame = newWindow.bounds
    blurView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
    newWindow.addSubview(blurView)
    
    // 3. 移动输入框到新窗口
    let convertedFrame = textField.convert(textField.bounds, to: newWindow)
    textField.frame = convertedFrame
    newWindow.addSubview(textField)
    
    // 4. 显示窗口
    newWindow.makeKeyAndVisible()
    focusWindow = newWindow
}

func textFieldDidEndEditing(_ textField: UITextField) {
    // 1. 移回输入框到原始位置
    if let originalSuperview = originalInputSuperview, let originalFrame = originalInputFrame {
        textField.frame = originalFrame
        originalSuperview.addSubview(textField)
    }
    
    // 2. 隐藏并销毁窗口
    focusWindow?.isHidden = true
    focusWindow = nil
}

注意事项 #

• 坐标转换：一定要用convert(_:to:)方法转换输入框的坐标，不然在新容器里位置会错乱。
• 屏幕适配：如果是iPad分屏场景，不要用UIScreen.main.bounds，改用当前windowScene的bounds，避免遮罩超出分屏区域。
• 旋转适配：给遮罩和输入控件设置autoresizingMask或者添加AutoLayout约束，保证旋转后布局正常。
• AutoLayout替代Frame：如果你的项目用AutoLayout，建议给输入框添加约束（比如保持和原始位置的相对关系），比用frame更稳定。

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