在 App 內嵌網頁時,常需要讓網頁反向呼叫原生的功能——例如點網頁上的按鈕去開相機、取定位。這篇示範以 UIWebView 的 delegate 攔截 URL 變化為基礎,實作 JS 呼叫 OC,並附上中文參數的編碼處理,避免出現亂碼。
核心機制是:網頁把「函式名稱 + 參數」組裝成一個自訂 scheme 的 URL 並導向它,例如 objc://getParam1:withParam2:/參數一:/參數二。UIWebView 在真正送出請求前會先詢問 delegate,我們在 shouldStartLoadWithRequest: 中攔下這個 URL、解析內容、呼叫對應的原生方法,最後回傳 NO 阻止它真的載入。
#import <UIKit/UIKit.h>
@interface ViewController : UIViewController <UIWebViewDelegate> {
}
@property (nonatomic, retain) IBOutlet UIWebView *webView;
// 接收網頁傳來兩個參數的方法
- (void)getParam1:(NSString *)str1 withParam2:(NSString *)str2;
@end
#import "ViewController.h"
@implementation ViewController
@synthesize webView;
- (void)didReceiveMemoryWarning {
[super didReceiveMemoryWarning];
}
- (void)getParam1:(NSString *)str1 withParam2:(NSString *)str2 {
NSLog(@"收到 html 傳過來的參數:str1=%@, str2=%@", str1, str2);
}
@end
關鍵在於中文不能直接放進 URL,必須先轉成 UTF-8 編碼。以下完整的 HTML 範例:
<meta http-equiv="content-type" charset="utf-8">
<title>JS 呼叫 OC 測試</title>
<script type="text/javascript">
function testClick(cmd) {
var str1 = document.getElementById('text1').value;
var str2 = document.getElementById('text2').value;
// 組出自訂 scheme 的 URL,參數先編碼
window.location.href = 'objc://' + cmd + ':/' + EncodeUtf8(str1) + ':/' + EncodeUtf8(str2);
}
// 把字串轉為 UTF-8 形式的 URL 編碼
function EncodeUtf8(s1) {
// escape 會把非英文字元編碼,例如 "Visit W3School!" → Visit%20W3School%21
var s = escape(s1);
var sa = s.split('%');
var retV = '';
if (sa[0] != '') {
retV = sa[0];
}
for (var i = 1; i < sa.length; i++) {
if (sa[i].substring(0, 1) == 'u') {
// 形如 u6211 的 Unicode 轉義,需轉成 UTF-8 位元組序列
retV += Hex2Utf8(Str2Hex(sa[i].substring(1, 5)));
if (sa[i].length >= 6) {
retV += sa[i].substring(5);
}
} else {
retV += '%' + sa[i];
}
}
return retV;
}
function Str2Hex(s) {
var c, n, digS = '';
var ss = '0123456789ABCDEF';
for (var i = 0; i < s.length; i++) {
c = s.charAt(i);
n = ss.indexOf(c);
digS += Dec2Dig(eval(n));
}
return digS;
}
function Dec2Dig(n1) {
var s = '', n2 = 0;
for (var i = 0; i < 4; i++) {
n2 = Math.pow(2, 3 - i);
if (n1 >= n2) { s += '1'; n1 = n1 - n2; }
else { s += '0'; }
}
return s;
}
function Dig2Dec(s) {
var retV = 0;
if (s.length == 4) {
for (var i = 0; i < 4; i++) {
retV += eval(s.charAt(i)) * Math.pow(2, 3 - i);
}
return retV;
}
return -1;
}
// 把 16 位元的二進位串組回 UTF-8 的 %XX%XX%XX 形式
function Hex2Utf8(s) {
var retS = '', tempS = '', ss = '';
if (s.length == 16) {
tempS = '1110' + s.substring(0, 4);
tempS += '10' + s.substring(4, 10);
tempS += '10' + s.substring(10, 16);
var sss = '0123456789ABCDEF';
for (var i = 0; i < 3; i++) {
retS += '%';
ss = tempS.substring(i * 8, (eval(i) + 1) * 8);
retS += sss.charAt(Dig2Dec(ss.substring(0, 4)));
retS += sss.charAt(Dig2Dec(ss.substring(4, 8)));
}
return retS;
}
return '';
}
</script>
<p><input id="text1" type="text" value="我來自ios蘋果" /></p>
<p><input id="text2" type="text" value="我來自earth地球" /></p>
<p><input id="enter" type="button" value="enter"
onclick="testClick('getParam1:withParam2:');" /></p>
- (void)viewDidLoad {
[super viewDidLoad];
webView.backgroundColor = [UIColor clearColor];
webView.delegate = self;
NSString *basePath = [[NSBundle mainBundle] bundlePath];
NSString *htmlPath = [basePath stringByAppendingPathComponent:@"jsIOS.html"];
NSURL *url = [NSURL fileURLWithPath:htmlPath];
NSURLRequest *request = [NSURLRequest requestWithURL:url];
[webView loadRequest:request];
}
- (BOOL)webView:(UIWebView *)webView
shouldStartLoadWithRequest:(NSURLRequest *)request
navigationType:(UIWebViewNavigationType)navigationType {
NSString *urlString = [[request URL] absoluteString];
// 還原被百分號編碼的中文
urlString = [urlString stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
NSLog(@"urlString=%@", urlString);
// 以 :// 切出 scheme 與其餘部分
NSArray *urlComps = [urlString componentsSeparatedByString:@"://"];
if ([urlComps count] && [[urlComps objectAtIndex:0] isEqualToString:@"objc"]) {
// 再以 :/ 切出函式名稱與各參數
NSArray *fnAndParams = [(NSString *)[urlComps objectAtIndex:1]
componentsSeparatedByString:@":/"];
NSString *funcStr = [fnAndParams objectAtIndex:0];
if (1 == [fnAndParams count]) {
// 沒有參數的情況
if ([funcStr isEqualToString:@"doFunc1"]) {
NSLog(@"doFunc1");
}
} else {
// 有參數的情況
if ([funcStr isEqualToString:@"getParam1:withParam2:"]) {
[self getParam1:[fnAndParams objectAtIndex:1]
withParam2:[fnAndParams objectAtIndex:2]];
}
}
return NO; // 攔下這個請求,不讓 WebView 真的去載入
}
return YES;
}
objc://... 而拋出錯誤,畫面上甚至会顯示載入失敗。stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding 還原編碼。注意這個方法在 iOS 9 之後已被標記為不建議使用,新專案請改用 stringByRemovingPercentEncoding。:/ 當分隔符,若參數值本身含有 :/ 就會被錯誤切開。更穩健的做法是把整個參數做成 JSON 字串再編碼一次,在原生端用 NSJSONSerialization 還原。WKUserContentController 的 addScriptMessageHandler:name:,API 乾淨得多,也不必自己手刻編碼邏輯。