iOS-NSAttributedString/NSMutableAttributedString(富文本常用封装)

NSAttributedString,NSMutableAttributedString是带属性的特殊字符串。
NSMutableParagraphStyle是带属性的文本段落属性,用于控制段落有关属性(行间距,文本缩进等等)。

1、NSAttributedString

//设置字体属性,默认值:字体:Helvetica(Neue) 字号:12
NSFontAttributeName 
//设置字体颜色,取值为 UIColor对象,默认值为黑色               
NSForegroundColorAttributeNam   
// 设置字体所在区域背景颜色,取值为 UIColor对象,默认值为nil, 透明色   
NSBackgroundColorAttributeName    
//设置连体属性,取值为NSNumber 对象(整数),0 表示没有连体字符,1 表示使用默认的连体字符
NSLigatureAttributeName 
//设定字符间距,取值为 NSNumber 对象(整数),正值间距加宽,负值间距变窄        
NSKernAttributeName   
// 设置删除线,取值为 NSNumber 对象(整数)             
NSStrikethroughStyleAttributeName 
//设置删除线颜色,取值为 UIColor 对象,默认值为黑色
NSStrikethroughColorAttributeName 
//设置下划线,取值为 NSNumber 对象(整数),枚举常量 NSUnderlineStyle中的值,与删除线类似 
NSUnderlineStyleAttributeName  
//设置下划线颜色,取值为 UIColor 对象,默认值为黑色    
NSUnderlineColorAttributeName  
//设置笔画宽度,取值为 NSNumber 对象(整数),负值填充效果,正值中空效果    
NSStrokeWidthAttributeName   
//填充部分颜色,不是字体颜色,取值为 UIColor 对象      
NSStrokeColorAttributeName  
//设置阴影属性,取值为 NSShadow 对象       
NSShadowAttributeName
//设置文本特殊效果,取值为 NSString 对象,目前只有图版印刷效果可用:              
NSTextEffectAttributeName 
//设置基线偏移值,取值为 NSNumber (float),正值上偏,负值下偏         
NSBaselineOffsetAttributeName  
//设置字形倾斜度,取值为 NSNumber (float),正值右倾,负值左倾    
NSObliquenessAttributeName 
//设置文本横向拉伸属性,取值为 NSNumber (float),正值横向拉伸文本,负值横向压缩文本        
NSExpansionAttributeName      
//设置文字书写方向,从左向右书写或者从右向左书写     
NSWritingDirectionAttributeName
//设置文字排版方向,取值为 NSNumber 对象(整数),0 表示横排文本,1 表示竖排文本    
NSVerticalGlyphFormAttributeName  
//  设置链接属性,点击后调用浏览器打开指定URL地址 
NSLinkAttributeName     
//设置文本附件,取值为NSTextAttachment对象,常用于文字图片混排         
NSAttachmentAttributeName  
//设置文本段落排版格式,取值为 NSParagraphStyle 对象        
NSParagraphStyleAttributeName      

不可变属性字符串,创建出来之后不能修改其属性(属性都是只读的),但是可以在创建的时候直接附加属性设置(属性是针对所有文本),其属性介绍以及用法,直接在代码上标注如下:

UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(0, 100,CGRectGetWidth(self.view.frame), 300)];   
label.numberOfLines = 0;   
[self.view addSubview:label];    
label.backgroundColor = [UIColor lightGrayColor];

NSString *string = @"今日头条是一款基于数据挖掘的推荐引擎产品,它为用户推荐有价值的、个性化的信息,提供连接人与信息的新型服务,是国内移动互联网领域成长最快的产品服务之一。";

NSMutableDictionary *dict = [NSMutableDictionary dictionary];
// UIColor,文本前景颜色,默认是blackColor
dict[NSForegroundColorAttributeName] = [UIColor redColor];
// UIColor,文本背景颜色(不是控件View的背景颜色),默认nil 
dict[NSBackgroundColorAttributeName] = [UIColor yellowColor];
// UIFont,文本字体大小,默认 Helvetica(Neue) 12
 dict[NSFontAttributeName] = [UIFont systemFontOfSize:20];

// 文本段落样式(详细段落样式见下方)
NSMutableParagraphStyle *paragraphStyle = [[NSMutableParagraphStyle alloc]init];
 // 段落行距
 paragraphStyle.lineSpacing = 10;                    
// NSParagraphStyle,文本段落样式
dict[NSParagraphStyleAttributeName] = paragraphStyle;    

/*//删除线和下划线

枚举常量 NSUnderlineStyle中的值
NSUnderlineStyleNone        //不设置删除线
NSUnderlineStyleSingle      // 设置删除线为细单实线
NSUnderlineStyleThick       //   设置删除线为粗单实线
NSUnderlineStyleDouble    // 设置删除线为细双实线
NSUnderlinePatternSolid   
NSUnderlinePatternDot     //点
NSUnderlinePatternDash  //虚线
NSUnderlinePatternDashDot  //虚线和点
NSUnderlinePatternDashDotDot  //虚线和点点
NSUnderlineByWord 
*/
   // NSNumber,加删除线,默认不加删除线,其它的话是加不同风格的删除线
    dict[NSStrikethroughStyleAttributeName] = @(NSUnderlinePatternSolid | NSUnderlineStyleSingle);   
    // UIColor,删除线颜色,默认等于文本前景颜色,前提是需要加删除线,和NSStrikethroughStyleAttributeName有关  
    dict[NSStrikethroughColorAttributeName] = [UIColor yellowColor];   
    // NSNumber,加下划线,默认NSUnderlineStyleNone不加下划线,其它的话是加不同的下划线       
    dict[NSUnderlineStyleAttributeName] = @(NSUnderlineStyleDouble);   
    // UIColor,下划线颜色,默认等于文本前景颜色,前提是需要加下划线,和       
    dict[NSUnderlineColorAttributeName] = [UIColor yellowColor];              NSUnderlineStyleAttributeName有关
     // UIColor,默认等于文本前景颜色,需要和NSStrokeWidthAttributeName一起使用
    dict[NSStrokeColorAttributeName] = [UIColor yellowColor];    
    // NSNumber,使文本有一种中空的效果(有立体效果)数字越大,文本填充的越满,数字越小,文本颜色越淡,不需要和NSStrokeColorAttributeName一起使用            
    dict[NSStrokeWidthAttributeName] = @5;                                    

    //文本阴影
     NSShadow *shadow = [[NSShadow alloc] init];
     shadow.shadowOffset = CGSizeMake(2, 3);      //阴影偏移量
     shadow.shadowColor = [UIColor yellowColor];  //阴影颜色
     shadow.shadowBlurRadius = 1.0;               //阴影圆角
     
    // NSShadow,默认没有阴影,
    dict[NSShadowAttributeName] = shadow;  
     // NSNumber,文本字间距(字与字之间的距离)
    dict[NSKernAttributeName] = @10;
    // NSURL或者是链接字符串,文本链接样式,自带下划线,文本颜色是蓝色
    dict[NSLinkAttributeName] = [NSURL URLWithString:@"http:baidu.com"];  
    // NSURL或者是链接字符串,文本链接样式,自带下划线,文本颜色是蓝色   
    dict[NSLinkAttributeName] = @"http:baidu.com"; 
    // NSNumber,本文的扩张倍数,负数的话相当于缩小
    dict[NSExpansionAttributeName] = @(-0.5);
    // NSNumber,本文的斜体程度以及斜体方向,默认0不歪斜,负数相当于右斜,正数相当于左斜,歪斜的程度由数字的大小决定  
    dict[NSObliquenessAttributeName] = @(0.7); 
    // NSNumber,行文本基线的偏移量
    dict[NSBaselineOffsetAttributeName] = @(15.0);  
    // 貌似是文本写入方向
    dict[NSWritingDirectionAttributeName] = @[@(NSWritingDirectionOverride),@(NSWritingDirectionRightToLeft)]; 
    // 文本的垂直与水平,它总是水平,任何其他值的行为是未定义的
    dict[NSVerticalGlyphFormAttributeName] = @(1); 

    NSTextAttachment *textAtt = [[NSTextAttachment alloc] init];
    textAtt.image = [UIImage imageNamed:@"cloud.png"];
    // 在文本中插入表情
    dict[NSAttachmentAttributeName] = textAtt; 

    label.attributedText = [[NSAttributedString alloc] initWithString:string attributes:dict];

2、NSMutableAttributedString

可变属性字符串,创建出来之后可修改其属性,也可以给文本在某一个范围内添加单个属性或者字典属性(一次性添加很多属性),比如一个属性字符串不同范围的颜色不一样,其属性介绍以及用法,直接在代码上标注如下:

     UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(0, 100,CGRectGetWidth(self.view.frame), 300)];   
     label.numberOfLines = 0;   
     [self.view addSubview:label];   
     label.backgroundColor = [UIColor lightGrayColor];        
    NSString *string = @"今日头条是一款基于数据挖掘的推荐引擎产品,它为用户推荐有价值的、个性化的信息,提供连接人与信息的新型服务,是国内移动互联网领域成长最快的产品服务之一。";       
    NSMutableAttributedString *attributedString = [[NSMutableAttributedString alloc]initWithString:string];    
    NSMutableParagraphStyle *paragraphStyle = [[NSMutableParagraphStyle alloc]init];    
    [paragraphStyle setLineSpacing:10];        
    [attributedString addAttribute:NSParagraphStyleAttributeName value:paragraphStyle range:NSMakeRange(0, string.length)];    
    //    [attributedString addAttributes:<#(nonnull NSDictionary *)#> range:<#(NSRange)#>]; 
    // 添加字典属性   
     [attributedString addAttribute:NSForegroundColorAttributeName value:[UIColor redColor] range:NSMakeRange(0, 10)];        
    label.attributedText = attributedString;

3、NSMutableParagraphStyle

NSMutableParagraphStyle用于设定文本段落有关设置,比如行间距,文本缩进,段间距等等,其用法如下:

    UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(0, 100, CGRectGetWidth(self.view.frame), 300)];    
    label.numberOfLines = 0;    
    [self.view addSubview:label];   
    label.backgroundColor = [UIColor lightGrayColor];        
    NSString *string = @"今日头条是一款基于数据挖掘的推荐引擎产品,它为用户推荐有价值的、个性化的信息,提供连接人与信息的新型服务,是国内移动互联网领域成长最快的产品服务之一。";   
     // 文本段落样式     
    NSMutableParagraphStyle *paragraphStyle = [[NSMutableParagraphStyle alloc]init]; 
    // 段落行距   
    paragraphStyle.lineSpacing = 10; 
    // 非首行文本缩进                                 
    paragraphStyle.headIndent = 5;
    // 文本缩进(右端)                           
    paragraphStyle.tailIndent = -20;                       
    // 首行文本缩进    
    paragraphStyle.firstLineHeadIndent = 20;
    // 文本对齐方式                  
    paragraphStyle.alignment = NSTextAlignmentRight;  
    // 折行方式                     
    paragraphStyle.lineBreakMode = NSLineBreakByWordWrapping;  
    // 文本写入方式 
    paragraphStyle.baseWritingDirection = NSWritingDirectionLeftToRight;  
    // 文本行间距是默认行间距的多少倍    
   paragraphStyle.lineHeightMultiple = 3.0;             
    // 文本最大行距
   paragraphStyle.maximumLineHeight = 50;
   // 文本最小行距                     
  paragraphStyle.minimumLineHeight = 50; 
  // 目前还不知道有什么作用
  paragraphStyle.allowsDefaultTighteningForTruncation = YES; 
  // 设置每行的最后单词是否截断,在0.0-1.0之间,默认为0.0,越接近1.0单词被截断的可能性越大        
  paragraphStyle.hyphenationFactor = 1.0; 
  // 段落后面的间距           
  paragraphStyle.paragraphSpacing = 10;
  //设置段与段之间的距离
  paragraphStyle.paragraphSpacingBefore = 20;
   // NSParagraphStyle,文本段落样式
  dict[NSParagraphStyleAttributeName] = paragraphStyle;  
  label.attributedText = [[NSAttributedString alloc] initWithString:string attributes:dict];

属性字符串基本上就那么多内容,只不过需要在应用中灵活运用而已。

<1> 计算行高和设置行距

-(void)getSpaceLabelHeight:(NSString *)str withFont:(UIFont *)font withWidth:(CGFloat)width {
    NSMutableParagraphStyle *paraStyle = [[NSMutableParagraphStyle alloc] init];
    paraStyle.lineBreakMode = NSLineBreakByCharWrapping;
    paraStyle.alignment = NSTextAlignmentLeft;
    paraStyle.lineSpacing = 6;
    paraStyle.hyphenationFactor = 0.0;
    paraStyle.firstLineHeadIndent = 0.0;
    paraStyle.paragraphSpacingBefore = 0.0;
    paraStyle.headIndent = 0;
    paraStyle.tailIndent = 0;
//    NSDictionary *dic = @{NSFontAttributeName:font, NSParagraphStyleAttributeName:paraStyle, NSKernAttributeName:@1.5f};
    NSDictionary *dic = @{NSFontAttributeName:font, NSParagraphStyleAttributeName:paraStyle};
    NSAttributedString *attributeStr = [[NSAttributedString alloc] initWithString:str attributes:dic];
    CGSize size = [str boundingRectWithSize:CGSizeMake(width, 400) options:NSStringDrawingUsesLineFragmentOrigin attributes:dic context:nil].size;
    NSArray *arr = @[attributeStr,[NSNumber numberWithFloat:size.height]];
    [textHeightArr addObject:arr];
}

<2>几行文字不同间距和颜色

        alertLabel.text = infoString;
        //label设置行间距、高度和宽度自适应内容
        NSMutableAttributedString * attributedString1 = [[NSMutableAttributedString alloc] initWithString:infoString];
        [attributedString1 setAttributes:@{NSFontAttributeName:[UIFont systemFontOfSize:12],
                                           NSForegroundColorAttributeName:[UIColor colorWithHexString_Ext:@"#666666"]} range:NSMakeRange(0,str.length)];
        NSMutableParagraphStyle * paragraphStyle1 = [[NSMutableParagraphStyle alloc] init];
        paragraphStyle1.alignment = NSTextAlignmentCenter;
        [paragraphStyle1 setLineSpacing:14];
        [attributedString1 addAttribute:NSParagraphStyleAttributeName value:paragraphStyle1 range:NSMakeRange(0, [alertLabel.text length])];
        [alertLabel setAttributedText:attributedString1];
        [alertLabel sizeToFit];
        
        alertLabel.width = alertView.width - 2*alertLabel.origin_x;
        
//        alertView.height = alertLabel.toTopMargin+15*heightRates+40+20;
//        
//        cancelBtn.origin_y = alertLabel.toTopMargin+15*heightRates+20;
        alertView.height = alertLabel.toTopMargin+14+42;
        
        cancelBtn.origin_y = alertLabel.toTopMargin+14;
        cancelBtn.height = 42;
        sureBtn.origin_y = cancelBtn.origin_y;
        sureBtn.height = 42;
        
        //设置取消按钮左下角圆角
        [self setButtonLayerCornerRadius:cancelBtn rectCorner:UIRectCornerBottomLeft];
        //设置确定按钮右下角圆角
        [self setButtonLayerCornerRadius:sureBtn rectCorner:UIRectCornerBottomRight];

4.常用需求封装

需求:在我们日常开发中,某些句子中会有改变某些字颜色的需求,当然颜色一般而言就是为了着重强调,常为同一种颜色,所以下面代码是单纯改变一句话中的某些字的颜色

/**
 *  单纯改变一句话中的某些字的颜色
 *
 *  @param color    需要改变成的颜色
 *  @param totalStr 总的字符串
 *  @param subArray 需要改变颜色的文字数组
 *
 *  @return 生成的富文本
 */
+ (NSMutableAttributedString *)ls_changeCorlorWithColor:(UIColor *)color TotalString:(NSString *)totalStr SubStringArray:(NSArray *)subArray {
    NSMutableAttributedString *attributedStr = [[NSMutableAttributedString alloc] initWithString:totalStr];
    for (NSString *rangeStr in subArray) {
        NSRange range = [totalStr rangeOfString:rangeStr options:NSBackwardsSearch];
        [attributedStr addAttribute:NSForegroundColorAttributeName value:color range:range];
    }
    return attributedStr;
}

需求:需要更改字间距来适应整体UI

/**
 *  单纯改变句子的字间距(需要 )
 *
 *  @param totalString 需要更改的字符串
 *  @param space       字间距
 *
 *  @return 生成的富文本
 */
+ (NSMutableAttributedString *)ls_changeSpaceWithTotalString:(NSString *)totalString Space:(CGFloat)space {
    NSMutableAttributedString *attributedStr = [[NSMutableAttributedString alloc] initWithString:totalString];
    long number = space;
    CFNumberRef num = CFNumberCreate(kCFAllocatorDefault,kCFNumberSInt8Type,&number);
    [attributedStr addAttribute:(id)kCTKernAttributeName value:(__bridge id)num range:NSMakeRange(0,[attributedStr length])];
    CFRelease(num);
    return attributedStr;
}

需求:同时更改行间距和字间距

/**
 *  同时更改行间距和字间距
 *
 *  @param totalString 需要改变的字符串
 *  @param lineSpace   行间距
 *  @param textSpace   字间距
 *
 *  @return 生成的富文本
 */
+ (NSMutableAttributedString *)ls_changeLineAndTextSpaceWithTotalString:(NSString *)totalString LineSpace:(CGFloat)lineSpace textSpace:(CGFloat)textSpace {
    NSMutableAttributedString *attributedStr = [[NSMutableAttributedString alloc] initWithString:totalString];
    NSMutableParagraphStyle * paragraphStyle = [[NSMutableParagraphStyle alloc] init];
    [paragraphStyle setLineSpacing:lineSpace];
    [attributedStr addAttribute:NSParagraphStyleAttributeName value:paragraphStyle range:NSMakeRange(0, [totalString length])];
    long number = textSpace;
    CFNumberRef num = CFNumberCreate(kCFAllocatorDefault,kCFNumberSInt8Type,&number);
    [attributedStr addAttribute:(id)kCTKernAttributeName value:(__bridge id)num range:NSMakeRange(0,[attributedStr length])];
    CFRelease(num);
    return attributedStr;
}

需求:更改某些文字的颜色并修改其字体,突出重点强调

/**
 *  改变某些文字的颜色 并单独设置其字体
 *
 *  @param font        设置的字体
 *  @param color       颜色
 *  @param totalString 总的字符串
 *  @param subArray    想要变色的字符数组
 *
 *  @return 生成的富文本
 */
+ (NSMutableAttributedString *)ls_changeFontAndColor:(UIFont *)font Color:(UIColor *)color TotalString:(NSString *)totalString SubStringArray:(NSArray *)subArray {
    NSMutableAttributedString *attributedStr = [[NSMutableAttributedString alloc] initWithString:totalString];
    for (NSString *rangeStr in subArray) {
        NSRange range = [totalString rangeOfString:rangeStr options:NSBackwardsSearch];
        [attributedStr addAttribute:NSForegroundColorAttributeName value:color range:range];
        [attributedStr addAttribute:NSFontAttributeName value:font range:range];
    }
    return attributedStr;
}

你可能感兴趣的:(iOS-NSAttributedString/NSMutableAttributedString(富文本常用封装))