应用transform后UITextView文本消失问题排查求助

核心问题定位 #

当为UITextView传入自定义NSTextContainer时，点击手势触发滑出动画后文本消失，本质是NSTextContainer与UITextView的布局关联链被破坏。即使使用默认NSLayoutManager仍出现问题，说明问题不在LayoutManager的自定义逻辑，而是NSTextContainer的初始化、绑定方式或动画过程中的布局同步有误。

常见错误场景与修复方案 #

1. 错误的文本布局链构建 #

很多开发者手动创建NSTextContainer后直接赋值给UITextView，忽略了NSTextStorage -> NSLayoutManager -> NSTextContainer三者的完整关联，导致文本渲染链路断裂。

错误示例代码：

// 错误：直接赋值容器，未构建完整布局链
let customContainer = NSTextContainer(size: CGSize(width: 300, height: CGFloat.greatestFiniteMagnitude))
let textView = UITextView(frame: CGRect(x: 0, y: 0, width: 300, height: 200))
textView.layoutManager = NSLayoutManager()
textView.textContainer = customContainer

修复方案：

手动构建完整的文本布局关联链，确保三者绑定正确：

// 构建完整文本布局链
let textStorage = NSTextStorage(string: "测试文本内容")
let layoutManager = NSLayoutManager()
let customContainer = NSTextContainer(size: CGSize(width: 300, height: CGFloat.greatestFiniteMagnitude))

// 依次关联组件
textStorage.addLayoutManager(layoutManager)
layoutManager.addTextContainer(customContainer)

// 绑定到UITextView
let textView = UITextView(frame: CGRect(x: 0, y: 0, width: 300, height: 200))
textView.textStorage = textStorage
textView.layoutManager = layoutManager
textView.textContainer = customContainer

2. 动画过程中文本容器尺寸未同步 #

滑出动画修改UITextView的frame或约束时，如果NSTextContainer的size未同步更新，会导致文本容器尺寸与视图显示区域不匹配，触发文本不渲染。

修复方案：

动画开始前强制同步文本容器尺寸与UITextView的可显示区域：

@objc func handleTap() {
    // 动画前同步容器尺寸
    textView.textContainer.size = textView.bounds.size
    // 执行滑出动画
    UIView.animate(withDuration: 0.3) {
        self.textView.frame.origin.x = -self.textView.bounds.width
    }
}

3. 自定义手势与UITextView内置手势冲突 #

UITextView自带点击、选中文本的内置手势，自定义手势如果阻断了内置手势的响应，会干扰其内部文本布局更新逻辑，导致文本消失。

修复方案：

• 禁用自定义手势的触摸阻断：

let tapGesture = UITapGestureRecognizer(target: self, action: #selector(handleTap))
tapGesture.cancelsTouchesInView = false
textView.addGestureRecognizer(tapGesture)

• 或设置自定义手势在UITextView内置手势失败后触发：

if let builtInTap = textView.gestureRecognizers?.first(where: { $0 is UITapGestureRecognizer }) {
    tapGesture.require(toFail: builtInTap)
}

验证步骤 #

1. 用默认UITextView（不使用自定义NSTextContainer）测试点击动画，确认文本显示正常。
2. 按照正确布局链方式创建自定义NSTextContainer，再次测试动画。
3. 逐步排查手势冲突、尺寸同步问题，定位具体触发点。

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