#向参考的博客原文作者致敬
#参考链接:
http://www.jianshu.com/p/8f49c9c99b21
http://www.cnblogs.com/wangbinios/p/6123946.html
http://blog.csdn.net/liujinlongxa/article/details/44840753
#待学习链接
http://www.itnose.net/detail/6177538.html
http://blog.csdn.net/ys410900345/article/details/25976179
http://www.cocoachina.com/ios/20160512/16223.html
本篇博客主要是NSMutableAttributedString的简介篇,详细篇后续有时间跟新,欢迎大家批评改正。
一、创建方式
简述:
NSMutableAttributedString适用的控件非常多,例如:UITextView
、UILabel
、UIButton
....等,这里总结就以《UILabel》为例子。
《1》、方式一:
/* 创建一个label */
UILabel *testLabel = [[UILabel alloc] initWithFrame:CGRectMake(30, 60, 200, 200)];
/* 自动换行 */
testLabel.numberOfLines = 0;
/* 初始化的字符串 */
NSString *testStr = @"年轻人就要多去挑战,要让不可能成为可能";
#/* 初始化的方式创建 */
NSMutableAttributedString *attributedString = [[NSMutableAttributedString alloc] initWithString:testStr];
#//也可以使用此方法初始化创建- (instancetype)initWithString:(NSString *)str;
/****** 最基本的添加属性的方式,使用哪一个属性就添加哪一个 ,这里只是随便使用了几个属性后续有时间还会一一介绍。******/
/*****
*@Attribute 参数含义:添加的属性名称
*@value:属性所需要赋的值
*@range: 添加的属性适应的范围
************/
[attributedString addAttribute:NSFontAttributeName value:[UIFont fontWithName: @"Zapfino" size: 15] range:NSMakeRange(0, testStr.length)];
[attributedString addAttribute: NSForegroundColorAttributeName value: [UIColor blueColor] range: NSMakeRange(0, 4)];
[attributedString addAttribute: NSForegroundColorAttributeName value: [UIColor redColor] range: NSMakeRange(4, 3)];
#/* 这里需要注意UILabel之前是使用Label的`text`属性进行赋值的,但是使用NSMutableAttributedString设置完文本后就要改成控件的`attributedText`属性进行赋值否则会有警告并且赋值不成功。*/
testLabel.attributedText = attributedString;
[self.view addSubview:testLabel]
《2》、方式二:
/* 创建一个label */
UILabel *testLabel = [[UILabel alloc] initWithFrame:CGRectMake(30, 60, 200, 200)];
/* 自动换行 */
testLabel.numberOfLines = 0;
/* 初始化的字符串 */
NSString *testStr = @"年轻人就要多去挑战,要让不可能成为可能";
#/*使用字典创建,然后直接将要设置的属性添加到字典中 */
NSDictionary *attrDict = @{ NSFontAttributeName: [UIFont fontWithName: @"Zapfino" size: 15], NSForegroundColorAttributeName: [UIColor blueColor] };
#/* 这里使用NSMutableAttributedString中自带的一个个实例方法将刚才设置的全部属性添加进去*/
testLabel.attributedText = [[NSAttributedString alloc] initWithString: testStr attributes: attrDict];
[self.view addSubview:testLabel];
二、方法简介
《1》、常用方法简介
/* 初始化方法 */
- (instancetype)initWithString:(NSString *)str;
- (instancetype)initWithString:(NSString *)str attributes:(nullable NSDictionary<NSString *, id> *)attrs;
- (instancetype)initWithAttributedString:(NSAttributedString *)attrStr;
/* 为某一范围内文字设置多个属性 */
- (void)setAttributes:(NSDictionary *)attrs range:(NSRange)range;
/* 为某一范围内文字添加某个属性 */
- (void)addAttribute:(NSString *)name value:(id)value range:(NSRange)range;
/* 为某一范围内文字添加多个属性 */
- (void)addAttributes:(NSDictionary *)attrs range:(NSRange)range;
/*移除某范围内的某个属性*/
- (void)removeAttribute:(NSString *)name range:(NSRange)range;
《2》、详细介绍一些方法
[1]、获取指定位置上的属性信息,并返回与指定位置属性相同并且连续的字符串的范围信息。
- (NSDictionary<NSString *, id> *)attributesAtIndex:(NSUInteger)location effectiveRange:(nullable NSRangePointer)range;
#例如:
NSRange range = NSMakeRange(0, 2);
NSDictionary*dic = [attributedString attributesAtIndex:2 effectiveRange:&range];
#参数介绍:
@location :为位置信息 对应例子中attributesAtIndex:2
@effectiveRange 有效范围 对应例子中&range
[2]、获取指定范围内的子字符串的信息
#参数介绍:
@NSAttributedString 返回一个NSAttributedString是咧对象
@range 从哪一个范围获取
- (NSAttributedString *)attributedSubstringFromRange:(NSRange)range;
[3]、** 在Range中查找string从attributesAtIndex:开始找,找到的第一个属性,即attributeDict,把属性的位置传给longestEffectiveRange:属性 **
#参数介绍:
@inRange 在字符串中的范围查找
@attributesAtIndex 从哪一个索引开始查找,找到第一个属性
@longestEffectiveRange 将第一个属性的位置传过来
#/* 方法 */
- (NSDictionary<NSString *, id> *)attributesAtIndex:(NSUInteger)location longestEffectiveRange:(nullable NSRangePointer)range inRange:(NSRange)rangeLimit;
能成为可能";
#范例:
/* 创建一个label */ UILabel *testLabel = [[UILabel alloc] initWithFrame:CGRectMake(30, 60, 200, 200)];
[self.view addSubview:testLabel];
NSString *testStr = @"年轻人就要多去挑战,要让不可能成为可能";
NSDictionary *attrDict = @{ NSFontAttributeName: [UIFont fontWithName: @"Zapfino" size: 15], NSForegroundColorAttributeName: [UIColor blueColor] };
NSMutableAttributedString *attributedString = [[NSMutableAttributedString alloc] initWithString:testStr attributes:attrDict];
[attributedString addAttribute:NSForegroundColorAttributeNamevalue: [UIColor redColor] range:NSMakeRange(7, 5)];
NSDictionary *attributeDict;
NSRange effectiveRange = { 0, 10 };
do {
NSRange range = NSMakeRange (NSMaxRange(effectiveRange), [attributedString length] - NSMaxRange(effectiveRange));
attributeDict = [attributedString attributesAtIndex: range.location longestEffectiveRange: &effectiveRange inRange: range];
NSLog (@"Range: %@ Attributes: %@",
NSStringFromRange(effectiveRange), attributeDict);
testLabel.attributedText = attributedString;
} while (NSMaxRange(effectiveRange) < [attributedString length]);
[4]、判断两个NSAttributedString是否相等
- (BOOL)isEqualToAttributedString:(NSAttributedString *)other;
三、属性简介
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(字间距)
** NSKernAttributeName 设定字符间距,取值为 NSNumber 对象(整数),正值间距加宽,负值间距变窄**
7、NSStrikethroughStyleAttributeName(删除线)
NSStrikethroughStyleAttributeName 设置删除线,取值为 NSNumber 对象(整数),枚举常量 NSUnderlineStyle中的值:
NSUnderlineStyleNone。/* 默认值 */
NSUnderlineStyleNone /* 不设置删除线 */
NSUnderlineStyleSingle/* 设置删除线为细单实线 */
NSUnderlineStyleThick/* 设置删除线为粗单实线 */
NSUnderlineStyleDouble /* 设置删除线为细双实线 */
8、NSStrikethroughColorAttributeName (删除线颜色)
** NSStrikethroughColorAttributeName 设置删除线颜色,取值为 UIColor 对象,默认值为黑色**
9、NSUnderlineStyleAttributeName(下划线)
该属性所对应的值是一个 NSNumber 对象(整数)。
该值指定是否在文字上加上下划线,该值参考“Underline Style Attributes”。
默认值是NSUnderlineStyleNone。
#下划线除了线条位置和删除线不同外,其他的都可以完全参照删除线设置。
10、NSUnderlineColorAttributeName(下划线颜色)
** NSUnderlineColorAttributeName 设置下划线颜色,取值为 UIColor 对象,默认值为黑色 **
11、NSStrokeColorAttributeName(边线颜色)
12、NSStrokeWidthAttributeName(边线宽度)
13、NSShadowAttributeName(阴影)
该属性所对应的值是一个 NSShadow 对象。默认为 nil。单独设置不好使,和这三个任一个都好使,NSVerticalGlyphFormAttributeName,
NSObliquenessAttributeName,
NSExpansionAttributeName
14、NSVerticalGlyphFormAttributeName(横竖排版)
** 该属性所对应的值是一个 NSNumber 对象(整数)。0 表示横排文本。1 表示竖排文本。在 iOS 中,总是使用横排文本,0 以外的值都未定义。**