DTCoreText 是 iOS 上一套強大的 HTML 排版引擎,其中 DTHTMLAttributedStringBuilder 負責把 HTML 資料轉換為 NSAttributedString。以下整理它的初始化方法與可用的參數選項,方便日後查閱。
這個方法會從指定的 HTML 物件與基底網址,初始化並回傳一個新的 NSAttributedString 物件。
可用的 Options 參數
- DTMaxImageSize:文字附件所能填滿的最大 CGSize。
- DTDefaultFontFamily:預設字型家族,取代 Times New Roman。
- DTDefaultFontSize:預設字級,取代 12。
- DTDefaultTextColor:預設文字顏色。
- DTDefaultLinkColor:超連結文字的預設顏色。
- DTDefaultLinkDecoration:超連結的預設裝飾樣式。
- DTDefaultLinkHighlightColor:超連結被點亮時顯示的顏色。
- DTDefaultTextAlignment:段落的預設對齊方式。
- DTDefaultLineHeightMultiplier:行高的倍率。
- DTDefaultFirstLineHeadIndent:首行左邊界的預設縮排。
- DTDefaultHeadIndent:除首行外,其餘行的左邊界預設縮排。
- DTDefaultListIndent:清單項目的縮排量。
- DTDefaultStyleSheet:要使用的預設樣式表。
- DTUseiOS6Attributes:使用 iOS 6 的屬性來建構(相容 UITextView)。
- DTWillFlushBlockCallBack:每當內容被刷新到輸出字串時所執行的區塊。
參數說明
- data:用於建立 attributed string 的 HTML 格式資料。
- options:指定文件載入方式,數值說明參見 NSAttributedString(HTML)。
- docAttributes:目前尚未使用。
- returns:回傳一個已初始化的物件;若資料無法解碼則回傳 nil。
掌握這些參數,就能在把 HTML 渲染成富文本時,精細控制字型、顏色、行距與縮排等排版細節。