是什么?
NSAttributedString管理一个字符串,以及与该字符串中的单个字符或某些范围的字符串相关的属性。NSAttributedString就是用来存储这些信息的,具体实现时,NSAttributedString维护了一个NSString,用来保存最原始的字符串,另有一个NSDictionary用来保存各个子串/字符的属性。
如何创建?
Foundation中的方法:
- (instancetype)initWithString:(NSString *)str; - (instancetype)initWithString:(NSString *)str attributes:(NSDictionary *)attrs; - (instancetype)initWithAttributedString:(NSAttributedString *)attrStr;
UIKit中的方法:
- (instancetype)initWithFileURL:(NSURL *)url options:(NSDictionary *)options documentAttributes:(NSDictionary **)dict error:(NSError **)error NS_AVAILABLE_IOS(7_0); - (instancetype)initWithData:(NSData *)data options:(NSDictionary *)options documentAttributes:(NSDictionary **)dict error:(NSError **)error NS_AVAILABLE_IOS(7_0);
如何应用?
在UILabel中的应用
UILabel *attributedLabel = [[UILabel alloc] initWithFrame:CGRectMake(20, 80, 200, 20)]; NSAttributedString *attributedString = [[NSAttributedString alloc] initWithString:@"文字显示内容" attributes:@{NSUnderlineStyleAttributeName:@(NSUnderlineStyleSingle),NSUnderlineColorAttributeName:[UIColor redColor]}];//下划线,下划线颜色 attributedLabel.attributedText = attributedString; [self.view addSubview:attributedLabel];
UITextView中得应用
UITextView *attributedTextView = [[UITextView alloc] initWithFrame:CGRectMake(20, 150, 200, 150)]; //可设置行高,行间距等 NSMutableParagraphStyle *paragraphStyle = [[NSMutableParagraphStyle alloc] init]; paragraphStyle.lineHeightMultiple = 30.0f;//行高 paragraphStyle.maximumLineHeight = 50.0f;//最大行高 paragraphStyle.minimumLineHeight = 20.0f;//最小行高 paragraphStyle.firstLineHeadIndent = 20.0f;//设置首行缩进 paragraphStyle.lineSpacing = 20.0f;//行间距 NSAttributedString *attributedString2 = [[NSAttributedString alloc] initWithString:@"文字显示内容" attributes:@{NSUnderlineStyleAttributeName:@(NSUnderlineStyleSingle),NSUnderlineColorAttributeName:[UIColor redColor],NSParagraphStyleAttributeName:paragraphStyle}]; NSMutableAttributedString *mutableAttributedString = [[NSMutableAttributedString alloc] initWithAttributedString:attributedString2]; [mutableAttributedString addAttributes:@{NSForegroundColorAttributeName:[UIColor redColor],NSFontAttributeName:[UIFont systemFontOfSize:20.0f]} range:NSMakeRange(0, 2)];//文字 为红色,20号字 [mutableAttributedString addAttributes:@{NSFontAttributeName:[UIFont systemFontOfSize:10.0f]} range:NSMakeRange(2, 4)];//其它文字为10号文字 attributedTextView.attributedText = mutableAttributedString; [self.view addSubview:attributedTextView];
UITextField中的应用
UITextField *attributedTextField = [[UITextField alloc] initWithFrame:CGRectMake(20, 250, 200, 50)]; attributedTextField.attributedText = attributedString2; [self.view addSubview:attributedTextField];
段落属性:NSParagraphStyle
alignment //对齐方式 firstLineHeadIndent //首行缩进 headIndent //缩进 tailIndent //尾部缩进 lineBreakMode //断行方式 maximumLineHeight //最大行高 minimumLineHeight //最低行高 lineSpacing //行距 paragraphSpacing //段距 paragraphSpacingBefore //段首空间 baseWritingDirection //句子方向 lineHeightMultiple //可变行高,乘因数。 hyphenationFactor //连字符属性
字符属性常量:
字符属性可以应用于 attributed string 的文本中,更多常量定义可以查看NSAttributedString.h头文件。
1> NSFontAttributeName(字体)
该属性所对应的值是一个 UIFont 对象。该属性用于改变一段文本的字体。如果不指定该属性,则默认为12-point Helvetica(Neue)。
2> NSParagraphStyleAttributeName(段落)
该属性所对应的值是一个 NSParagraphStyle 对象。该属性在一段文本上应用多个属性。如果不指定该属性,则默认为 NSParagraphStyle 的defaultParagraphStyle 方法返回的默认段落属性。
3> NSForegroundColorAttributeName(字体颜色)
该属性所对应的值是一个 UIColor 对象。该属性用于指定一段文本的字体颜色。如果不指定该属性,则默认为黑色。
4> NSBackgroundColorAttributeName(字体背景色)
该属性所对应的值是一个 UIColor 对象。该属性用于指定一段文本的背景颜色。如果不指定该属性,则默认无背景色。
5> NSLigatureAttributeName(连字符)
该属性所对应的值是一个 NSNumber 对象(整数)。连体字符是指某些连在一起的字符,它们采用单个的图元符号。0 表示没有连体字符。1 表示使用默认的连体字符。2表示使用所有连体符号。默认值为 1(注意,iOS 不支持值为 2)。
6> NSKernAttributeName(字间距)
该属性所对应的值是一个 NSNumber 对象(整数)。字母紧排指定了用于调整字距的像素点数。字母紧排的效果依赖于字体。值为 0 表示不使用字母紧排。默认值为0。
7> NSStrikethroughStyleAttributeName(删除线)
该属性所对应的值是一个 NSNumber 对象(整数)。该值指定是否在文字上加上删除线,该值参考“Underline Style Attributes”。默认值是NSUnderlineStyleNone。
8> NSUnderlineStyleAttributeName(下划线)
该属性所对应的值是一个 NSNumber 对象(整数)。该值指定是否在文字上加上下划线,该值参考“Underline Style Attributes”。默认值是NSUnderlineStyleNone。
9> NSStrokeColorAttributeName(边线颜色)
该属性所对应的值是一个 UIColor 对象。如果该属性不指定(默认),则等同于 NSForegroundColorAttributeName。否则,指定为删除线或下划线颜色。更多细节见“Drawing attributedstrings that are both filled and stroked”。
10> NSStrokeWidthAttributeName(边线宽度)
该属性所对应的值是一个 NSNumber 对象(小数)。该值改变描边宽度(相对于字体size 的百分比)。默认为 0,即不改变。正数只改变描边宽度。负数同时改变文字的描边和填充宽度。例如,对于常见的空心字,这个值通常为3.0。
11> NSShadowAttributeName(阴影)
该属性所对应的值是一个 NSShadow 对象。默认为 nil。
12> NSVerticalGlyphFormAttributeName(横竖排版)
该属性所对应的值是一个 NSNumber 对象(整数)。0 表示横排文本。1 表示竖排文本。在 iOS 中,总是使用横排文本,0 以外的值都未定义。