如何在原生Cocoa框架的NSTextView中实现悬挂标点？

Cocoa 实现悬挂标点排版方案 #

悬挂标点是让行首/行尾的标点延伸到文本块边距外、不占用正文排版宽度的效果，在Cocoa框架下按优先级选以下实现方式即可，不需要从零编写底层排版逻辑：

• 系统原生属性实现（推荐）
  macOS 10.8+、iOS 6.0 开始，AppKit/UIKit 内置了悬挂标点的排版支持，直接通过段落样式开启即可，由系统原生排版引擎处理换行、多语言混排、字体适配等所有边缘场景，性能和稳定性最好。
  核心代码：

  NSMutableParagraphStyle *paragraphStyle = [[NSMutableParagraphStyle alloc] init];
  // 开启内置悬挂标点支持，覆盖中英文常见的句首、句尾标点
  paragraphStyle.hangingPunctuation = YES;
  
  NSDictionary *attributes = @{
      NSParagraphStyleAttributeName: paragraphStyle,
      NSFontAttributeName: [NSFont systemFontOfSize:16]
  };
  NSAttributedString *content = [[NSAttributedString alloc] initWithString:@"你的排版文本" attributes:attributes];
  // 直接赋值给NSTextView、NSTextField的attributedStringValue即可生效
  

  如果是手动用Core Text做自定义绘制，对应给CTParagraphStyle设置kCTParagraphStyleSpecifierHangingPunctuation属性为kCFBooleanTrue即可。

• 自定义排版规则实现（兼容低版本/定制需求）
  如果需要兼容更老的系统版本，或者要自定义支持的标点范围、悬挂偏移量，可以自定义NSLayoutManager子类，重写行片段矩形的回调方法，在系统计算完每行排版位置后做微调：
  核心代码：

  - (BOOL)layoutManager:(NSLayoutManager *)layoutManager
  shouldSetLineFragmentRect:(inout NSRect *)lineFragmentRect
  lineFragmentUsedRect:(inout NSRect *)lineFragmentUsedRect
        inTextContainer:(NSTextContainer *)textContainer
          forGlyphRange:(NSRange)glyphRange {
      // 取当前行首的字符
      NSUInteger charIndex = [layoutManager characterIndexForGlyphAtIndex:glyphRange.location];
      if (charIndex >= layoutManager.textStorage.length) return YES;
      unichar firstChar = [layoutManager.textStorage.string characterAtIndex:charIndex];
      
      // 自定义需要悬挂的标点集合
      NSCharacterSet *hangingPunctSet = [NSCharacterSet characterSetWithCharactersInString:@"“”‘’（）《》【】、。，；："];
      if ([hangingPunctSet characterIsMember:firstChar]) {
          // 实时计算当前标点的排版宽度，不要用硬编码偏移
          NSRange charRange = NSMakeRange(charIndex, 1);
          NSRange glyphRangeForChar = [layoutManager glyphRangeForCharacterRange:charRange actualCharacterRange:nil];
          NSRect charBounds = [layoutManager boundingRectForGlyphRange:glyphRangeForChar inTextContainer:textContainer];
          // 左移行内容起始位置，让标点悬挂到左边距外侧
          lineFragmentUsedRect->origin.x -= charBounds.size.width;
      }
      return YES;
  }
  

• 常见注意点

  • 用NSTextField展示时，需要把allowsEditingTextAttributes属性设为YES，避免自定义的段落属性被系统默认样式覆盖
  • 不要硬编码标点的偏移宽度，不同字体、字号、字重下的标点字形宽度差异很大，必须通过排版接口实时取对应字形的尺寸
  • 如果需要实现行尾标点悬挂，逻辑和行首一致，判断行尾字符是否属于目标标点，右移行排版矩形的右边界即可

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