Swift UILabel中阿拉伯语文本双向渲染异常问题求助

问题概述 #

在iOS 18.2 + Swift 6环境下，UILabel加载超过11470字符的HTML字符串时，阿拉伯语文本错误地以从左到右（LTR）方向渲染，即使设置textAlignment = .right和semanticContentAttribute = .forceRightToLeft也无法解决。

解决方案 #

以下是三种可行的解决方法，按优先级排序：

1. 强化HTML中的RTL标记 #

在HTML的阿拉伯语段落中添加CSS样式，提升RTL属性优先级，避免长文本转换时属性丢失：

<!-- 修改阿拉伯语段落标签 -->
<p dir="rtl" lang="ar" style="direction: rtl; unicode-bidi: embed; text-align: right;">
  فَاِذَا قَرَاْتَ الْقُرْاٰنَ فَاسْتَعِذْ بِاللّٰهِ مِنَ الشَّيْطَانِ الرَّج۪يمِ
</p>

• direction: rtl：明确文本方向为从右到左
• unicode-bidi: embed：确保双向文本的嵌套渲染逻辑正确
• text-align: right：配合RTL方向完成文本对齐

2. 转换后手动修正NSAttributedString的段落样式 #

长文本转换为NSAttributedString时，部分RTL属性可能被忽略，可遍历文本范围，为包含阿拉伯语的段落强制设置RTL样式：

if let data = htmlString.data(using: .utf8) {
    let options: [NSAttributedString.DocumentReadingOptionKey: Any] = [
            .documentType: NSAttributedString.DocumentType.html,
            .characterEncoding: String.Encoding.utf8.rawValue
        ]
    do {
        let attributedString = try NSAttributedString(data: data, options: options, documentAttributes: nil)
        let mutableAttrStr = NSMutableAttributedString(attributedString: attributedString)
        
        // 遍历所有段落修正RTL样式
        mutableAttrStr.enumerateAttribute(.paragraphStyle, in: NSRange(location: 0, length: mutableAttrStr.length)) { (value, range, _) in
            let originalStyle = (value as? NSParagraphStyle) ?? NSParagraphStyle()
            let mutableStyle = originalStyle.mutableCopy() as! NSMutableParagraphStyle
            
            // 检查当前段落是否包含阿拉伯语字符
            let substring = (mutableAttrStr.string as NSString).substring(with: range)
            let hasArabicChars = substring.rangeOfCharacter(from: CharacterSet(charactersIn: "\u{0600}-\u{06FF}")) != nil
            
            if hasArabicChars {
                mutableStyle.baseWritingDirection = .rightToLeft
                mutableStyle.alignment = .right
            } else {
                mutableStyle.baseWritingDirection = .leftToRight
            }
            
            mutableAttrStr.addAttribute(.paragraphStyle, value: mutableStyle, range: range)
        }
        
        labelView.attributedText = mutableAttrStr
    } catch {
        print("HTML字符串处理错误: \(error)")
    }
}

3. 改用UITextView替代UILabel #

UITextView对长文本和双向文本的渲染支持比UILabel更稳定，尤其适配iOS新版本：

// 替换原UILabel为UITextView
let textView: UITextView = {
    let tv = UITextView()
    tv.textAlignment = .right
    tv.translatesAutoresizingMaskIntoConstraints = false
    tv.isEditable = false
    tv.isScrollEnabled = false // 不需要滚动时设置为false
    tv.semanticContentAttribute = .forceRightToLeft
    tv.backgroundColor = .white
    tv.textContainer.lineBreakMode = .byWordWrapping
    return tv
}()

// 赋值逻辑保持不变
if let data = htmlString.data(using: .utf8) {
    let options: [NSAttributedString.DocumentReadingOptionKey: Any] = [
            .documentType: NSAttributedString.DocumentType.html,
            .characterEncoding: String.Encoding.utf8.rawValue
        ]
    do {
        let attributedString = try NSAttributedString(data: data, options: options, documentAttributes: nil)
        textView.attributedText = attributedString
    } catch {
        print("HTML字符串处理错误: \(error)")
    }
}

说明 #

该问题大概率是iOS 18中NSAttributedString处理超长HTML时的属性丢失bug，强化HTML标记或手动修正段落样式可绕过此问题；若使用UITextView，需注意其默认内边距，可通过textContainerInset调整。

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