您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 富文本編輯器的實作方案詳解(WebView + HTML)

編輯:iOS 開發綜合

前言

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

最終效果

整體思路

用 WebView 載入一個本地 HTML 檔,在 HTML 內部寫好與 Objective-C 互相調用的 JS 方法,編輯完成後把富文本字串取出來提交給伺服器。

為什麼選這個路子

服務端要求的資料格式大致如下:

{
    @"Id": "新建模板時不傳,更新模板時必傳",
    @"title": "模板標題",
    @"text": "<p dir=\"ltr\">測試文字</p> ![](https://upload-images.jianshu.io/upload_images/1694866-a9a1da57455b2054.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)<p>![](https://pic.baikemy.net/apps/kanghubang/486/3486/1457968327238.amr@type=1@duration=1852)<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 橋接。若有任何疑問,歡迎留言交流。

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