聊天視窗、微博發布框這類介面,都有同一個共同需求:文字和圖片必須混在同一串內容裡一起顯示。表情與文字共存,就是最典型的圖文混排場景。本文用 Swift 3 實作一個仿微博發布頁的 UITextView,把表情插入、游標位置處理等細節走過一遍。
和 UILabel 的圖文混排一樣,UITextView 要達到這個效果,靠的是 NSAttributedString(富文本)。你可以把它想成「上過妝的文字」:不同字級、不同顏色、底線樣式,還能塞進圖片。相對地,text 屬性只吃純字串,就像素顏的樣子。
所以想讓文字有變化,就得改用 attributedText。
建立圖片附件(attachment)
建立富文本物件
設定圖片的 bounds
把圖片加入富文本
轉成可變富文本 NSMutableAttributedString
呼叫 addAttributes(_:range:) 調整樣式
建立 NSTextAttachment 物件,用來承載圖片。
把它的 image 設為要顯示的圖片。
設定 bounds,也就是圖片實際顯示的大小(預設會照原圖尺寸,通常太大)。
用 NSAttributedString(attachment:) 把附件轉成富文本。
以下是在發布框中插入表情的程式碼:
// 1. 建立圖片附件
let attachMent = NSTextAttachment()
// 2. 把圖片當成一個「字元」處理,轉成 NSAttributedString
attachMent.image = UIImage(named: emotion.fullPath!)
// 3. 圖片預設是原圖尺寸,必須設定 bounds 決定顯示大小
// y 為負值可讓表情稍微下沉,與文字基線對齊
attachMent.bounds = CGRect(x: 0, y: -4, width: font!.lineHeight, height: font!.lineHeight)
// 4. 把附件加入富文本
let attachString = NSAttributedString(attachment: attachMent)
// 5. 轉成可變富文本,後續才能修改
let mutiAttachString = NSMutableAttributedString(attributedString: attachString)
// 6. 用 addAttributes 調整指定範圍內的屬性
mutiAttachString.addAttributes([NSFontAttributeName: font!],
range: NSRange(location: 0, length: attachString.length))
建立好表情的富文本之後,直接指派給 textView.attributedText 就能顯示。
實務上更常遇到的是「在當前游標處插入表情」,或是「用表情替換已選取的文字」。這時要一併處理游標位置,否則插入後游標會跳回起點。
// selectedRange:textView 目前的選取範圍
var range = selectedRange
// 取出目前的富文本內容,轉成可變版本
let attriText = attributedText.copy()
let mutiAttriText = NSMutableAttributedString(attributedString: attriText as! NSAttributedString)
// 在游標位置插入(或替換掉選取範圍內的內容)
mutiAttriText.replaceCharacters(in: range, with: attachString)
// 統一字級,讓新插入的內容與原本的文字一致
mutiAttriText.addAttributes([NSFontAttributeName: font!],
range: NSRange(location: 0, length: mutiAttriText.length))
// 寫回 textView
attributedText = mutiAttriText
// 游標往後移一格,越過剛插入的圖片
range.location += 1
// 沒有選取任何內容
range.length = 0
// 更新游標位置
selectedRange = range
幾個實作上容易忽略的細節:
NSTextAttachment 在富文本裡算「一個字元」,因此游標位移是 +1,不是圖片寬度。
bounds 的 y 值決定表情與文字基線的相對位置,要對齊得靠實際微調。
字級屬性最好每次插入後統一重設一次,避免不同來源的字型混雜。
以上就是 UITextView 圖文混排的完整做法。順帶一提,這個 demo 是為了帶弟弟入門行動開發而寫的,他的課程偏 J2EE,但對行動端很有興趣,用 Swift 3 實作剛好也能順便熟悉語法。
完整的仿微博發布頁範例放在這裡,需要的可以直接下載參考:
https://github.com/VitasLiu/WeiBoComposeDemo.git