SwiftUI半模态视图(half modal)未激活时父视图TextField无法点击问题

核心触发原因 #

绝大多数该类故障都是不可见的半模态容器视图拦截了下层交互事件导致，常见的触发场景分为3类：

1. UIKit封装层未禁用非激活状态的用户交互
   你自定义封装的半模态视图，默认会在父视图的层级上插入一个全屏的根容器，哪怕半模态处于未激活状态（内容视图偏移到屏幕外、透明度为0），只要你没有在UIKit层面对该容器设置isUserInteractionEnabled = false，这个全屏的不可见容器就会默认吃掉所有下层点击事件，TextField的点击事件无法被触发。
2. SwiftUI层未对非激活半模态禁用命中测试
   如果你是用SwiftUI修饰符控制半模态的显隐（offset、opacity等），没有在非激活状态下给半模态视图加allowsHitTesting(false)修饰符，哪怕半模态内容不可见，视图的命中测试逻辑依然生效，会拦截下层交互。
3. 视图层级/显隐逻辑错误

• 半模态视图的声明顺序在TextField之后，SwiftUI默认后声明的视图层级更高，不可见的上层视图自然会拦截下层点击
• 半模态未激活时没有从视图栈中移除，只是做了隐藏处理，保留的遮罩层/容器层依然可交互

对应修复方案 #

• UIKit封装层增加状态判断：半模态未激活时设置根容器isUserInteractionEnabled = false，激活时再恢复为true
• SwiftUI层给半模态视图加修饰符：allowsHitTesting(你的半模态激活状态变量)，非激活状态直接放弃所有命中测试
• 优先使用条件渲染逻辑：if 半模态激活 { 半模态视图 }，未激活时直接将半模态从视图层级中移除，从根源避免交互拦截
• 若需要保留半模态在视图栈中做动画过渡，可给父视图的TextField等需要交互的元素加zIndex(1)，提高其层级优先级，避免被上层半模态容器拦截

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