您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

iOS 富文本深入解析:NSAttributedString 全屬性指南

編輯:iOS 相關資訊

問題起源

在開發中我曾遇到這樣一個需求:用 UITextView 顯示一段字數眾多的電影簡介,因為文字太多而將字體設得很小,行距與段距也一并縮小,結果一大段文字擠成一團,閱讀起來相當別扭。想加大行距時,卻發現 UITextView 竟然沒有調整行距的介面。上網一查才發現,iOS 的文字排版能力其實非常強大,過去的自己可謂孤陋寡聞。

文字顯示的三種基礎控制項

在 iOS(或 Mac OS X)中,要將字串繪製到螢幕上,通常是透過 UIKit(Mac 為 AppKit)框架中的控制項完成。常用來顯示字串的控制項有三個:

  • UILabel
  • UITextField
  • UITextView

然而這些控制項對文本的呈現方式相對單一,通常只能控制字體樣式、大小、顏色、粗體、斜體等,而對行距、字距、段落等高階排版功能則力有未逮。

CoreText 與 TextKit

說到進階排版,就不得不提功能強大的 CoreText.framework。它是 iOS 3.2+ 與 OS X 10.5+ 上能對文字格式與版面進行精細控制的文字引擎,良好地結合了 UIKit 與 Core Graphics/Quartz:UIKit 的 UILabel 讓你能透過拖曳輕易加入文字,卻無法細微調整;Core Graphics/Quartz 幾乎無所不能,但需要自行計算每個字形的位置。CoreText 正好結合兩者,讓你能完全控制位置、版面、字級、顏色等屬性,其餘如換行、字體呈現則交給它處理。

不過 CoreText 本身龐大、學習成本高,一般非特殊需求很少直接使用。隨著 iOS 6 的推出,UILabel、UITextField、UITextView 都加入了對 AttributedString 的支援,使得行距、字距、段落控制不必再動用複雜的 CoreText。而 iOS 7 更引入了 TextKit——一套快速而現代化的文字排版與渲染引擎,它並未新增類別,而是在既有控制項上進行封裝,可直接在熟悉的控制項中使用。

NSAttributedString 基礎

與 NSString 類似,AttributedString 分為 NSAttributedString 與 NSMutableAttributedString。不同的是,它多了一個 Attribute(屬性)的概念:每個屬性都有其對應的文字範圍,以 NSRange 描述。

建立方式一:逐段新增屬性

適合文字較少但需要分段精細控制的情況:

NSString *originStr = @"Hello,中秋節!";

NSMutableAttributedString *attributedStr01 = [[NSMutableAttributedString alloc] initWithString:originStr];

// 為所有字元設定字體為 Zapfino、字級 15
[attributedStr01 addAttribute:NSFontAttributeName
                        value:[UIFont fontWithName:@"Zapfino" size:15]
                        range:NSMakeRange(0, originStr.length)];

// 前 4 個字元設為藍色
[attributedStr01 addAttribute:NSForegroundColorAttributeName
                        value:[UIColor blueColor]
                        range:NSMakeRange(0, 4)];

// 第 5、6、7 個字元設為紅色
[attributedStr01 addAttribute:NSForegroundColorAttributeName
                        value:[UIColor redColor]
                        range:NSMakeRange(4, 3)];

_label01.attributedText = attributedStr01;

建立方式二:屬性字典整體套用

適合文字較多、需整體控制的情況(例如從檔案讀取的大段文字):

NSDictionary *attrDict = @{
    NSFontAttributeName: [UIFont fontWithName:@"Zapfino" size:15],
    NSForegroundColorAttributeName: [UIColor blueColor]
};

_label02.attributedText = [[NSAttributedString alloc] initWithString:originStr attributes:attrDict];

方式二也可透過分段處理達到方式一的效果,做法是將文字切段後各自建立 NSAttributedString,再用 appendAttributedString: 合併即可。

可設定的 21 種屬性

NSAttributedString 支援的屬性相當豐富,以下列舉常用的幾種:

  • NSFontAttributeName:字體,預設 Helvetica(Neue)、12 號。
  • NSForegroundColorAttributeName:文字顏色,預設黑色。
  • NSBackgroundColorAttributeName:文字區域背景色,預設 nil(透明)。
  • NSLigatureAttributeName:連體字屬性,0 表示無連體,1 使用預設連體(iOS 不支援 2)。
  • NSKernAttributeName:字元間距,正值加寬、負值變窄。
  • NSStrikethroughStyleAttributeName:刪除線樣式。
  • NSStrikethroughColorAttributeName:刪除線顏色,預設黑色。
  • NSUnderlineStyleAttributeName:底線樣式,與刪除線類似。
  • NSUnderlineColorAttributeName:底線顏色,預設黑色。
  • NSStrokeWidthAttributeName:筆畫寬度,負值為填滿效果、正值為中空效果。
  • NSStrokeColorAttributeName:筆畫(描邊)顏色,非文字顏色。
  • NSShadowAttributeName:陰影,取值為 NSShadow 物件。
  • NSTextEffectAttributeName:特殊文字效果(如圖版印刷效果)。
  • NSBaselineOffsetAttributeName:基線偏移,正值上偏、負值下偏。
  • NSObliquenessAttributeName:字形傾斜度,正值右傾、負值左傾。
  • NSExpansionAttributeName:文字橫向拉伸,正值拉伸、負值壓縮。
  • NSWritingDirectionAttributeName:文字書寫方向(由左至右或由右至左)。
  • NSVerticalGlyphFormAttributeName:排版方向,0 為橫排、1 為直排。
  • NSLinkAttributeName:超連結,點擊後開啟指定 URL。
  • NSAttachmentAttributeName:文字附件,常用於圖文混排。
  • NSParagraphStyleAttributeName:段落排版格式,取值為 NSParagraphStyle 物件。

幾個實作上的重點提醒

在實際操作時,有幾個容易踩雷的地方值得注意:

  • NSForegroundColor 與 textColor:兩者在地位上相等,誰最後被賦值,畫面顯示的就是誰的顏色。
  • NSForegroundColor 與 NSBackgroundColor:兩者的地位也相等,同樣是後賦值者覆蓋前者;但 textColor 屬性可以與 NSBackgroundColorAttributeName 疊加顯示。
  • 刪除線與底線的樣式值:雖使用列舉常量,但本質仍是整數,必須先轉為 NSNumber 才能使用。目前 iOS 實際只有 4 種效果可用(不設線、細單線、粗單線、細雙線);此外取其他整數值也能產生不同粗細的單/雙實線,有興趣可自行嘗試。
  • 觀察會發現,中文與英文的刪除線位置略有不同,這是正常的排版差異。

結論上,無論是 CoreText 還是 TextKit 都是龐大的體系,而本文聚焦的 NSAttributedString 已足以應付絕大多數日常排版需求。真正需要將文字直接渲染到圖形上下文時,再深入研究 CoreText 或 TextKit 也不遲。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved