Skip to content

NSParagraphStyle ​

NSParagraphStyle 表示一组段落样式:对齐、行距、段距、缩进、换行方式。它作为 paragraphStyle 属性放进富文本,对它覆盖到的整个段落生效。一个段落是两个换行符之间的文字。

NSParagraphStyle 的属性全部只读。要设值,建一个 NSMutableParagraphStyle,或者调 mutableCopy()。

段落样式放进富文本时,放的是当时的一份副本。之后再改那个 NSMutableParagraphStyle,已经建好的富文本不变。从富文本读回来的段落样式也是副本。

NSParagraphStyle 不派发事件,它的值不会变,所以没有变化通知。

继承关系:EventTarget → NSObject → NSParagraphStyle

调行距和对齐的写法见指南显示带样式的文字。

构造函数 ​

NSParagraphStyle()

创建一个默认样式,和 NSParagraphStyle.defaultParagraphStyle 的值相同。

静态属性 ​

NSParagraphStyle.defaultParagraphStyle 只读

系统的默认段落样式。

实例属性 ​

还继承 NSObject 的属性。全部只读,给它们赋值抛 TypeError。

属性说明
alignment 只读对齐
lineSpacing 只读行与行之间额外加的距离
paragraphSpacing 只读这一段结束后空出的距离
paragraphSpacingBefore 只读这一段开始前空出的距离
firstLineHeadIndent 只读第一行左边缩进多少
headIndent 只读第一行以外的各行左边缩进多少
tailIndent 只读行的右边界
lineBreakMode 只读一行放不下时怎么处理
minimumLineHeight 只读行高的下限
maximumLineHeight 只读行高的上限
lineHeightMultiple 只读行高是字体自然行高的几倍
baseWritingDirection 只读这一段从哪边开始排
hyphenationFactor 只读断字的积极程度
defaultTabInterval 只读制表符之间的默认间隔
allowsDefaultTighteningForTruncation 只读截断之前是否先收紧字距

实例方法 ​

方法说明
copy()一份值相同、不可改的副本
mutableCopy()一份值相同、可以改的副本

示例 ​

js
const style = NSParagraphStyle.defaultParagraphStyle;
console.log(style.alignment, style.lineSpacing, style.lineBreakMode);

结果:控制台输出 natural 0 byWordWrapping。

对应的 iOS API ​

ObjCJS
NSParagraphStyle.defaultParagraphStyleNSParagraphStyle.defaultParagraphStyle
style.alignment = NSTextAlignmentCenterstyle.alignment = 'center'(在 NSMutableParagraphStyle 上)
[style mutableCopy]style.mutableCopy()

参见 ​