TextKit 2中如何实现NSLayoutManager式的换行背景色效果？

问题场景 #

• 调用NSTextLayoutManager.addRenderingAttribute(.backgroundColor, value: NSColor.red, for: range)时，行背景色仅覆盖到最后一个可见字符，行与行之间存在无背景色的细间隙。（效果：背景仅填充文本所在区域，行尾空白和行间隙无颜色）
• 使用旧版TextKit的NSLayoutManager.addTemporaryAttribute(.backgroundColor, value: NSColor.red, forCharacterRange: range)时，背景色会覆盖换行符、软换行对应的整行区域。（效果：背景填充整行，包括行尾空白和行与行之间的衔接区域）

需求：基于TextKit 2实现后者的背景覆盖效果，不使用NSLayoutManager。

可行解决方案 #

方案1：自定义NSTextRenderer扩展背景绘制范围 #

TextKit 2的NSTextRenderer负责文本渲染逻辑，通过子类化重写背景绘制方法，可强制背景填充整行：

class FullRowBackgroundRenderer: NSTextRenderer {
    override func drawBackground(in context: CGContext, characterRange: NSRange, layoutFragment: NSTextLayoutFragment, attributes: [NSAttributedString.Key : Any]) {
        guard let bgColor = attributes[.backgroundColor] as? NSColor else {
            super.drawBackground(in: context, characterRange: characterRange, layoutFragment: layoutFragment, attributes: attributes)
            return
        }
        
        // 遍历当前布局片段的所有行，填充整行的排版边界
        for lineFragment in layoutFragment.lineFragments {
            let fullLineRect = lineFragment.typographicBounds
            context.saveGState()
            bgColor.setFill()
            context.fill(fullLineRect)
            context.restoreGState()
        }
    }
}

将自定义渲染器绑定到NSTextLayoutManager：

let layoutManager = NSTextLayoutManager()
layoutManager.addRenderer(FullRowBackgroundRenderer(), for: .default)

方案2：结合段落样式与富文本属性 #

通过设置段落的固定行高，配合富文本的背景色属性，让背景色自然填充整行：

// 配置段落样式，固定行高以覆盖整行区域
let paragraphStyle = NSMutableParagraphStyle()
paragraphStyle.minimumLineHeight = 22
paragraphStyle.maximumLineHeight = 22

// 创建带背景色的富文本
let attributedText = NSAttributedString(string: "目标文本内容", attributes: [
    .backgroundColor: NSColor.red,
    .paragraphStyle: paragraphStyle
])

// 关联到TextKit 2的内容管理器
let contentManager = NSTextContentManager()
contentManager.textStorage = NSTextStorage(attributedString: attributedText)

这种方式需根据字体大小调整行高，确保背景色覆盖整行包括换行符区域。

方案3：通过NSTextLayoutManagerDelegate手动绘制背景 #

监听布局更新，针对目标范围内的布局片段手动绘制整行背景：

// 设置代理
layoutManager.delegate = self

// 实现代理方法处理布局后的绘制
extension YourClass: NSTextLayoutManagerDelegate {
    func textLayoutManager(_ textLayoutManager: NSTextLayoutManager, didLayout layoutFragment: NSTextLayoutFragment) {
        let targetRange = NSRange(location: 0, length: attributedText.length) // 替换为你的目标范围
        let fragmentRange = layoutFragment.characterRange
        
        guard targetRange.intersects(fragmentRange) else { return }
        
        // 获取当前上下文（需确保在正确的绘制周期调用）
        guard let context = NSGraphicsContext.current?.cgContext else { return }
        
        for lineFragment in layoutFragment.lineFragments {
            let lineRange = layoutFragment.characterRange(for: lineFragment)
            guard targetRange.intersects(lineRange) else { continue }
            
            let fullLineRect = lineFragment.typographicBounds
            context.saveGState()
            NSColor.red.setFill()
            context.fill(fullLineRect)
            context.restoreGState()
        }
    }
}

此方案适合需要精准控制特定行背景的场景，注意需在正确的绘制时机执行代码。

说明 #

TextKit 2默认的渲染属性仅针对可见字符的排版区域绘制背景，上述方案通过自定义渲染逻辑或调整布局参数，均可实现类似旧版NSLayoutManager临时属性的整行背景覆盖效果。

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