初探NSAttributedString和NSMutableAttributedString的使用

由於iOS7新出的NSTextStorge是NSMutableAttributedString的子類，所以要用好NSTextStorage，首先要學好NSMutableAttributedString和NSAttributedString。

按個人的理解，NSAttributedString是一個帶有屬性的字符串，通過該類可以靈活地操作和呈現多種樣式的文字數據。

因為是初步使用，所以基本上都是對照着文檔上的指導和介紹的方法來寫Demo。

首先是兩種類的初始化方法（基本上是相似的）：

 

 
            
            // initWithString:  
NSAttributedString *attributedString_str = [[NSAttributedString alloc] initWithString:@"attributedString"];  
NSLog(@"%@", attributedString_str);  
// textView.attributedText = attributedString_str;  
  
  
// initWithAttributedString:  
NSAttributedString *attributedString_atts = [[NSAttributedString alloc] initWithAttributedString:attributedString_str];  
NSLog(@"%@", attributedString_atts);  
// textView.attributedText = attributedString_atts;  
  
  
// initWithString:attributes:  
UIColor *backgroundColor = [UIColor blackColor];  
NSNumber *baseLineOffset = [NSNumber numberWithFloat:20.0];  
UIColor *foregroundColor = [UIColor whiteColor];  
NSNumber *kern = [NSNumber numberWithFloat:5.0];  
NSNumber *ligature = [NSNumber numberWithFloat:3.0];  
NSURL *linkURL = [NSURL URLWithString:@"http://www.baidu.com"];  
NSNumber *underline = [NSNumber numberWithInt:NSUnderlineStyleSingle];  
NSDictionary *attrsDic = @{NSForegroundColorAttributeName: foregroundColor,  
                           NSBackgroundColorAttributeName: backgroundColor,  
                           NSBaselineOffsetAttributeName: baseLineOffset,  
                           NSKernAttributeName: kern,  
                           NSLigatureAttributeName: ligature,  
                           NSLinkAttributeName: linkURL,  
                           NSUnderlineStyleAttributeName: underline  
                           };  
NSAttributedString *attributedString_str_atts = [[NSAttributedString alloc] initWithString:@"http://www.baidu.com" attributes:attrsDic];  
NSLog(@"%@", attributedString_str_atts);  
// textView.attributedText = attributedString_str_atts;  
  
  
// initWithFileURL:options:documentAttributes:error:  
NSURL *fileURL = nil;  
fileURL = [[NSBundle mainBundle] URLForResource:@"Dynamic Coloring" withExtension:@"rtf"];  
NSAttributedString *attributedString_fileURL = [[NSAttributedString alloc] initWithFileURL:fileURL options:@{} documentAttributes:nil error:nil];  
NSLog(@"%@", attributedString_fileURL);  
// textView.attributedText = attributedString_fileURL;  
  
  
// initWithData:options:documentAttributes:error:  
fileURL = nil;  
fileURL = [[NSBundle mainBundle] URLForResource:@"View Layout" withExtension:@"rtf"];  
NSData *data = [[NSData alloc] initWithContentsOfURL:fileURL];  
NSAttributedString *attributedString_data = [[NSAttributedString alloc] initWithData:data options:@{} documentAttributes:nil error:nil];  
NSLog(@"%@", attributedString_data);  
// textView.attributedText = attributedString_data;  
  
  
// initWithAttributedString:  
NSMutableAttributedString *mutableAttributedString_attrs = [[NSMutableAttributedString alloc] initWithAttributedString:attributedString_fileURL];

非常簡單。

 

 

由於NSAttributedString的屬性以字典的形式記錄，所以要弄清楚其中一些屬性對應的鍵值：

說說幾個自己使用上或者了解作用的。

NSBackgroundColorAttributeName：文字背景的顏色。

NSBaselineOffsetAttributeName：設置行距。

NSFontAttributeName：字體的樣式，必須設置NSFont作為Value，NSFont在iOS中不能使用，這個屬性的設置上我還不會。

NSForegroundColorAttributeName：文字顏色。

NSUnderlineStyleAttributeName：為文字添加下划線。必須設置NSNumber對象為Value。如：

 

NSNumber *underline = [NSNumber numberWithInt:NSUnderlineStyleSingle];

 

以上attribute在NSAttributedString和NSMutableAttributedString對象創建時可以設定，不同的是NSAttributedString對象在創建成功后其屬性便不可改變，而NSMutableAttributedString的屬性是可以改變的。如下所示：

 

 
            
            // Change NSMutableAttributedString  
[mutableAttributedString_attrs beginEditing];  
/* 
// addAttributes:range: 
[mutableAttributedString_attrs addAttributes:@{NSLinkAttributeName: @"www.baidu.com", 
                                               NSBackgroundColorAttributeName: [UIColor greenColor], 
                                               NSUnderlineStyleAttributeName: [NSNumber numberWithInt:NSUnderlineStyleDouble] 
                                               } 
                                       range:NSMakeRange(0, [attributedString_fileURL length])]; */  
// addAttribute:value:range:  
[mutableAttributedString_attrs addAttribute:NSUnderlineStyleAttributeName value:[NSNumber numberWithInt:NSUnderlineStyleThick] range:NSMakeRange(0, 10)];  
[mutableAttributedString_attrs addAttribute:NSBaselineOffsetAttributeName value:[NSNumber numberWithFloat:20.0] range:NSMakeRange(20, 100)];  
[mutableAttributedString_attrs endEditing];  
NSLog(@"%@", mutableAttributedString_attrs);

在修改文字屬性的開頭和結尾要分別調用beginEditing和endEditing方法，這些方法可以在文字屬性發生變化時發送消息給事件監聽者。

可以為某個范圍內的文字單個地添加屬性key-value對，也可以添加一個屬性字典。
注意到在控制台輸出NSAttributedString或NSMutableAttributedString時，輸出的不僅是字符內容，還有對應的屬性值：

 

 
            
            2013-08-11 16:40:44.737 AttributedString_i7_Demo[43468:a0b] http://www.baidu.com{  
    NSBackgroundColor = "UIDeviceWhiteColorSpace 0 1";  
    NSBaselineOffset = 20;  
    NSColor = "UIDeviceWhiteColorSpace 1 1";  
    NSKern = 5;  
    NSLigature = 3;  
    NSLink = "http://www.baidu.com";  
    NSUnderline = 1;  
}

 

 

也可以獲取某一段文字的屬性：

 

 
            
            // get attribute  
NSRange range = NSMakeRange(0, mutableAttributedString_attrs.length);  
// attributesAtIndex:effectiveRange:  
NSDictionary *dic = [mutableAttributedString_attrs attributesAtIndex:0 effectiveRange:&range];  
NSLog(@"%@", [dic objectForKey:NSFontAttributeName]);

如果要將NSMutableAttributedString對象賦值給NSAttributedString時，要使用copy方法：

 
            
            textView.attributedText = [mutableAttributedString_attrs copy];  
            以上是對NSAttributedString和NSMutableAttributedString最基本的使用（主要還是NSAttributedString），為了強化作為NSMutableAttributedString的子類NSTextStorage處理文本的能力，明顯在這兩個類中增加了許多新的成員，如NSTextAttachment，在這里沒有用上，必須繼續深入學習。