每次需要特殊設(shè)置文本的attribute屬性時(shí),都要查很多資料,其中有些常用的key值有時(shí)不會(huì)那么準(zhǔn)確的記住,所以花點(diǎn)時(shí)間整理了一下;
使用下面這首古詩(shī)作為例子吧:
朝辭白帝彩云間,
千里江陵一日還。
兩岸猿聲啼不盡,
輕舟已過(guò)萬(wàn)重山。
直接顯示這首古詩(shī)的時(shí)候,結(jié)果是這樣的:
NSString *string = @"朝辭白帝彩云間,\n千里江陵一日還。\n兩岸猿聲啼不盡,\n輕舟已過(guò)萬(wàn)重山";
self.label.text = string;
下面,我們就一點(diǎn)點(diǎn)的添加文本的屬性:
首先,創(chuàng)建一個(gè)NSMutableAttributedString:
NSString *string = @"朝辭白帝彩云間,\n千里江陵一日還。\n兩岸猿聲啼不盡,\n輕舟已過(guò)萬(wàn)重山";
NSMutableAttributedString *mString = [[NSMutableAttributedString alloc]initWithString:string];
NSRange range = [string rangeOfString:@"\n兩岸猿聲啼不盡,\n輕舟已過(guò)萬(wàn)重山"];
這里的NSRange在下面的設(shè)置屬性的時(shí)候要用到,就是你需要特殊添加屬性的字符串,當(dāng)然,這個(gè)字符串需要包含在整個(gè)字符串string里的;當(dāng)然,如果你需要為整個(gè)字符串添加屬性,就不需要這個(gè)屬性了,可以在創(chuàng)建添加屬性:
- (instancetype)initWithString:(NSString *)str attributes:(nullable NSDictionary<NSString *, id> *)attires;
1. NSKernAttributeName(字間距)
調(diào)整字間距:
[mString addAttribute:NSKernAttributeName value:@10 range:range];
這里的value值是NSNumber類型的
2. NSFontAttributeName(字體)
設(shè)置字體:
[mString addAttribute:NSFontAttributeName value:[UIFont systemFontOfSize:22] range:range];
這里的value值是UIFont對(duì)象
3. NSForegroundColorAttributeName(文本顏色)
設(shè)置文本顏色:
[mString addAttribute:NSForegroundColorAttributeName value:[UIColor redColor] range:range];
value:UIColor對(duì)象
4. NSParagraphStyleAttributeName(段落樣式)
設(shè)置段落樣式:
NSMutableParagraphStyle *style = [[NSMutableParagraphStyle alloc]init];
style.alignment = NSTextAlignmentCenter;
style.lineSpacing = 20;
[mString addAttribute:NSParagraphStyleAttributeName value:style range:range];
value: NSMutableParagraphStyle對(duì)象
5. NSBackgroundColorAttributeName(文本背景色)
設(shè)置文本背景色:
[mString addAttribute:NSBackgroundColorAttributeName value:[UIColor greenColor] range:range];
value:UIColor對(duì)象
6. NSStrokeColorAttributeName(描邊顏色)
設(shè)置文本描邊顏色,需要和NSStrokeWidthAttributeName設(shè)置描邊寬度,這樣就能使文字空心.
NSStrokeWidthAttributeName這個(gè)屬性所對(duì)應(yīng)的值是一個(gè) NSNumber 對(duì)象(小數(shù))。該值改變描邊寬度(相對(duì)于字體size 的百分比)。默認(rèn)為 0,即不改變。正數(shù)只改變描邊寬度。負(fù)數(shù)同時(shí)改變文字的描邊和填充寬度。例如,對(duì)于常見(jiàn)的空心字,這個(gè)值通常為3.0。
同時(shí)設(shè)置了空心的兩個(gè)屬性,并且NSStrokeWidthAttributeName屬性設(shè)置為整數(shù),文字前景色(NSForegroundColorAttributeName)就無(wú)效果了
[mString addAttribute:NSStrokeColorAttributeName value:[UIColor greenColor] range:range];
[mString addAttribute:NSStrokeWidthAttributeName value:@3 range:range];
如果數(shù)值設(shè)置為負(fù)數(shù),就沒(méi)有空心字的效果:
[mString addAttribute:NSStrokeColorAttributeName value:[UIColor greenColor] range:range];
[mString addAttribute:NSStrokeWidthAttributeName value:@(-3) range:range];
7. NSStrikethroughStyleAttributeName(刪除線)
添加刪除線
[mString addAttribute:NSStrikethroughStyleAttributeName value:@(NSUnderlineStyleSingle) range:range];
value:線的類型NSUnderlineStyle
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);
8. NSUnderlineStyleAttributeName(下劃線)
添加下劃線:
[mString addAttribute:NSUnderlineStyleAttributeName value:@(NSUnderlineStyleSingle) range:range];
value:線的類型NSUnderlineStyle
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);
9. NSShadowAttributeName(陰影)
設(shè)置陰影
NSShadow *shadow = [[NSShadow alloc]init];
shadow.shadowBlurRadius = 5;//設(shè)置模糊度
shadow.shadowColor = [UIColor blueColor];//設(shè)置陰影顏色
shadow.shadowOffset = CGSizeMake(1, 3);//設(shè)置陰影的偏移量
[mString addAttribute:NSShadowAttributeName value:shadow range:range];
一般與:
NSVerticalGlyphFormAttributeName,NSObliquenessAttributeName,
NSExpansionAttributeName結(jié)合使用
10. NSVerticalGlyphFormAttributeName(排版方式)
文本排版方式
該屬性所對(duì)應(yīng)的值是一個(gè) NSNumber 對(duì)象(整數(shù))。
0 表示橫排文本。
1 表示豎排文本。
在 iOS 中,總是使用橫排文本,0 以外的值都未定義,即其他值無(wú)效果。
NSShadow *shadow = [[NSShadow alloc]init];
shadow.shadowBlurRadius = 5;//設(shè)置模糊度
shadow.shadowColor = [UIColor blueColor];//設(shè)置陰影顏色
shadow.shadowOffset = CGSizeMake(1, 3);//設(shè)置陰影的偏移量
[mString addAttribute:NSShadowAttributeName value:shadow range:range];
[mString addAttribute:NSVerticalGlyphFormAttributeName value:@(0) range:range];
11. NSObliquenessAttributeName (斜體)
設(shè)置文本斜體
NSShadow *shadow = [[NSShadow alloc]init];
shadow.shadowBlurRadius = 5;//設(shè)置模糊度
shadow.shadowColor = [UIColor blueColor];//設(shè)置陰影顏色
shadow.shadowOffset = CGSizeMake(1, 3);//設(shè)置陰影的偏移量
[mString addAttribute:NSShadowAttributeName value:shadow range:range];
[mString addAttribute:NSObliquenessAttributeName value:@(1) range:range];
12. NSExpansionAttributeName(扁平化)
設(shè)置文本扁平化
[mString addAttribute:NSExpansionAttributeName value:@(1) range:range];
總結(jié):
以上便是常用的文本設(shè)置,以備使用時(shí)查找;
如有不正確的地方,還請(qǐng)指正;
下面,就開(kāi)始為你的文本添加豐富的attributes吧!!!