前言
富文本編輯器和純文字編輯器不是一回事。以開源方案來說,國內用得比較多的是百度 UEditor 和 KindEditor,但兩者都有明顯短板:介面偏繁複、不夠簡潔、視覺設計也顯得陳舊,而且體積偏大、不夠輕量。本文要介紹的是如何在 iOS 中自行搭一個夠用的富文本編輯器。
最終效果

整體思路
用 WebView 載入一個本地 HTML 檔,在 HTML 內部寫好與 Objective-C 互相調用的 JS 方法,編輯完成後把富文本字串取出來提交給伺服器。
為什麼選這個路子
服務端要求的資料格式大致如下:
{
@"Id": "新建模板時不傳,更新模板時必傳",
@"title": "模板標題",
@"text": "<p dir=\"ltr\">測試文字</p> <p><p>",
@"sendstr": "22372447516929 若模板需同時發送給患者,此值必傳,多個患者 ID 以逗號分隔",
@"1457968280769.jpg": @"檔名:BASE64 資料,多張圖片或語音一起上傳"
}
其中 text 欄位就是富文本內容。由於還需要支援編輯既有內容,純原生實作會相當複雜,因此最終選擇用本地 HTML 來承接這部分。
實作步驟
先建立一個 richTextEditor.html 檔。
1. 頁面結構與樣式
<style>
img { display: block; width: 100%; margin-top: 10px; margin-bottom: 10px; }
[contenteditable=true]:empty:before {
content: attr(placeholder);
color: #a6a6a6;
}
#content {
padding: 10px 0;
font-family: Helvetica;
-webkit-tap-highlight-color: rgba(0,0,0,0);
min-height: 100px;
}
</style>
<div id="content" contenteditable="true"
onmouseup="saveSelection();"
onkeyup="saveSelection();"
onfocus="restoreSelection();"
placeholder="輕觸螢幕開始編輯正文"></div>
2. JS 方法設計
插入圖片:
function insertImage(imageName, imagePath) {
restoreSelection();
var imageElement = document.createElement('img');
var breakElement = document.createElement('div');
imageElement.setAttribute('src', imagePath);
imageElement.setAttribute('id', imageName);
breakElement.innerHTML = "<br>";
editableContent.appendChild(imageElement);
editableContent.appendChild(breakElement);
}
function updateImageURL(imageName, imageURL) {
var selectedElement = document.getElementById(imageName);
selectedElement.setAttribute('src', imageURL);
}
寫入既有 HTML 內容:
function placeHTMLToEditor(html) {
editableContent.innerHTML = html;
}
3. Objective-C 與 JS 的雙向呼叫
OC 側建立一個 WebView 載入該 HTML,再放一個按鈕負責選圖:
self.webView = [[UIWebView alloc] initWithFrame:CGRectMake(0, 64+50, [UIScreen mainScreen].bounds.size.width, self.view.frame.size.height - 50)]; self.webView.delegate = self; [self.view addSubview:self.webView]; NSBundle *bundle = [NSBundle mainBundle]; NSURL *indexFileURL = [bundle URLForResource:@"richTextEditor" withExtension:@"html"]; [self.webView setKeyboardDisplayRequiresUserAction:NO]; [self.webView loadRequest:[NSURLRequest requestWithURL:indexFileURL]]; UIButton *btn = [UIButton buttonWithType:UIButtonTypeCustom]; [btn addTarget:self action:@selector(addImage:) forControlEvents:UIControlEventTouchUpInside]; [self.view addSubview:btn];
選完圖片後與 HTML 對接:
// 以時間戳重新命名圖片
NSString *imageName = [NSString stringWithFormat:@"iOS%@.jpg", [self stringFromDate:[NSDate date]]];
NSString *imagePath = [documentsDirectory stringByAppendingPathComponent:imageName];
NSString *mediaType = [info objectForKey:UIImagePickerControllerMediaType];
UIImage *image = [info objectForKey:UIImagePickerControllerOriginalImage];
NSInteger userid = [[NSString stringWithFormat:@"%@", [[NSUserDefaults standardUserDefaults] objectForKey:@"userID"]] integerValue];
NSString *url = [NSString stringWithFormat:@"https://pic.baikemy.net/apps/kanghubang/%@/%@/%@",
[NSString stringWithFormat:@"%ld", userid % 1000],
[NSString stringWithFormat:@"%ld", (long)userid],
imageName];
NSString *script = [NSString stringWithFormat:@"window.insertImage('%@', '%@')", url, imagePath];
NSDictionary *dic = @{@"url":url, @"image":image, @"name":imageName};
[_imageArr addObject:dic]; // 全域陣列,用於保存已插入的圖片
[self.webView stringByEvaluatingJavaScriptFromString:script];
編輯結束後取出 HTML:
NSString *html = [self.webView stringByEvaluatingJavaScriptFromString:@"document.getElementById('content').innerHTML"];
把伺服器上的富文本載入編輯器:
NSString *place = [NSString stringWithFormat:@"window.placeHTMLToEditor('%@')", self.inHtmlString];
[webView stringByEvaluatingJavaScriptFromString:place];
4. 與服務端對接
此時取出的富文本大致長這樣:
企鵝的時候要[站外圖片上傳中……(4)]<div>阿空間裡發紅包啦?我</div>[站外圖片上傳中……(5)]<div><br></div>
其中 id 屬性部分是我額外處理過的內容,清理方式如下:
- (NSString *)changeString:(NSString *)str {
NSMutableArray *marr = [NSMutableArray arrayWithArray:[str componentsSeparatedByString:@"\""]];
for (int i = 0; i < marr.count; i++) {
NSString *subStr = marr[i];
if ([subStr hasPrefix:@"/var"] || [subStr hasPrefix:@" id="]) {
[marr removeObject:subStr];
i--;
}
}
NSString *newStr = [marr componentsJoinedByString:@"\""];
return newStr;
}
總結
到這一步,一個具備新增與編輯能力的富文本編輯器就成型了。相比純原生方案,用 WebView 承接編輯邏輯能省下大量排版與游標處理的工作,代價則是多一層 JS 橋接。若有任何疑問,歡迎留言交流。