在iOS开发中,有时会遇到需要添加下划线,或者设置字符串中某几个字的颜色的情况,最常见的栗子就是注册页面,如图所示:
几乎所有注册页面中都会出现这么一句话 “点击下一步表示您已同意《用户服务协议》”,而且可以看到,“《用户服务协议》”几个字是橙色的,并且它们下面还有下划线。这是怎么实现的呢?
有的同学可能会说:“不同颜色就设置两个label,让左边的label显示前半句并设置为黑色,让右边的label显示后半句并设置为橙色就行了。” 这样也许是一个办法,但是感觉有些麻烦,而且如果有很多种颜色呢?难道要设置一大堆label吗。。。
NSMutableAttributedString 就可以完美的解决这些问题。我们先说一下和 attributes 有关的四个方法:
为某一范围内文字设置多个属性
- (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;
我们来举个栗子吧:
- (void)viewDidLoad { [super viewDidLoad]; UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(0, 100, ScreenWidth, 40)]; label.font = [UIFont systemFontOfSize:18]; // 字体大小 label.textAlignment = NSTextAlignmentCenter; // 文字对齐方式 NSMutableAttributedString *str = [[NSMutableAttributedString alloc] initWithString: @"点击下一步表示您已同意《用户服务协议》"]; [str addAttribute:NSForegroundColorAttributeName value: [UIColor colorWithRed:100/255.0 green:100/255.0 blue:100/255.0 alpha:1] range:NSMakeRange(0,11)]; [str addAttribute:NSForegroundColorAttributeName value: [UIColor colorWithRed:255/255.0 green:110/255.0 blue:17/255.0 alpha:1] range:NSMakeRange(11,8)]; label.attributedText = str; [self.view addSubview:label]; }
我们创建一个 NSMutableAttributedString 的对象 str,然后为它添加一个属性,这个属性的名字叫做 NSForegroundColorAttributeName,就是文字的颜色,它的值是 UIColor,默认是黑色,我们给它自定义一个颜色,然后设置它的范围,NSMakeRange(0, 11) 的意思就是说,从第0个字开始,一共11个字。这个范围其实就是 “点击下一步表示您已同意” 这11个字。(事实上,第一幅图中的这11个字并不是黑色,但是和黑色比较接近,这不重要~)
然后我们又给这个字符串添加了一个属性,这个属性还是 NSForegroundColorAttributedName,但是颜色是橙色,并且范围是从第11(别忘了编号从0开始)个字开始,一共8个字。这个范围其实就是 “《用户服务协议》“(书名号也算)
现在我们运行程序来看看效果:
文字颜色已经搞定了,接下来我们来加下划线。我们在原来代码的基础上再加一句话:
- (void)viewDidLoad { [super viewDidLoad]; UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(0, 100, ScreenWidth, 40)]; label.font = [UIFont systemFontOfSize:18]; // 字体大小 label.textAlignment = NSTextAlignmentCenter; // 文字对齐方式 NSMutableAttributedString *str = [[NSMutableAttributedString alloc] initWithString: @"点击下一步表示您已同意《用户服务协议》"]; [str addAttribute:NSForegroundColorAttributeName value: [UIColor colorWithRed:100/255.0 green:100/255.0 blue:100/255.0 alpha:1] range:NSMakeRange(0,11)]; [str addAttribute:NSForegroundColorAttributeName value: [UIColor colorWithRed:255/255.0 green:110/255.0 blue:17/255.0 alpha:1] range:NSMakeRange(11,8)]; [str addAttribute:NSUnderlineStyleAttributeName value: [NSNumber numberWithInteger:NSUnderlineStyleSingle] range:NSMakeRange(12, 6)]; // 下划线 label.attributedText = str; [self.view addSubview:label]; }
这句话的意思就是说,给 str 添加一个属性,这个属性的名字是 NSUnderlineStyleAttributeName,也就是下划线的类型。它的值是 NSInteger 类型的,默认是0,也就是没有下划线。范围是从第12个字开始,一共6个字。也就是 “用户服务条款”。
这里要注意。我们再来看一遍添加属性的方法原型:
- (void)addAttribute:(NSString *)name
value:(id)value range:(NSRange)range;
注意,参数 value 是 id 类型的。看到这句话,你知道我想说什么了吗?
id 是 Objective-C 对象。而 NSInteger 是基本数据类型,不是对象。所以必须写成 [NSNumber numberWithInteger:123] 的形式。
在设置这个值的时候,我不知道具体应该设为几,我尝试了好多数,但是发现竟然有的不对。后来百度了一下,才知道原来它的值有一个枚举:
typedef NS_ENUM(NSInteger, NSUnderlineStyle) { NSUnderlineStyleNone = 0x00, NSUnderlineStyleSingle = 0x01, NSUnderlineStyleThick NS_ENUM_AVAILABLE(10_0, 7_0) = 0x02, NSUnderlineStyleDouble NS_ENUM_AVAILABLE(10_0, 7_0) = 0x09, NSUnderlinePatternSolid NS_ENUM_AVAILABLE(10_0, 7_0) = 0x0000, NSUnderlinePatternDot NS_ENUM_AVAILABLE(10_0, 7_0) = 0x0100, NSUnderlinePatternDash NS_ENUM_AVAILABLE(10_0, 7_0) = 0x0200, NSUnderlinePatternDashDot NS_ENUM_AVAILABLE(10_0, 7_0) = 0x0300, NSUnderlinePatternDashDotDot NS_ENUM_AVAILABLE(10_0, 7_0) = 0x0400, NSUnderlineByWord NS_ENUM_AVAILABLE(10_0, 7_0) = 0x8000 } NS_ENUM_AVAILABLE(10_0, 6_0);
实际上,设置删除线 NSStrikethroughColorAttributeName 的时候,值也是这个枚举。
// NSUnderlineStyleNone 不设置下划线/删除线
// NSUnderlineStyleSingle 设置下划线/删除线为细的单线
// NSUnderlineStyleThick 设置下划线/删除线为粗的单线
// NSUnderlineStyleDouble 设置下划线/删除线为细的双线
// NSUnderlinePatternSolid 设置下划线/删除线样式为连续的实线
// NSUnderlinePatternDot 设置下划线/删除线样式为点,也就是虚线,比如这样:------
// NSUnderlinePatterDash 设置下划线/删除线样式为破折号,比如这样:—— —— ——
// NSUnderlinePatternDashDot 设置下划线/删除线样式为连续的破折号和点,比如这样:——-——-——-
// NSUnderlinePatternDashDotDot 设置下划线/删除线样式为连续的破折号、点、点,比如:——--——--——--
// NSUnderlineByWord 在有空格的地方不设置下划线/删除线
我为什么要把它们分成三段来说呢?因为它们属于三种,设置的时候不一定只有一种,可以同时设置其中的某两种或三种都设置。比如这样:
[str addAttribute:NSUnderlineStyleAttributeName value: [NSNumber numberWithInteger:NSUnderlineStyleDouble | NSUnderlinePatternDot] range:NSMakeRange(12, 6)];
这行代码就是给 “用户服务协议“ 加一个下划线,但是这回的下划线是两行的,并且是虚线。
实际上下划线的颜色也是可以设置的。如果没有设置的话,默认和文字颜色一样,也就是橙色。我们来尝试把下划线换成蓝色看看:
- (void)viewDidLoad { [super viewDidLoad]; UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(0, 100, ScreenWidth, 40)]; label.font = [UIFont systemFontOfSize:18]; // 字体大小 label.textAlignment = NSTextAlignmentCenter; // 文字对齐方式 NSMutableAttributedString *str = [[NSMutableAttributedString alloc] initWithString: @"点击下一步表示您已同意《用户服务协议》"]; [str addAttribute:NSForegroundColorAttributeName value: [UIColor colorWithRed:100/255.0 green:100/255.0 blue:100/255.0 alpha:1] range:NSMakeRange(0,11)]; [str addAttribute:NSForegroundColorAttributeName value: [UIColor colorWithRed:255/255.0 green:110/255.0 blue:17/255.0 alpha:1] range:NSMakeRange(11,8)]; [str addAttribute:NSUnderlineStyleAttributeName value: [NSNumber numberWithInteger:NSUnderlineStyleSingle] range:NSMakeRange(12, 6)]; // 下划线类型 [str addAttribute:NSUnderlineColorAttributeName value: [UIColor blueColor] range:NSMakeRange(12, 6)]; // 下划线颜色 label.attributedText = str; [self.view addSubview:label]; }
运行一下,结果如下图所示:
我们再举个栗子,添加一个加粗版的删除线,设置删除线的颜色为黑色(如果不设置颜色,也默认和文字颜色一样)
- (void)viewDidLoad { [super viewDidLoad]; UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(0, 100, ScreenWidth, 40)]; label.font = [UIFont systemFontOfSize:18]; // 字体大小 label.textAlignment = NSTextAlignmentCenter; // 文字对齐方式 NSMutableAttributedString *str = [[NSMutableAttributedString alloc] initWithString: @"点击下一步表示您已同意《用户服务协议》"]; [str addAttribute:NSForegroundColorAttributeName value: [UIColor colorWithRed:100/255.0 green:100/255.0 blue:100/255.0 alpha:1] range:NSMakeRange(0,11)]; [str addAttribute:NSForegroundColorAttributeName value: [UIColor colorWithRed:255/255.0 green:110/255.0 blue:17/255.0 alpha:1] range:NSMakeRange(11,8)]; [str addAttribute:NSUnderlineStyleAttributeName value: [NSNumber numberWithInteger:NSUnderlineStyleSingle] range:NSMakeRange(12, 6)]; // 下划线类型 [str addAttribute:NSUnderlineColorAttributeName value: [UIColor blueColor] range:NSMakeRange(12, 6)]; // 下划线颜色 [str addAttribute:NSStrikethroughStyleAttributeName value: [NSNumber numberWithInteger:NSUnderlineStyleThick] range:NSMakeRange(12, 6)]; // 删除线类型 [str addAttribute:NSStrikethroughColorAttributeName value: [UIColor blackColor] range:NSMakeRange(12, 6)]; // 删除线颜色 label.attributedText = str; [self.view addSubview:label]; }
然后运行一下来看看效果:
我们再举最后一个栗子(栗子说:能不能别举我了~),设置填充:
- (void)viewDidLoad { [super viewDidLoad]; UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(0, 100, ScreenWidth, 40)]; label.font = [UIFont systemFontOfSize:18]; // 字体大小 label.textAlignment = NSTextAlignmentCenter; // 文字对齐方式 NSMutableAttributedString *str = [[NSMutableAttributedString alloc] initWithString: @"点击下一步表示您已同意《用户服务协议》"]; [str addAttribute:NSForegroundColorAttributeName value: [UIColor colorWithRed:100/255.0 green:100/255.0 blue:100/255.0 alpha:1] range:NSMakeRange(0,11)]; [str addAttribute:NSForegroundColorAttributeName value: [UIColor colorWithRed:255/255.0 green:110/255.0 blue:17/255.0 alpha:1] range:NSMakeRange(11,8)]; [str addAttribute:NSStrokeWidthAttributeName value: [NSNumber numberWithFloat:3.0] range:NSMakeRange(11, 8)]; // 设置填充 label.attributedText = str; [self.view addSubview:label]; }
然后运行一下来看看效果:
同理,填充也可以设置颜色,如果不设置的话,默认和文字颜色一样。
NSMutableAttributedString 还能设置很多其它属性,比如段落格式、阴影等等(还有很多哦)
想要完整的学习它请参考苹果的官方文档:传送门
最后想说一下它的缺点,也许有的同学已经发现了,下划线离文字太近了!不能设置下划线和文字的距离,这是它美中不足的地方。